openclaw-whatsapp
WhatsApp bridge for OpenClaw — send/receive messages, auto-reply agents, QR pairing, message search, contact sync
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/0xs4m1337/openclaw-whatsappWhat This Skill Does
The openclaw-whatsapp skill provides a powerful, self-hosted bridge between your OpenClaw AI agent and WhatsApp. By acting as a native interface for the messaging platform, it enables your agent to monitor incoming DMs, process them through customizable AI system prompts, and automatically dispatch replies without manual intervention. The skill handles complex backend requirements like QR code pairing for authentication, persistent session management, contact synchronization, and historical message searching, all bundled within a lightweight Go binary. It transforms your WhatsApp account into a programmable endpoint for your OpenClaw ecosystem.
Installation
To install, first run the automated installation script via curl -fsSL https://raw.githubusercontent.com/0xs4m1337/openclaw-whatsapp/main/install.sh | bash. Once binary verification is complete, identify your OpenClaw installation path using which openclaw. You must copy the provided relay scripts (wa-notify.sh and wa-notify-worker.sh) to /usr/local/bin/ and ensure they have executable permissions via chmod +x. Crucially, you must edit these scripts to point toward your actual binary installation path and ensure your ~/.openclaw-whatsapp/config.yaml file is correctly formatted with your desired AI persona and system instructions. For production reliability, it is highly recommended to encapsulate the process in a systemd user service to ensure it restarts automatically after system reboots.
Use Cases
This skill is ideal for professionals and developers who need to manage client communications while away from their devices. Common use cases include: setting up an AI-driven "out of office" concierge that answers common business inquiries; creating a notification relay that alerts your phone to specific technical events processed by OpenClaw; and building a personal virtual assistant that can query your local data via WhatsApp messages.
Example Prompts
- "OpenClaw, what is the status of the server migration project I sent you last week?"
- "If anyone asks about my availability today, tell them I am free after 4 PM and send them my booking link."
- "Search my recent messages for the invoice from the plumber and summarize the total amount due."
Tips & Limitations
Always ensure ignore_from_me is set to true in your config to prevent recursive loops where the agent replies to its own messages. Because this uses a WhatsApp bridge, ensure your phone is adequately charged or connected to a stable network, as the bridge relies on active session pairing. Be mindful of WhatsApp's terms of service regarding automated bots; keep your system prompts helpful and professional to avoid account flags. Lastly, regularly check /tmp/openclaw-wa-agent/worker.log for any connection jitter or authentication failures.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-0xs4m1337-openclaw-whatsapp": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-write, file-read, external-api, code-execution
Related Skills
demo-video
Create product demo videos by automating browser interactions and capturing frames. Use when the user wants to record a demo, walkthrough, product showcase, or interactive video of a web application. Supports Playwright CDP screencast for high-quality capture and FFmpeg for video encoding.
Search and browse Pinterest pins, get pin details, and send actual images to the user via Telegram/messaging. Use when the user wants to find inspiration, search for images/ideas, or browse Pinterest content. Sends images directly, not just links.