A robust command-line interface for sending WhatsApp messages, searching chat 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 whatsapp
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 whatsapp 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?
The wacli skill provides a professional-grade interface for developers to interact with the WhatsApp platform directly from the terminal. Unlike standard agent chat functions, this skill is specifically designed for messaging third-party contacts, managing group alerts, and performing deep searches across historical message data. As part of the expanding library of Openclaw Skills, it bridges the gap between local automation scripts and global mobile communication.
By leveraging the wacli binary, users can programmatically handle file transfers, backfill chat histories for local archiving, and maintain a synchronized state of their WhatsApp communications. It is an essential tool for developers who need to integrate mobile messaging into their DevOps or productivity workflows without relying on a graphical user interface.
wacli Use Cases
- Sending automated notifications or documents to external clients and partners.
- Searching through years of message history for specific keywords, invoices, or dates.
- Synchronizing WhatsApp chat logs to a local directory for data analysis or backup.
- Managing group chat communications programmatically for team updates.
- Programmatic file sharing and agenda distribution via CLI.
How wacli Works
- The user authenticates their WhatsApp account by running the auth command and scanning the generated QR code.
- The system establishes a secure connection through the OpenClawDriver to bridge terminal commands with the WhatsApp protocol.
- The skill retrieves chat lists and identifiers (JIDs) to accurately target recipients for outbound messages.
- Real-time synchronization can be enabled to monitor and pull incoming data into the local store.
- Commands for sending text or files are executed via the CLI, with optional JSON output for machine-readable verification.
wacli Setup
First, ensure you have the OpenClawDriver installed on your system. Then, install the wacli binary 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
# Perform initial authentication
wacli auth
wacli Data Schema & Taxonomy
The wacli skill manages its environment through a local storage directory and specific metadata identifiers:
| Attribute | Description |
|---|---|
| Storage Directory | Defaults to ~/.wacli (configurable via --store) |
| Individual JID | Format: <number>@s.whatsapp.net |
| Group JID | Format: <id>@g.us |
| Output Modes | Supports standard text or --json for automation |
| Search Metadata | Filters by --after, --before, and --chat JIDs |
wacli Advanced Features
- Continuous background synchronization using the
--followflag for real-time data mirroring. - Deep history backfilling with configurable request counts and message limits for comprehensive archiving.
- Date-range filtered searching across the entire message database for rapid discovery.
- Full support for machine-readable JSON output, enabling complex piping between different Openclaw Skills.
- Built-in diagnostic tools via the doctor command to verify connection and authentication health.
SKILL.md
Loading
Related Openclaw Skills
Summarize URL & File CLI
A fast command-line utility for instantly summarizing web content, local documents, and YouTube videos using advanced LLMs.
Slack Actions Skill for Clawdbot
A comprehensive toolset for controlling Slack communications, reactions, and pinned content via AI agents.
Scalekit Auth
A secure, cloud-based OAuth token management system for AI agents that integrates seamlessly with Scalekit to eliminate local credential storage.
Polymarket + Hyperliquid Trading Agent
A high-performance trading agent that synchronizes Polymarket prediction bets with Hyperliquid perpetual futures for automated hedging and arbitrage.
x-trends
A powerful CLI-driven skill to search, filter, and analyze real-time trending topics and hashtags on X (Twitter) across global locations.
YouTube Watcher
An essential skill for fetching and reading YouTube video transcripts to enable AI-driven summarization and information retrieval.
Featured*
