wacli

What This Skill Does

The wacli skill for OpenClaw provides a command-line interface to interact with the WhatsApp ecosystem, specifically designed for automation tasks and history management. It enables users to programmatically send messages to third-party recipients, search through chat histories, and manage local data synchronization. Unlike routine chatting, this skill acts as a bridge for operational tasks like syncing project updates, retrieving past invoice details, or automating communications to external contacts not involved in the current session. It ensures that your WhatsApp metadata and message contents can be indexed and queried through OpenClaw directly.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/openclaw/skills/wacli Ensure you have the necessary dependencies installed for the local store at ~/.wacli. Upon installation, initialize the service by running wacli auth to initiate the QR code login process, which establishes the secure link between your device and the CLI tool.

Use Cases

This skill is ideal for power users and developers who need to bridge their communication workflow with their automation tasks. You can use it to perform deep searches through thousands of messages to find specific business documents, invoices, or meeting notes from previous months. Furthermore, it is perfectly suited for sending automated notifications, such as status updates or document sharing, to specific groups or individual contacts without needing to manually open the WhatsApp mobile application. It is not intended for back-and-forth conversational use with the AI, but rather for administrative and operational WhatsApp tasks.

Example Prompts

1. "Search my WhatsApp history for any messages from John Doe containing the word 'invoice' sent after January 1st, 2025."
2. "Send a WhatsApp message to +14155551212 saying, 'The project files have been uploaded to the shared drive.'"
3. "List my last 10 WhatsApp chats and sync the history for the 'Project Alpha' group so I can search it later."

Tips & Limitations

• Safety First: The skill requires explicit recipient verification. Always review the target and message content before the AI sends them.
• JID Awareness: Always use wacli chats list to verify the correct JID for groups or contacts before executing commands.
• Online Status: Backfill and sync operations are best-effort; ensure your mobile device has a stable internet connection for the initial sync.
• Non-Chat Usage: Remember that OpenClaw handles your direct conversation with it automatically. Do not use this tool to talk to the AI; use it strictly for third-party messaging and archival management.