wacli

Send WhatsApp messages and search or sync chat history via wacli CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the need to send explicit WhatsApp messages to specific people or to search/sync WhatsApp history using the wacli CLI, instead of relying on automatic WhatsApp routing for normal chats.

Core Features & Use Cases

  • Explicit third-party messaging: Send a WhatsApp message only when the user explicitly requests contacting someone else, with safety checks for recipient and message content.
  • Auth and history sync: Perform QR-based authentication and run sync to keep local WhatsApp data up to date for later searching.
  • Search and backfill: List chats, search messages within a chat, and backfill history with controlled request parameters (best-effort results when the phone is online).

Quick Start

Send a WhatsApp text message by providing a clear recipient and message content, for example: wacli send text --to "+14155551212" --message "Hello! Are you free at 3pm?"

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 to a specific contact from the command line?

To send a WhatsApp message from the command line, use wacli to specify an explicit recipient phone number and message text. This ensures targeted third-party outreach with safety checks rather than relying on automatic chat routing.

How does WhatsApp history sync work via CLI?

WhatsApp history sync via CLI uses QR-based authentication to connect your account, then runs continuous sync commands to keep local chat data up to date. This enables offline access and later message querying by chat or time range.

Can I search past WhatsApp messages by chat or time range?

Yes, you can search past WhatsApp messages by routing find and search operations to specific chat JIDs and flags. wacli allows targeted querying of past communications for audit-style workflows.

Do I need to authenticate before backfilling WhatsApp chat history?

Yes, QR authentication is required before backfilling WhatsApp chat history. Once authenticated, you can run sync commands with controlled request parameters to retrieve best-effort results when the phone is online.

What are the limitations of syncing WhatsApp history with a CLI tool?

Syncing WhatsApp history via CLI provides best-effort results contingent on the paired phone being online. Additionally, explicit recipient and message text are mandatory for sending texts to prevent unintended messaging.

Does wacli support listing all my WhatsApp chats?

Yes, wacli supports listing WhatsApp chats. You can list chats, search messages within a specific chat, and backfill history using controlled request parameters to manage your local WhatsApp data.