A high-performance WhatsApp bridge for OpenClaw that enables AI-powered auto-replies, message synchronization, and full-text search through a single Go binary.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openclaw-whatsapp
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install openclaw-whatsapp 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 OpenClaw WhatsApp Bridge?
The OpenClaw WhatsApp Bridge serves as a robust gateway between your OpenClaw agents and the WhatsApp ecosystem. By utilizing this skill, developers can transform a standard WhatsApp account into an intelligent automated assistant capable of processing incoming Direct Messages (DMs), maintaining conversation context, and executing complex workflows. It is built for performance and reliability, featuring a lightweight Go-based architecture that integrates seamlessly into existing Openclaw Skills environments.
This bridge is not just a messaging tool; it is a full-featured communication layer that provides programmatic access to WhatsApp features like QR pairing, contact synchronization, and historical message searching. Whether you are building a customer support bot or a personal productivity assistant, this skill provides the necessary infrastructure to handle real-time interactions with low latency and high crash resilience.
OpenClaw WhatsApp Bridge Use Cases
- Automating customer support via WhatsApp DMs using AI agents.
- Building a personal AI assistant that can reply to messages while you are offline.
- Synchronizing WhatsApp message history into a searchable SQLite database for data analysis.
- Triggering complex agent workflows based on incoming WhatsApp keywords or commands.
- Sending automated notifications or alerts from CLI tools directly to WhatsApp contacts.
How OpenClaw WhatsApp Bridge Works
- The bridge initializes a connection to WhatsApp servers and generates a QR code for secure device pairing.
- Incoming messages are captured by the bridge and immediately enqueued to a local worker script to ensure fast response times.
- A background worker processes the queue sequentially, preventing race conditions and ensuring message integrity.
- The worker retrieves conversation context (last 10 messages) and passes it to the OpenClaw agent for processing.
- The agent generates a response based on the defined system prompt and sends the reply back through the bridge to the user.
OpenClaw WhatsApp Bridge Setup
First, install the binary and verify the version:
curl -fsSL https://raw.githubusercontent.com/0xs4m1337/openclaw-whatsapp/main/install.sh | bash
openclaw-whatsapp version
Next, install the required relay scripts to your local bin directory to facilitate communication between the bridge and Openclaw Skills:
sudo cp scripts/wa-notify.sh /usr/local/bin/
sudo cp scripts/wa-notify-worker.sh /usr/local/bin/
sudo chmod +x /usr/local/bin/wa-notify*
Configure your ~/.openclaw-whatsapp/config.yaml to enable the agent mode and set your system prompt. Finally, set up the systemd service to ensure the bridge runs persistently in the background, then visit http://localhost:8555/qr to link your device.
OpenClaw WhatsApp Bridge Data Schema & Taxonomy
The bridge organizes data locally to ensure persistence and easy management of your Openclaw Skills data.
| Path | Description |
|---|---|
~/.openclaw-whatsapp/config.yaml |
Main configuration for ports, logging, and agent behavior. |
~/.openclaw-whatsapp/messages.db |
SQLite database storing message history and metadata. |
~/.openclaw-whatsapp/sessions/ |
Directory containing encrypted WhatsApp session data. |
/tmp/openclaw-wa-agent/queue.jsonl |
Persistent message queue for the background worker. |
/tmp/openclaw-wa-agent/seen_message_ids.txt |
Deduplication log to prevent duplicate AI responses. |
OpenClaw WhatsApp Bridge Advanced Features
- Sequential worker processing with file-locking to prevent concurrent execution conflicts.
- Flexible allowlist and blocklist configurations to control which contacts can interact with the AI.
- Full-text search API endpoints for querying message history programmatically.
- Customizable system prompts that allow agents to use external tools via Openclaw Skills.
- Automatic session reconnection and crash resilience for high-uptime deployments.
SKILL.md
Loading
Related Openclaw Skills
Demo Video Creator
Automate browser-based product demos and interactive walkthroughs using Playwright and FFmpeg to generate high-quality video or GIF assets.
Claw Werewolf
An automated AI bot variety show that allows agents to compete in strategic werewolf social deduction matches.
Claw Werewolf Live
A competitive variety show platform where AI bots participate in automated Werewolf matches with live spectator viewing.
Nudge Marketplace Skill
A specialized tool for registering and managing AI-native wellness and productivity agents on the Nudge marketplace.
Shadow Number
A powerful utility for AI agents to acquire disposable phone numbers and automate OTP verification for website signups using crypto payments.
ClawdNet Agent Skill
Register, discover, and interact with decentralized AI agents through the ClawdNet registry.
Featured*
