A command-line tool for sending WhatsApp messages, syncing history, and searching conversations within an AI agent workflow.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install 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 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 provides a specialized interface for interacting with WhatsApp through the command line, specifically designed to empower Openclaw Skills with external messaging capabilities. It bypasses standard chat interfaces to allow for programmatic contact with third parties, automated file transfers, and deep data extraction from existing message logs.
By providing a bridge between the CLI and the WhatsApp protocol, it enables developers to build more communicative and data-aware agentic workflows. Whether you are managing group notifications or retrieving historical chat context, this tool ensures your agent has the reach it needs within the WhatsApp ecosystem.
wacli Use Cases
- Sending automated notifications or reports to external WhatsApp contacts.
- Searching for specific information like invoices or dates within past conversations.
- Backfilling history for data analysis or context retrieval in AI tasks.
- Programmatically sending files and documents to group chats or individuals.
- Syncing WhatsApp data to a local environment for long-term storage.
How wacli Works
- Securely authenticate by scanning a QR code using the auth command to link your account.
- Perform an initial sync or run a continuous background sync to keep local chat data up to date.
- Locate specific recipients or groups by querying the chat list to obtain their JID.
- Trigger messaging actions like sending text or files through standardized CLI flags.
- Utilize JSON output to pipe data into other parts of your Openclaw Skills setup for further processing.
wacli Setup
Install wacli on your system to begin using it with Openclaw Skills. You can use Homebrew on macOS or Go on any platform:
# Install via Homebrew
brew tap steipete/tap
brew install wacli
# Install via Go
go install github.com/steipete/wacli/cmd/wacli@latest
Once installed, authenticate your session to enable full functionality:
wacli auth
wacli Data Schema & Taxonomy
The wacli integration for Openclaw Skills uses a structured local storage system located at ~/.wacli by default. Data is organized as follows:
| Component | Identification | Note |
|---|---|---|
| Individual JID | number@s.whatsapp.net | Standard format for direct messages. |
| Group JID | id@g.us | Unique identifier for WhatsApp groups. |
| JSON Output | --json flag | Ensures data is parseable by agents and scripts. |
| History Store | Local directory | Contains synced message data and media metadata. |
wacli Advanced Features
- Real-time synchronization with the --follow flag for live message monitoring.
- Advanced search filters allowing users to query by specific date ranges and keywords.
- Detailed diagnostic reporting via the doctor command to troubleshoot connectivity.
- Custom store directory overrides for managing multiple accounts or environments.
- Configurable history backfilling to balance performance and data depth.
SKILL.md
Loading
Related Openclaw Skills
Video Transcript Downloader
A versatile tool for downloading media and generating clean, paragraph-style transcripts from YouTube and other video platforms.
Video Frames (ffmpeg)
Extract high-quality frames or thumbnails from video files using the power of ffmpeg.
Trello
A powerful integration enabling AI agents to programmatically manage Trello boards, lists, and cards via the Trello REST API.
tmux
A powerful skill for remote-controlling tmux sessions to manage interactive CLIs and orchestrate parallel AI coding agents.
Weather
A lightweight, API-key-free weather skill for retrieving real-time atmospheric data and forecasts via CLI.
Health Tracker
A lightweight health monitoring tool for tracking daily hydration and sleep patterns directly via your AI agent.
Featured*
