How to Connect OpenClaw to WhatsApp — Complete Setup Guide

WhatsApp has over 2 billion users. Here is how to connect it to your OpenClaw agent — so you can control your AI from the app you use most.

Of all the messaging channels OpenClaw supports, WhatsApp is the one that makes the biggest difference to most people's daily workflow. You already have it on your phone. Your contacts are already there. Connecting your AI agent to WhatsApp means you can delegate tasks the moment they occur to you — without switching to a different app, opening a laptop or thinking about it more than the time it takes to type a message.

Two Paths: Unofficial Bridge vs Official API

OpenClaw supports WhatsApp via two methods, and understanding the distinction before you start saves confusion later.

The unofficial bridge (Venom or Baileys) connects to your personal WhatsApp account by scanning a QR code — similar to how WhatsApp Web works. Setup takes under 5 minutes. It works with your existing WhatsApp number. The limitation: WhatsApp's Terms of Service consider this unofficial use, so there is a small risk of account restriction if you send very high volumes of messages. For personal use at normal volumes, this risk is minimal.

The official Meta WhatsApp Business API is fully compliant, works for customer-facing use cases, and supports high-volume messaging. The trade-off: it requires a WhatsApp Business account, Meta Business verification and slightly more complex setup (approximately 30-45 minutes instead of 5).

Quick Setup: Unofficial Bridge (Personal Use)

Install the WhatsApp bridge skill, which handles the connection automatically:

openclaw skills install whatsapp-bridge
openclaw channels add whatsapp

A QR code appears in your terminal. Open WhatsApp on your phone, go to Settings → Linked Devices → Link a Device, and scan the QR code. OpenClaw connects to your WhatsApp account instantly. Send yourself a test message — your agent should respond within a few seconds.

What You Can Do Once Connected

Once WhatsApp is connected, everything you could do in the browser interface is available from your phone's WhatsApp. Send a voice note — OpenClaw transcribes it and acts on it. Send a photo of a document — it reads and processes it. Send a task while commuting and come home to find it completed.

Practical examples that work immediately after connection: "Organise my Downloads folder by file type and tell me what you moved." "Search for the latest news about [competitor] and summarise the key developments." "Draft a reply to the email from [name] declining the meeting but suggesting next week." "Check if my website is online and what the response time is."