wacli

Control WhatsApp via CLI to sync, search, and send text and file messages.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

WhatsApp control from a local CLI to simplify syncing, searching, and sending messages through WhatsApp Web protocol.

Core Features & Use Cases

  • Auth + sync: wacli auth (QR login) and wacli sync --follow for continuous sync; wacli doctor for diagnostics.
  • Search + history: wacli messages search and wacli history backfill.
  • Send: text and file messages via wacli send text and wacli send file.
  • Notes: Store dir ~/.wacli; backfill requires your phone online; intended for debugging and testing within Clawdis.

Quick Start

Authenticate with wacli using QR login, then start a continuous sync with wacli sync --follow.

Frequently Asked Questions about wacli

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

FAQPage Schema
How do I automate WhatsApp message sending from a local CLI?

You can automate WhatsApp message sending using a local CLI to dispatch text and file messages via the WhatsApp Web protocol. It requires installing the wacli binary and authenticating via QR login.

What is the best way to search WhatsApp conversation history from a terminal?

Searching WhatsApp conversation history from a terminal is done by syncing local message data and running search commands against the stored records. Continuous syncing keeps the searchable history updated.

Do I need my phone online to sync WhatsApp messages locally?

Yes, your phone must be online to sync and backfill WhatsApp message history. The local CLI communicates via the WhatsApp Web protocol, which requires an active phone connection for data retrieval.

Can I use WhatsApp Web protocol commands for testing and debugging chat workflows?

Yes, you can use WhatsApp Web protocol commands via CLI for testing and debugging chat workflows. It supports live chat monitoring, message dispatch, and diagnostics within local or team environments.

How do I authenticate a local WhatsApp CLI tool?

You authenticate a local WhatsApp CLI tool by scanning a QR code during login. This links the CLI to your WhatsApp account, enabling programmatic sync, search, and send capabilities.

What are the limitations of syncing WhatsApp messages through a CLI?

Limitations of syncing WhatsApp messages through a CLI include requiring your phone to be online for backfills and depending on local environment storage. It is primarily intended for debugging and testing rather than production.