wacli

wacli is a specialized WhatsApp interface for OpenClaw users who need to interact with contacts outside of standard conversational threads. It is designed for operational tasks such as bulk messaging, record synchronization, and searching through historical archives rather than day-to-day chatting. Because OpenClaw handles primary WhatsApp conversations natively, wacli serves as an auxiliary tool specifically for third-party outreach, data retrieval, and automated workflows.

• Precise third-party messaging: Send text, files, or media to specific contacts and groups using their JID or phone number.

• Robust history synchronization: Maintain a local repository of your WhatsApp history with commands for continuous sync and backfilling of older messages.

• Advanced search capabilities: Query your archived or existing chat history by keywords, specific time ranges, or chat identifiers to quickly locate information like invoices or specific conversations.

• Operational diagnostics: Built-in health checks and account status tools (doctor, auth) ensure your connection remains stable for reliable communication.

• Flexible data handling: Output results in JSON format to support integration into larger automated scripts or data processing pipelines.

• Best for: Users who need to automate WhatsApp interactions, archive chat data, or manage communications with individuals outside their primary AI-assisted conversation space.

• Constraints: The tool requires that your phone stays online for history backfills and certain synchronization tasks; results are provided on a best-effort basis.

• Safety first: Always confirm the recipient and message content before execution; be aware that this tool is not intended for routine conversational chat.

• Input requirements: Supports E.164 phone numbers for direct messages and specific JID formats (e.g., @s.whatsapp.net for direct, @g.us for groups) for target identification.