wacli

Send WhatsApp messages to third parties and sync or search WhatsApp history via the wacli CLI.

1|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill wacli-jerome-prakash-l
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wacli
Source: https://github.com/JEROME-PRAKASH-L/openclaw/tree/main/skills/wacli
Command: npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill wacli-jerome-prakash-l

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets you message other people or groups on WhatsApp and search your WhatsApp history from the command line, without interfering with your normal active chats handled by OpenClaw. ## Core Features & Use Cases - Third-Party Messaging: Send text messages or files to individual contacts or groups on WhatsApp with explicit recipient confirmation. - History Sync & Search: Authenticate via QR login, continuously sync chats, and search messages by keyword, chat, or date range. - History Backfill: Request older message history for a specific chat when your phone is online. - Use Case: You need to send a PDF agenda to a colleague on WhatsApp and later find an invoice message from last month; this Skill handles both through wacli commands. ## Quick Start Ask the assistant to send a WhatsApp message to a specific phone number with your exact message text using wacli.

Frequently Asked Questions about wacli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send a WhatsApp message from the command line?

Use wacli send text with the --to flag for the recipient number and --message for the text, for example wacli send text --to "+14155551212" --message "Hello". Always confirm the recipient and message before sending.

How do I search my WhatsApp message history?

Run wacli messages search with your query, optionally filtering by chat JID with --chat or by date range using --after and --before. Add --json for machine-readable output when parsing results.

When should I use wacli instead of normal WhatsApp chats?

Use wacli only when explicitly messaging a third party or syncing and searching history. OpenClaw routes normal WhatsApp conversations automatically, so wacli is not needed for routine chats with the assistant.

How do I authenticate wacli with my WhatsApp account?

Run wacli auth to log in via QR code and perform the initial sync. Use wacli sync --follow for continuous syncing and wacli doctor to diagnose setup issues.

Why does WhatsApp history backfill not return all messages?

Backfill requires your phone to be online and results are best-effort, so some older messages may be unavailable. Use wacli history backfill with --chat, --requests, and --count to control the retrieval scope.