← Back to Skills Marketplace
WhatsApp Groups
by
Marcos Santos
· GitHub ↗
· v1.0.0
610
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install whatsapp-groups
Description
Discover, list, and search WhatsApp groups from Baileys session data
Usage Guidance
This skill appears to do what it says: it reads your local Baileys session files (by default in ~/.openclaw/credentials/whatsapp/default) to find group IDs/names and can add them to openclaw.json. Before installing: (1) review the included scripts/groups.js yourself (it is small and readable); (2) be aware these session directories can contain sensitive keys — the skill reads them but does not perform network calls or exfiltration; (3) back up openclaw.json before running sync (sync will modify that file); (4) run the script in a controlled environment or sandbox if you do not fully trust the skill owner.
Capability Analysis
Type: OpenClaw Skill
Name: whatsapp-groups
Version: 1.0.0
The skill is classified as suspicious due to its ability to read and write to the agent's primary configuration file, `openclaw.json`, located at `~/.openclaw/openclaw.json`. While the `syncGroups` function in `scripts/groups.js` uses this capability for a stated purpose (adding newly discovered WhatsApp groups with `enabled: false`), modifying the agent's core configuration is a high-risk operation. This capability, even if currently used benignly, represents a broad permission that could be abused if the skill were compromised or altered.
Capability Assessment
Purpose & Capability
Name/description claim to discover WhatsApp groups from Baileys session data and the script explicitly reads a Baileys credentials directory (OPENCLAW_STATE_DIR or ~/.openclaw/credentials/whatsapp/default), store.json, and contacts.json to find group IDs and names. All requested file access is coherent with that purpose.
Instruction Scope
SKILL.md directs the agent to run the included Node script (node scripts/groups.js) with specific commands (list, search, get-id, sync). The instructions do not ask the agent to read other unrelated files, call external endpoints, or collect extra system context beyond the expected state/config files.
Install Mechanism
No install spec; the skill is instruction + a single local script. Nothing is downloaded or extracted during install, so there is low install-time risk.
Credentials
The script reads the Baileys credentials directory which can contain sensitive session artifacts (sender-key files, possibly session/auth data). This is proportional to discovering groups, but it does mean the skill will read files that are sensitive. The skill does not request external API keys or unrelated credentials and respects OPENCLAW_STATE_DIR if set.
Persistence & Privilege
The 'sync' command modifies the agent's openclaw.json (STATE_DIR/openclaw.json) to add discovered groups. Writing this config is coherent with the claimed feature, but it does change agent configuration and could add many entries if run — users should be aware it will persist changes to openclaw.json.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install whatsapp-groups - After installation, invoke the skill by name or use
/whatsapp-groups - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release. Discovers and lists WhatsApp groups from Baileys sender-key files. Enriches group data with names from store and contacts files. Supports listing, searching, and syncing with openclaw.json configuration.
Metadata
Frequently Asked Questions
What is WhatsApp Groups?
Discover, list, and search WhatsApp groups from Baileys session data. It is an AI Agent Skill for Claude Code / OpenClaw, with 610 downloads so far.
How do I install WhatsApp Groups?
Run "/install whatsapp-groups" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is WhatsApp Groups free?
Yes, WhatsApp Groups is completely free (open-source). You can download, install and use it at no cost.
Which platforms does WhatsApp Groups support?
WhatsApp Groups is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created WhatsApp Groups?
It is built and maintained by Marcos Santos (@marcosrippel); the current version is v1.0.0.
More Skills