wacli for Openclaw

A professional command-line interface for WhatsApp that enables AI agents to send messages, share files, and search chat histories.

gabrielsayumi
v1.0.0
Feb 10, 2026
0
1.5k
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install probar

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 probar 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 specialized command-line utility designed for developers and AI agents who need to interact with WhatsApp programmatically. Unlike standard messaging interfaces, it focuses on bridging the gap between automated workflows and mobile communication. This skill allows agents to reach out to third parties, manage group interactions, and index communication history for better contextual awareness.

By integrating wacli through Openclaw Skills, you provide your AI with a secure way to handle messaging without relying on manual UI interactions. It uses a local storage system and provides structured JSON output, making it highly compatible with modern agentic architectures that require precise data handling and reliable delivery mechanisms.

wacli Use Cases

  • Automating outreach to third-party contacts or clients directly from an AI development environment.
  • Conducting deep searches across WhatsApp message history to retrieve specific information like invoices, dates, or contact details.
  • Synchronizing group chat data to keep an AI agent informed of team updates in real-time.
  • Sharing technical documentation, PDFs, or generated reports with external stakeholders via WhatsApp files.

How wacli Works

  1. The user authenticates the CLI by running the auth command and scanning a QR code with their mobile device to establish a secure session.
  2. The skill initializes a local database in the ~/.wacli directory to store message headers and chat metadata.
  3. When a messaging request is received, the agent identifies the correct JID (Jabber ID) for the recipient or group using the chat search functionality.
  4. The agent executes sending commands for text or media, with a built-in safety protocol to confirm details before transmission.
  5. Continuous synchronization can be enabled to ensure the agent has access to the most recent communication history for ongoing tasks.

wacli Setup

To integrate this tool into your Openclaw Skills workflow, install the binary using one of the following methods:

# Install via Homebrew
brew install steipete/tap/wacli

# Or install via Go
go install github.com/steipete/wacli/cmd/wacli@latest

Once installed, perform the initial authentication:

wacli auth

wacli Data Schema & Taxonomy

The wacli skill organizes data through a local store and provides structured output for agent consumption. It distinguishes between individual and group entities using specific JID formats:

Entity Type JID Format Example
Individual @s.whatsapp.net +14155551212@s.whatsapp.net
Group @g.us 1234567890-123456789@g.us

All commands support the --json flag, which outputs machine-readable data structures including message IDs, timestamps, sender info, and body text, allowing for seamless parsing within the Openclaw Skills ecosystem.

wacli Advanced Features

  • Real-time synchronization using the sync --follow command for persistent data updates.
  • Detailed history backfilling to retrieve past conversations and build a comprehensive knowledge base for the agent.
  • Granular search filters allowing agents to find messages by specific date ranges or keyword queries.
  • Support for multiple message types, including raw text and file attachments with custom captions.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*