wacli

What This Skill Does

The wacli skill provides an advanced command-line interface for interacting with WhatsApp outside of standard conversational channels. It is designed to act as an automation bridge, allowing users to send automated messages, query message history, and perform deep-sync operations directly from the OpenClaw environment. By leveraging a local storage directory (~/.wacli), it manages authentication state and message databases, enabling programmatic access to chats and groups that are otherwise unreachable via standard UI flows.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/rafay0313/tt Ensure that you have sufficient permissions to write to the local file system, as the skill initializes a local store to track authentication tokens and synced message history.

Use Cases

This skill is ideal for power users and developers who need to integrate WhatsApp into their automated workflows. Common scenarios include:

• Automated Notifications: Sending meeting agendas or status updates to colleagues or clients directly from CLI-based scripts.
• Historical Data Retrieval: Searching through years of chat history for specific keywords (e.g., "invoices", "project specs") with time-based filtering (--after/--before).
• History Backfilling: Ensuring that local archives are up-to-date by triggering targeted backfills for specific group or direct chats.
• Bulk Communication: Managing group messages for teams that utilize WhatsApp for project coordination.

Example Prompts

1. "Find all messages mentioning 'invoice' sent to the 'Contractors' group between January 1st and February 15th, 2025."
2. "Send a WhatsApp message to +14155551212 saying 'The quarterly report has been uploaded to the shared folder.'"
3. "List my last 10 chats to find the JID for the 'Engineering Team' group and then backfill the last 50 messages from that conversation."

Tips & Limitations

• Safety First: Always use the --json flag when parsing results to ensure data integrity. The skill requires an explicit recipient and message body; use the CLI to verify identities before dispatching sensitive information.
• Privacy: wacli is for third-party messaging only. Routine conversations with the AI agent itself do not require this tool and are handled natively by Clawdbot.
• Online Requirement: Backfill operations are best-effort and require the linked phone to be active and connected to the internet.
• JIDs: Always look up the correct JID format (<number>@s.whatsapp.net for individuals or <id>@g.us for groups) via wacli chats list before initiating automated sequences.