A robust command-line interface for sending WhatsApp messages, managing files, and searching chat history via AI agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install mh-wacli
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 mh-wacli 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 technical utility that enables AI agents to interact with the WhatsApp platform directly through a command-line interface. While Openclaw Skills typically handle routine user-to-agent chats automatically, wacli is specifically designed for outbound communication to third parties and deep historical data retrieval. It allows agents to act as a bridge between your terminal workflows and your mobile messaging network.
This tool is ideal for developers who need to automate notifications, search through years of message history for specific keywords, or backfill chat logs for data analysis. By providing a structured way to interact with WhatsApp JIDs (Jabber IDs) for both individuals and groups, it transforms a closed mobile app into a programmable interface for automation.
wacli Use Cases
- Sending automated notifications, invoices, or project updates to clients or external stakeholders.
- Searching for specific information buried in chat history, such as old receipts, dates, or technical snippets.
- Synchronizing and backfilling historical messages to a local machine for archival or auditing.
- Programmatically distributing files and documents to WhatsApp groups or individual contacts.
How wacli Works
- The AI agent detects a specific user intent to contact a third party or query historical data.
- The skill invokes the wacli binary to perform an initial authentication via QR code if not already logged in.
- For search requests, the tool queries the local store or performs a best-effort backfill to retrieve relevant message data.
- For outbound messages, the agent formats the target JID (e.g., number@s.whatsapp.net) and prepares the payload.
- The command is executed via the CLI, and the skill captures the JSON-formatted response to confirm delivery or handle errors.
wacli Setup
To integrate this capability into your Openclaw Skills environment, you must have the wacli binary installed. You can install it using one of the following methods:
# Install via Homebrew
brew tap steipete/tap
brew install wacli
# Install via Go
go install github.com/steipete/wacli/cmd/wacli@latest
Once installed, initialize the connection by running:
wacli auth
wacli Data Schema & Taxonomy
The skill organizes its data and configuration locally to ensure fast access and privacy. Below is the organizational structure used by the tool:
| Component | Detail |
|---|---|
| Storage Path | Default directory is ~/.wacli (configurable via --store) |
| Output Format | Machine-readable JSON for integration with other scripts |
| Contact Identifiers | Individual chats use [email protected]; Groups use [email protected] |
| History Management | Supports incremental backfilling with configurable request limits |
wacli Advanced Features
- Real-time synchronization using the
--followflag to keep local history updated. - Support for group messaging and file attachments with custom captions.
- Detailed diagnostic reporting via the
wacli doctorcommand to verify connectivity. - Advanced search filters including date ranges (
--after,--before) and specific chat targeting.
SKILL.md
Loading
Related Openclaw Skills
Things 3 CLI for macOS
A powerful macOS integration that enables AI agents to read from and write to the Things 3 task manager database and URL scheme.
Summarize
A high-performance CLI tool for extracting text and generating concise summaries from web links, videos, and local documents.
session-logs
Empower your AI agent to search, filter, and analyze its own historical conversation logs and usage metrics.
OpenAI Whisper (CLI)
A high-performance local speech-to-text engine that transcribes audio files without requiring an internet connection or API keys.
Weather Skill
A zero-config skill for retrieving real-time weather conditions and multi-day forecasts for any global location directly through the terminal.
Skill Scout
Skill Scout is the official discovery and management engine for finding, evaluating, and installing Openclaw Skills from the community registry.
Featured*
