A robust command-line interface for AI agents to programmatically send WhatsApp messages and sync extensive chat history.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install wacli-5qi
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-5qi 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 to bridge the gap between AI agents and the WhatsApp communication protocol. Within the ecosystem of Openclaw Skills, this tool provides a powerful interface for sending messages to third parties, managing group communications, and conducting deep searches through historical chat data. It is specifically built for scenarios where an agent needs to act as a communicator or researcher, rather than just a chatbot responder.
By utilizing the wacli skill, developers can empower their agents to handle administrative tasks such as syncing account history, backfilling old conversations for context, and distributing files like PDFs or images to specific contacts. It operates via a secure local store, ensuring that data retrieval is fast and reliable while maintaining the necessary technical parameters for professional messaging workflows.
wacli Use Cases
- Sending automated notifications or reminders to external WhatsApp contacts.
- Searching for specific keywords or financial documents across years of chat history.
- Managing outbound communication for group chats using unique group JIDs.
- Automating the distribution of reports or media files via terminal commands.
- Backfilling historical conversation data to provide AI agents with better long-term context.
How wacli Works
- The user authenticates the skill by running the auth command and scanning the generated QR code with their mobile device.
- The skill initializes a local database in the ~/.wacli directory to store synced chat metadata.
- The agent receives a command to message a contact or search history, which it translates into specific wacli CLI arguments.
- For messaging, the skill utilizes JID identifiers (e.g., number@s.whatsapp.net) to ensure the message reaches the correct recipient.
- The skill can optionally run a continuous sync to keep the local message repository updated with the latest activity from the WhatsApp account.
wacli Setup
System Requirements
This skill requires the OpenClawProvider to be active on your host system.
Installation
You can install the wacli binary using either Homebrew or the Go toolchain:
# Install via Homebrew
brew tap steipete/tap
brew install wacli
# Install via Go
go install github.com/steipete/wacli/cmd/wacli@latest
Configuration
Link your account and begin the initial synchronization process:
wacli auth
wacli sync --follow
Verify the installation using wacli doctor to ensure all dependencies are correctly configured for Openclaw Skills.
wacli Data Schema & Taxonomy
The skill manages data through a structured local directory and outputs results in developer-friendly formats. It is highly recommended to use the --json flag when the agent parses output for other Openclaw Skills.
| Component | Details |
|---|---|
| Default Store | ~/.wacli |
| Direct JID | [number]@s.whatsapp.net |
| Group JID | [id]@g.us |
| Output Format | Plain text or JSON |
| History Range | Filterable by --after and --before ISO dates |
wacli Advanced Features
- Real-time synchronization using the --follow flag for instant message availability.
- Granular history backfilling allowing for specific message counts and request limits per chat.
- Advanced search capabilities including date-range filtering and chat-specific queries.
- Support for multi-media messaging, including file attachments with custom captions.
- Machine-readable JSON output mode for seamless integration into automated DevOps and data pipelines.
SKILL.md
Loading
Related Openclaw Skills
wacli
A specialized command-line interface for WhatsApp that enables programmatic message sending, chat history synchronization, and advanced archive searching.
wacli
A command-line tool for sending WhatsApp messages, searching history, and syncing data without interrupting primary agent chats.
TronLink
A comprehensive toolkit for managing TRON blockchain assets, resource staking, and dApp interactions through the TronLink ecosystem.
Summarize
A lightning-fast CLI utility for summarizing web content, local documents, and multimedia using leading AI models.
wacli
A command-line interface for sending WhatsApp messages, searching chat history, and syncing data for automated agent workflows.
wacli
A powerful CLI tool that enables AI agents to programmatically send WhatsApp messages, search chat history, and sync data.
Featured*
