wacli

Send WhatsApp messages and search chat history via the wacli CLI.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/srgaba/open-claw --skill wacli-srgaba
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wacli
Source: https://github.com/srgaba/open-claw/tree/main/project/skills/wacli
Command: npx skills add https://github.com/srgaba/open-claw --skill wacli-srgaba

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets you message third parties on WhatsApp and search or backfill your WhatsApp history from the command line, without touching the WhatsApp app manually. ## Core Features & Use Cases - Send Messages: Deliver text or file messages to individual contacts or groups using phone numbers or JIDs. - History Search & Sync: Authenticate via QR login, continuously sync chats, and search messages by keyword, chat, or date range. - History Backfill: Request older messages for a specific chat when recent sync data is insufficient. - Use Case: A user asks the assistant to send "Running 5 min late" to a specific WhatsApp group, then later searches synced history for all messages mentioning "invoice" from the past year. ## 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 phone number or JID and --message for the text. For files, use wacli send file with --file and an optional --caption.

How do I search WhatsApp chat history with wacli?

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

How do I authenticate wacli with my WhatsApp account?

Run wacli auth to log in via QR code and perform an initial sync. Then use wacli sync --follow for continuous syncing and wacli doctor to check health.

When should I not use wacli for WhatsApp?

Do not use wacli for normal user chats, since OpenClaw routes WhatsApp conversations automatically. It is only for explicitly messaging third parties or searching and syncing history.

Why is WhatsApp history backfill incomplete with wacli?

Backfill requires your phone to be online and results are best-effort, so some older messages may not be retrieved. Use wacli history backfill with --requests and --count to tune the attempt.