wacli

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

Updated Jun 19, 2026
One-click install
npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill wacli-amirulandalib
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wacli
Source: https://github.com/AmirulAndalib/Vilvona-AI/tree/main/skills/wacli
Command: npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill wacli-amirulandalib

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When you need to message someone else on WhatsApp or search your own WhatsApp history from an AI assistant, there is no built-in channel for it. This Skill wraps the wacli command-line tool so the assistant can send texts and files to third-party contacts or groups, and sync, search, and backfill WhatsApp chat history on demand. ## Core Features & Use Cases - Third-party messaging: Send text messages or files with captions to individual phone numbers or group JIDs after explicit confirmation of recipient and content. - History sync and search: Authenticate via QR login, run continuous sync, list chats, and search messages by keyword, chat, or date range. - History backfill: Request older messages for a specific chat when the phone is online. - Use Case: You ask the assistant to message your contractor at +14155551212 saying the meeting moved to 3pm; the Skill confirms the recipient and text, then runs wacli send text to deliver it. ## Quick Start Ask the assistant to send a WhatsApp message to a specific phone number with your exact message text, and confirm the recipient and content when prompted.

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 or group JID and --message for the text. For files, use wacli send file with --file and an optional --caption. Always confirm the recipient and content before sending.

How do I search my WhatsApp chat history with wacli?

Run wacli messages search with your query string, optionally narrowing by --chat JID or by date using --after and --before. Use wacli chats list to find the correct chat JID first, and add --json for machine-readable output.

Should I use wacli for normal WhatsApp chats with the assistant?

No. wacli is only for messaging third parties or syncing and searching history when explicitly requested. Normal user chats over WhatsApp are routed automatically by OpenClaw and do not need this tool.

How do I authenticate wacli with my WhatsApp account?

Run wacli auth to log in via QR code and perform the initial sync. Then use wacli sync --follow for continuous syncing and wacli doctor to diagnose setup issues. Data is stored in ~/.wacli by default.

Why does WhatsApp history backfill not return all old messages?

Backfill requires your phone to be online and results are best-effort, so older messages may be incomplete. Use wacli history backfill with --chat, --requests, and --count to control how much history is requested.