← Back to Skills Marketplace
WhatsApp Labels
by
Marcos Santos
· GitHub ↗
· v1.0.0
510
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install whatsapp-labels
Description
List and search WhatsApp Business labels/tags
Usage Guidance
This skill is coherent with its purpose: it runs a bundled Node script that reads WhatsApp cache files from OPENCLAW_STATE_DIR or ~/.openclaw/credentials/whatsapp/default and outputs labels or chats matching a label. Before installing, verify you are comfortable allowing the agent to read those local files (they may include contact names and labels). Note the script is read-only — it does not modify WhatsApp data or call external services — and it does not request any additional credentials. If you do not want the agent to access your WhatsApp cache, do not install or run this skill. If you need write/manage capabilities, this skill does not provide them; inspect or test the script locally to confirm behavior.
Capability Analysis
Type: OpenClaw Skill
Name: whatsapp-labels
Version: 1.0.0
The skill is designed to list and search WhatsApp Business labels and contacts from the local OpenClaw session cache. It reads JSON files from the expected `OPENCLAW_STATE_DIR/credentials/whatsapp/default` path and outputs the results to stdout. There is no evidence of data exfiltration to external endpoints, malicious execution, persistence mechanisms, or prompt injection attempts against the agent in `SKILL.md`. The `labels.js` script handles arguments as plain strings for internal logic, not for shell execution, making it robust against command injection within its own code.
Capability Assessment
Purpose & Capability
The name/description (list and search WhatsApp Business labels) matches the included code which reads label and contact cache files. Minor wording mismatch: SKILL.md says 'Manage' but the script is read-only (list/search) and does not modify labels.
Instruction Scope
SKILL.md directs the agent to run the included Node script; the script only reads local files (store.json, labels.json, contacts.json) under a specific OpenClaw state path and prints JSON results. It does not run network requests or access other system paths.
Install Mechanism
No install spec is provided (instruction-only with a bundled script). Nothing is downloaded or written by an installer; risk from install mechanism is minimal.
Credentials
The skill does not require declared env vars, but the script will honor OPENCLAW_STATE_DIR if present and otherwise reads ~/.openclaw/credentials/whatsapp/default. Reading those files is proportionate to listing/searching labels, but those files can contain PII or session data — users should be aware the agent will access local WhatsApp cache/contact data.
Persistence & Privilege
The skill is not always-enabled and uses default autonomous invocation settings. It does not modify other skills, install services, or persist changes; requested privileges are minimal.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install whatsapp-labels - After installation, invoke the skill by name or use
/whatsapp-labels - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release. Manages WhatsApp Business labels/tags from Baileys session cache. List all available labels with their colors and IDs, and find which chats are associated with a specific label.
Metadata
Frequently Asked Questions
What is WhatsApp Labels?
List and search WhatsApp Business labels/tags. It is an AI Agent Skill for Claude Code / OpenClaw, with 510 downloads so far.
How do I install WhatsApp Labels?
Run "/install whatsapp-labels" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is WhatsApp Labels free?
Yes, WhatsApp Labels is completely free (open-source). You can download, install and use it at no cost.
Which platforms does WhatsApp Labels support?
WhatsApp Labels is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created WhatsApp Labels?
It is built and maintained by Marcos Santos (@marcosrippel); the current version is v1.0.0.
More Skills