wacli

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

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/Polealpha/XINNIAN_PI --skill wacli-polealpha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wacli
Source: https://github.com/Polealpha/XINNIAN_PI/tree/main/app%20windows/vendor/openclaw-runtime/skills/wacli
Command: npx skills add https://github.com/Polealpha/XINNIAN_PI --skill wacli-polealpha

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you send WhatsApp messages to specific people or groups and retrieve/sync your own WhatsApp history using the wacli command-line tool, instead of relying on normal chat routing for everyday conversations.

Core Features & Use Cases

  • Explicit third-party messaging: Send a text or file to a recipient you name, including groups, with a focus on user-initiated contact rather than automated chatter.
  • History management: Authenticate, sync continuously, diagnose setup, and backfill chat history when you need older data.
  • Search and retrieval: List chats and search messages by query, date ranges, chat JIDs, or keywords like “invoice,” then inspect message content for your own records.

Quick Start

Ask: “Use wacli to message +14155551212 with the text ‘Hello! Are you free at 3pm?’ after you confirm the recipient and message.”

Frequently Asked Questions about wacli

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

FAQPage Schema
How do I send WhatsApp messages from the command line to a specific phone number?

To backfill older WhatsApp chat history, use the wacli backfill command to retrieve messages across specific JIDs and date ranges, populating your local message store with past conversations.

How does QR login work for syncing WhatsApp history?

QR login works for syncing WhatsApp history by using the wacli auth command to authenticate your session, enabling continuous history sync and allowing you to retrieve and search your past messages locally.

Can I search WhatsApp message history by date range and keywords?

You can search WhatsApp message history by date range and keywords using the wacli search command, which filters message content across specific chat JIDs to find exact terms like invoice within your local store.

What is the best way to diagnose WhatsApp connection or sync issues?

The best way to diagnose WhatsApp connection or sync issues is using the wacli doctor command, which evaluates your authentication setup and store status to help troubleshoot messaging and history retrieval failures.

Do I need to confirm recipient details before sending a WhatsApp message via CLI?

You need to explicitly confirm the recipient and message text before sending a WhatsApp message via CLI, ensuring that all outbound contact initiated through the command line is verified and intentional.