A professional command-line interface for WhatsApp that allows AI agents to send messages, search history, and sync chat data.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install wacli-hdg
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install wacli-hdg using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is wacli?
wacli is a specialized utility designed for Openclaw Skills that enables programmatic interaction with WhatsApp. Unlike standard chat interfaces, wacli is built for automation, allowing developers to integrate WhatsApp messaging and history retrieval directly into their AI workflows. It excels at managing third-party communications and performing deep searches across message archives.
By leveraging this tool, agents can move beyond simple chat interactions to perform complex tasks like document distribution, invoice searching, and multi-group notifications. It provides a structured, developer-friendly way to handle WhatsApp data while maintaining strict safety protocols and explicit user confirmation steps.
wacli Use Cases
- Sending automated notifications or files to specific WhatsApp contacts.
- Performing historical searches across WhatsApp messages to find specific data points like invoices or dates.
- Synchronizing group chat history for analysis or reporting purposes.
- Backfilling message history to provide context for AI-driven research tasks.
How wacli Works
- The skill requires the OpenClawProvider to be running as a background service to facilitate the connection.
- The user authenticates their WhatsApp account via the wacli auth command, which generates a QR code for linking.
- Once linked, the tool can perform a full sync or follow real-time updates to maintain a local record of chats.
- When a request is made, the agent constructs a wacli command (e.g., send text or search messages) and executes it through the CLI.
- The tool returns JSON-formatted output which the agent parses to confirm success or provide data back to the user.
wacli Setup
First, ensure OpenClawProvider is installed and running on your system.
For MacOS, use the following to install wacli:
brew install steipete/tap/wacli
Alternatively, install via Go:
go install github.com/steipete/wacli/cmd/wacli@latest
After installation, initialize the service:
wacli auth
wacli Data Schema & Taxonomy
The wacli skill manages data within a local store directory, typically located at ~/.wacli. It organizes information using the following structure:
| Entity | Format | Description |
|---|---|---|
| JIDs | <id>@s.whatsapp.net |
Unique identifiers for individual contacts. |
| Group JIDs | <id>@g.us |
Unique identifiers for WhatsApp groups. |
| Messages | JSON | Structured message data including timestamps, senders, and content. |
| Sync State | Metadata | Tracking for history backfill and continuous sync progress. |
wacli Advanced Features
- Continuous synchronization using the --follow flag for real-time data updates.
- Detailed history backfilling with configurable request counts and message limits for deep archival access.
- Native JSON output support for all commands to ensure seamless integration with Openclaw Skills pipelines.
- Advanced file handling capabilities allowing for automated document sharing with custom captions.
SKILL.md
Loading
Related Openclaw Skills
wacli
A specialized CLI tool designed for sending WhatsApp messages to external contacts and performing advanced history searches and data synchronization.
wacli
A specialized command-line interface for sending WhatsApp messages, searching history, and syncing chat data for AI agents.
wacli
A command-line interface for WhatsApp that empowers AI agents to manage outbound messaging and synchronize chat history for third-party communications.
wacli
A powerful CLI tool that enables AI agents to programmatically send WhatsApp messages, search chat history, and sync data.
wacli
A command-line interface for WhatsApp that enables AI agents to send messages, search archives, and sync chat history.
wacli
A robust command-line interface for sending WhatsApp messages, searching conversation history, and synchronizing data for AI-driven workflows.
Featured*
