wacli for Openclaw

A specialized command-line interface for sending WhatsApp messages to third parties and managing message history.

rafay0313
v1.0.0
Jan 28, 2026
0
2.8k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install tt

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install tt using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is wacli?

wacli is a powerful utility designed to enable AI agents and developers to interact with the WhatsApp platform directly from the terminal. Unlike standard chat interfaces, this tool focuses on programmatic interactions such as sending automated notifications, file sharing, and deep-history searching. By integrating this capability through Openclaw Skills, agents can reach out to external contacts or retrieve historical data without requiring manual user intervention in a graphical app.

The tool prioritizes security and explicit intent, ensuring that messages are only sent when specifically requested. It allows for a localized sync of WhatsApp data, making it an efficient choice for developers who need to perform complex queries across large message archives or manage group communications via scripts.

wacli Use Cases

  • Sending automated text notifications or documents to external recipients.
  • Searching through extensive WhatsApp history for specific keywords like invoices or dates.
  • Backfilling and archiving chat history for data analysis or auditing.
  • Managing group chat communications through scripted command-line actions.
  • Integrating WhatsApp outreach into complex multi-step workflows via Openclaw Skills.

How wacli Works

  1. Authentication is performed by running the auth command and scanning a QR code with your mobile device.
  2. The tool initializes a local database in the ~/.wacli directory to store chat metadata and message history.
  3. Continuous or one-time synchronization is triggered to ensure local data matches the WhatsApp server.
  4. Users or agents identify specific recipients using JIDs (Jabber IDs) retrieved via the chat listing command.
  5. Commands are issued to send text or files, which are then dispatched through the authenticated session.

wacli Setup

Install wacli using Homebrew:

brew tap steipete/tap
brew install wacli

Alternatively, install via Go:

git install github.com/steipete/wacli/cmd/wacli@latest

Initialize your session:

wacli auth

wacli Data Schema & Taxonomy

The skill organizes its data locally to facilitate fast searching and retrieval within Openclaw Skills environments.

Component Description
Storage Path Defaulting to ~/.wacli (can be overridden with --store)
Individual JID Formatted as <number>@s.whatsapp.net
Group JID Formatted as <id>@g.us
Output Type Supports --json flag for machine-readable parsing by AI agents

wacli Advanced Features

  • Support for background synchronization with the --follow flag to keep history updated in real-time.
  • Detailed history backfilling with configurable request counts for deep data retrieval.
  • Advanced search filters including before and after date parameters.
  • Diagnostic 'doctor' command to troubleshoot connectivity and authentication status.
  • File attachment support with custom captions for professional outreach via Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*