wacli

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

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/shalevamin/Tau_agent --skill wacli-shalevamin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wacli
Source: https://github.com/shalevamin/Tau_agent/tree/main/tau-agent-main/skills/wacli
Command: npx skills add https://github.com/shalevamin/Tau_agent --skill wacli-shalevamin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets an AI agent message third parties on WhatsApp and search or backfill WhatsApp chat history from the command line, without needing the WhatsApp app UI. ## Core Features & Use Cases - Send Messages: Send text or file messages to individual contacts or groups using phone numbers or JIDs. - Search & Sync History: Authenticate via QR login, sync chats continuously, 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 agent to message a contractor at +14155551212 confirming a 3pm appointment; the agent confirms the recipient and text, then runs wacli send text to deliver it. ## Quick Start Ask the agent to send a WhatsApp message to a specific phone number with your exact message text, and confirm the recipient before it sends.

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 date range using --after and --before. Add --json for machine-readable output when parsing results.

How do I install and authenticate wacli?

Install via Homebrew with the steipete/tap/wacli formula or via Go with go install of the wacli module. Then run wacli auth to log in with a QR code and perform the initial sync.

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 control the fetch volume.