OpenClaw WhatsApp Setup: Complete Step-by-Step Guide

WhatsApp is by far the most popular channel for OpenClaw users. The reason is simple: most people already have WhatsApp on their phone, and texting your AI assistant feels natural — like messaging a very capable colleague. Within 15 minutes of connecting WhatsApp, you can send your first command and watch your agent take action.

This guide walks you through the entire WhatsApp setup process step by step. We cover the QR code connection method (the easiest), configuration options, sending your first message, and troubleshooting the most common errors people encounter.

Important: OpenClaw connects to WhatsApp using the WhatsApp Web protocol. This means your phone needs to stay connected to the internet for the connection to work. If your phone goes offline, your WhatsApp agent pauses until it reconnects. For 24/7 reliability, some users get a dedicated cheap phone or SIM card.

In your OpenClaw configuration, you need to enable the WhatsApp channel. This tells the Gateway to start the WhatsApp Web connection process. The exact method depends on how you installed OpenClaw — through the admin UI, the configuration file, or the command line.

If you are using the admin panel (Mission Control), navigate to Channels and click "Add Channel," then select WhatsApp. If you are editing configuration files directly, you add the WhatsApp channel configuration to your gateway settings.

After enabling the WhatsApp channel, OpenClaw generates a QR code — exactly like WhatsApp Web does in your browser. You scan this QR code with your phone to authenticate the connection.

Once connected, your OpenClaw agent can receive and send WhatsApp messages. The connection persists until you manually disconnect it or your phone goes offline for an extended period.

The moment of truth. Open WhatsApp on your phone and send a message to yourself (or the number connected to OpenClaw). Start with something simple.

If your agent responds, congratulations — your WhatsApp connection is working. If it does not respond within 30 seconds, check the troubleshooting section below.

Once the basic connection works, you should configure how your agent handles WhatsApp messages.

The real power of OpenClaw on WhatsApp comes from automation — tasks that run without you sending a message. The most popular first automation is the morning briefing.

Configure the Heartbeat feature to send you a WhatsApp message every morning at your preferred time. It summarizes your emails, calendar events, weather, and any tasks due today. You wake up, check your WhatsApp, and immediately know what your day looks like — without opening five different apps.

Check that the WhatsApp channel is enabled in your configuration. Verify the Gateway is running (check logs for errors). Some installations require restarting the Gateway after enabling a new channel.

WhatsApp Web connections require your phone to maintain an internet connection. If your phone enters deep sleep or loses connectivity, the link drops. Solutions: keep your phone plugged in and connected to WiFi, disable battery optimization for WhatsApp, or use a dedicated device.

Verify the connection shows as active in your OpenClaw logs. Check that your AI model API key is valid and has credit. Ensure the message is being received (check incoming message logs). If logs show the message arriving but no response, the issue is likely with your AI model configuration.

WhatsApp does not officially support bot accounts on personal numbers. Sending too many automated messages, especially to contacts who have not messaged you first, can trigger a temporary or permanent ban. To minimize risk: only respond to incoming messages (do not spam contacts), add a realistic response delay, avoid bulk messaging, and consider using WhatsApp Business API for commercial use. See our security guide for best practices.

Module 3 of our CampeloClaw course covers WhatsApp setup in complete detail — including video walkthroughs of every step, advanced configuration, and workarounds for common issues that tutorials skip over.