wacli
Send WhatsApp messages to other people or search/sync WhatsApp history via the wacli CLI (not for normal user chats).
Why use this skill?
Use wacli to automate WhatsApp messaging, sync chat history, and search archives from your OpenClaw agent. Streamline external communication securely.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/steipete/wacliWhat This Skill Does
The wacli skill for OpenClaw provides a command-line interface to interact with WhatsApp for purposes beyond routine conversational chatting. It is designed for programmatic message delivery, deep history searching, and synchronization of chat data. Unlike standard chat interfaces, wacli allows the AI agent to manage third-party communications, automate notifications, and perform forensic-style searches across historical messages using specific timeframes or keywords. It acts as an bridge between your agent and the WhatsApp ecosystem, enabling you to treat your WhatsApp contacts as an addressable database.
Installation
To integrate wacli into your OpenClaw environment, execute the following command in your terminal:
clawhub install openclaw/skills/skills/steipete/wacli
Ensure that you have your phone nearby to perform the initial QR login and synchronization process. Once installed, you can verify your configuration and health by running wacli doctor.
Use Cases
- Automated Messaging: Send reminders, meeting agendas, or project updates to clients or team members directly via WhatsApp.
- Data Retrieval: Quickly search through years of archived messages for specific invoices, contact information, or historical decisions.
- System Monitoring: Connect your server-side scripts or system alerts to send notifications directly to a dedicated WhatsApp group.
- Backup and Sync: Maintain a local, searchable copy of your WhatsApp history outside of the mobile app ecosystem.
Example Prompts
- "Search my WhatsApp history for any messages containing the word 'invoice' that were sent between January 1st and February 15th, 2025."
- "Send a message to Sarah Miller saying 'The project files are ready for your review' and attach the PDF located at /docs/project_final.pdf."
- "List my last 10 WhatsApp chats and sync the messages for the 'Engineering Team' group."
Tips & Limitations
- Respect Boundaries: This tool is not intended for standard daily conversations with the AI. Use it only for external tasks.
- JIDs are Key: When dealing with groups or specific individuals, always rely on
wacli chats listto identify the correct JID before attempting to send files or large batches of messages. - Phone Connectivity: Since
waclileverages the WhatsApp protocol, ensure your linked mobile device maintains an active internet connection. Backfill and sync operations are best-effort and depend on network stability. - Machine-Readable Data: When building complex workflows, always use the
--jsonflag to ensure the output is parseable by your agent scripts.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-steipete-wacli": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-write, file-read, external-api
Related Skills
swiftui-liquid-glass
Implement, review, or improve SwiftUI features using the iOS 26+ Liquid Glass API. Use when asked to adopt Liquid Glass in new SwiftUI UI, refactor an existing feature to Liquid Glass, or review Liquid Glass usage for correctness, performance, and design alignment.
qmd
Local search/indexing CLI (BM25 + vectors + rerank) with MCP mode.
songsee
Generate spectrograms and feature-panel visualizations from audio with the songsee CLI.
summarize
Summarize URLs or files with the summarize CLI (web, PDFs, images, audio, YouTube).
bird
X/Twitter CLI for reading, searching, and posting via cookies or Sweetistics.