← Back to Skills Marketplace
WhatsApp Chats
by
Marcos Santos
· GitHub ↗
· v1.0.0
1371
Downloads
1
Stars
7
Active Installs
1
Versions
Install in OpenClaw
/install whatsapp-chats
Description
List, search, and analyze WhatsApp conversations
Usage Guidance
This skill will run a Node script that reads your local OpenClaw state directory (OPENCLAW_STATE_DIR or ~/.openclaw/credentials/whatsapp/default) and parses WhatsApp session filenames and contacts.json. That directory can contain sensitive session/identity information. Before installing or invoking: (1) confirm you trust the skill author (source is unknown), (2) be aware that SKILL.md requires the 'node' binary even though metadata doesn't list it, (3) inspect the script (already included) and ensure you are comfortable with it reading your credentials directory, (4) consider running it in a sandboxed environment or on a copy of your credentials directory, and (5) request the maintainer to explicitly declare required binaries and the config path in the skill metadata so the data access is transparent. If you do not want a skill to access your WhatsApp session files, do not install or run it.
Capability Analysis
Type: OpenClaw Skill
Name: whatsapp-chats
Version: 1.0.0
The skill 'whatsapp-chats' is designed to list, search, and analyze WhatsApp conversations from the local Baileys session cache. The `scripts/chats.js` file accesses files within the `OPENCLAW_STATE_DIR/credentials/whatsapp/default` directory, which is consistent with its stated purpose. It performs read-only operations on these files (session data, sender keys, contacts.json) and outputs structured JSON. There is no evidence of data exfiltration, unauthorized execution, persistence mechanisms, or prompt injection attempts in SKILL.md. Argument handling in the Node.js script is safe, preventing shell injection. The behavior is fully aligned with the skill's description.
Capability Assessment
Purpose & Capability
The name/description claim to read/search a local Baileys WhatsApp session cache; the script's behavior matches that: it enumerates files under a credentials path and reads contacts.json to build chat lists. That purpose is coherent with the code. However, the skill metadata does not declare required binaries (the SKILL.md calls node) nor the credentials/config path it reads, which is an omission.
Instruction Scope
SKILL.md instructs the agent to exec node scripts/chats.js which will read the local OpenClaw-state WhatsApp credentials directory (OPENCLAW_STATE_DIR or ~/.openclaw/credentials/whatsapp/default) and parse filenames and contacts.json. The instructions do not explicitly warn that local credential/session files will be read nor declare the config path. The agent will therefore access potentially sensitive local files without that being surfaced in the skill metadata or usage instructions.
Install Mechanism
There is no install spec (code is executed from the skill directory). This is lower installation risk; no external downloads or package installations are performed by the skill itself.
Credentials
The skill declares no required env vars or config paths, yet the code reads process.env.OPENCLAW_STATE_DIR (if set) and falls back to ~/.openclaw/credentials/whatsapp/default. It therefore accesses a local credentials directory (sensitive data) without declaring it. Also SKILL.md requires the 'node' binary but metadata lists none — a mismatch that affects runtime expectations.
Persistence & Privilege
The skill is not always-enabled and does not request system-wide persistence or modify other skills. It runs on-demand and does not attempt to write configuration or change other skills' settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install whatsapp-chats - After installation, invoke the skill by name or use
/whatsapp-chats - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release. Lists and searches WhatsApp conversations from Baileys session and sender-key files. Enriches chats with contact names, provides search functionality, and generates conversation statistics.
Metadata
Frequently Asked Questions
What is WhatsApp Chats?
List, search, and analyze WhatsApp conversations. It is an AI Agent Skill for Claude Code / OpenClaw, with 1371 downloads so far.
How do I install WhatsApp Chats?
Run "/install whatsapp-chats" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is WhatsApp Chats free?
Yes, WhatsApp Chats is completely free (open-source). You can download, install and use it at no cost.
Which platforms does WhatsApp Chats support?
WhatsApp Chats is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created WhatsApp Chats?
It is built and maintained by Marcos Santos (@marcosrippel); the current version is v1.0.0.
More Skills