A robust command-line interface for managing WhatsApp messages, syncing history, and automating third-party communications.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install test-wa
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 test-wa 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 empower developers and AI agents with programmatic access to WhatsApp. By utilizing this tool within the Openclaw Skills framework, agents can send text messages and files to third parties, search through existing message history, and perform deep history backfills. It is specifically built for automation and data retrieval tasks rather than standard user-to-agent chatting, making it an essential bridge for workflow automation.
This skill allows agents to operate outside the standard chat window, enabling them to reach out to specific phone numbers or group JIDs with high precision. Whether you are building an automated notification system or a research tool to analyze past conversations, wacli provides the necessary CLI infrastructure to interact with the WhatsApp protocol safely and efficiently.
wacli Use Cases
- Sending automated alerts or reports to specific WhatsApp contacts or groups.
- Searching through archived messages to retrieve past invoices, dates, or technical details.
- Synchronizing chat history for offline data processing and sentiment analysis.
- Backfilling historical conversation data to provide context for AI-driven research.
- Programmatic file sharing, such as sending generated PDF reports directly to stakeholders.
How wacli Works
- Authentication is handled via a QR code login to securely link the CLI to a WhatsApp account.
- The agent identifies targets using the chat list command to find specific JIDs (Journal IDs) for individuals or groups.
- Search and filter commands are used to query the local or remote message history based on keywords or timestamps.
- Message sending is executed through dedicated text or file commands, requiring explicit confirmation to ensure safety.
- Real-time synchronization can be maintained to keep the local storage updated with the latest incoming communications.
wacli Setup
Install wacli using Homebrew or Go to start using these Openclaw Skills:
# Install via Homebrew
brew tap steipete/tap
brew install wacli
# Or install via Go
go install github.com/steipete/wacli/cmd/wacli@latest
# Authenticate your account
wacli auth
# Verify your setup
wacli doctor
wacli Data Schema & Taxonomy
The tool manages data locally and identifies recipients through specific identifiers. Below is the organizational structure:
| Component | Detail |
|---|---|
| Storage Directory | Default data is stored in ~/.wacli (configurable via --store). |
| Individual JID | Formatted as <number>@s.whatsapp.net. |
| Group JID | Formatted as <id>@g.us. |
| Data Output | Supports --json flag for machine-readable parsing by agents. |
| Query Filters | Supports --limit, --after, and --before for precise history extraction. |
wacli Advanced Features
- Continuous synchronization using the
--followflag for real-time data ingestion. - Granular history backfilling with configurable request counts to manage bandwidth and rate limits.
- Multi-format messaging support including plain text and file attachments with custom captions.
- Comprehensive search capabilities across all chats or targeted specific threads.
- Integration-ready JSON output to pipe WhatsApp data into other Openclaw Skills for complex automation.
SKILL.md
Loading
Related Openclaw Skills
Qlik Cloud Integration
A comprehensive suite of 37 tools for managing Qlik Cloud analytics, data reloads, and AI-driven business insights through an agentic interface.
Weather Arbitrage Assistant v3.0
A high-precision trading assistant that identifies profitable discrepancies between NOAA scientific models and retail weather prediction markets.
Paid Content Generator
A pay-per-use AI content engine for generating professional social media copy and video scripts using the SkillPay protocol.
BTC Short-term Predictor
A high-frequency Bitcoin price prediction engine using advanced technical indicators for 15-minute interval forecasting.
Telegram Voice-to-Voice (macOS)
A macOS-exclusive skill for transcribing Telegram voice notes and replying with AI-generated audio responses.
Whisper
An end-to-end encrypted messaging protocol for AI agents to communicate privately using Moltbook dead drops.
Featured*
