What if your WhatsApp could reply with the intelligence of Claude or GPT — answering questions, taking actions, and handling messages while you focus on other things? OpenClaw makes this possible in about 15 minutes, with no WhatsApp Business API, no monthly subscription, and full control over who can reach your assistant. This guide walks through the complete setup, based on the Thetips4you video tutorial.
What You’ll Learn in This Post
- What OpenClaw is and how it connects to WhatsApp without a Business API
- Prerequisites and system requirements
- Step-by-step installation and WhatsApp linking via QR code
- How to configure access control (who can message your agent)
- How to start the gateway and keep your agent running
- Security tips and what to watch out for
Watch the Full Video Tutorial
Follow along with the complete step-by-step video by Thetips4you:
Tutorial by Thetips4you
What Is OpenClaw?
OpenClaw is an open-source personal AI assistant that runs directly on your machine and connects to messaging platforms like WhatsApp, Telegram, Slack, Discord, Signal, and more. Instead of paying for a cloud-hosted chatbot service, you own the entire stack — the agent runs on your hardware, uses your API key, and responds through your own WhatsApp number.
The WhatsApp integration works through the Baileys protocol — an open-source implementation of the WhatsApp Web multi-device protocol. This means OpenClaw links to WhatsApp the same way WhatsApp Web does: scan a QR code with your phone and it acts as a linked companion device, intercepting inbound messages and sending AI-generated replies back. No Meta Business API approval needed.
| Feature | Details |
|---|---|
| Supported platforms | WhatsApp, Telegram, Slack, Discord, Signal, iMessage, and more |
| AI models supported | 20+ including Claude, GPT-4, Gemini, DeepSeek |
| Skills / extensions | 3,200+ skills available from ClawHub |
| Runs on | Linux, Windows, macOS |
| Connection method | Baileys protocol (QR code, no Business API) |
| Cost | Free and open-source (you pay only for your AI API key usage) |
Prerequisites
Before starting, make sure you have:
- Node.js 22+ installed — check with
node --version. Note: Bun is not supported; use Node.js for stable operation - An AI API key — Anthropic (Claude) is recommended; OpenAI and others also work
- A WhatsApp account — a dedicated number is strongly recommended to keep your personal messages separate
- Active internet connection — the gateway must stay online to send and receive messages
Tip: Use a secondary SIM or a WhatsApp Business account on a spare number rather than your main personal number. This keeps your personal messages separate and reduces any risk to your primary account.
Step-by-Step Setup: OpenClaw on WhatsApp
Step 1: Install OpenClaw and Onboard
Run the onboarding command to install the CLI and set up your environment:
openclaw onboardThis walks you through connecting your AI API key and configuring your default model. When prompted, enter your Anthropic (or OpenAI/Gemini) API key.
Step 2: Add the WhatsApp Channel Plugin
Install the WhatsApp integration:
openclaw channels add --channel whatsappAlternatively, install the plugin directly:
openclaw plugins install @openclaw/whatsappStep 3: Configure Access Control
Before linking your WhatsApp account, decide who can message your agent. Create or edit your OpenClaw config file to set the dmPolicy:
{
channels: {
whatsapp: {
dmPolicy: "pairing",
allowFrom: ["+15551234567"],
groupPolicy: "allowlist",
groupAllowFrom: ["+15551234567"]
}
}
}The dmPolicy options are:
| Policy | Who Can Message | Best For |
|---|---|---|
pairing (default) | Unknown senders must request approval | Safe starting point for most users |
allowlist | Only numbers in allowFrom | Strict personal use only |
open | Anyone (requires allowFrom: ["*"]) | Public-facing agents |
disabled | No one | Temporarily disabling DMs |
Step 4: Link Your WhatsApp Account via QR Code
Run the login command to generate a QR code:
openclaw channels login --channel whatsappA QR code will appear in your terminal. On your phone:
- Open WhatsApp → Settings
- Tap Linked Devices
- Tap Link a Device
- Scan the QR code in your terminal
Once scanned, your credentials are saved to ~/.openclaw/credentials/whatsapp/. You won’t need to scan again unless you log out or the session expires.
Step 5: Start the Gateway
Launch the OpenClaw gateway to start receiving and responding to messages:
openclaw gatewayYour WhatsApp AI agent is now live. Send a message to your linked WhatsApp number and the agent will respond using your configured AI model.
Important: The gateway must stay running for the agent to work. If you close the terminal, the agent stops responding. For always-on use, run it as a background service or use a tool like
pm2to keep it alive.
Step 6: Approve Pairing Requests (if using pairing mode)
If you set dmPolicy: "pairing", new senders receive a pairing code when they first message your agent. To approve them:
openclaw pairing list whatsapp
openclaw pairing approve whatsapp <CODE>Pairing requests expire after 1 hour, and a maximum of 3 can be pending at once.
Key Features Worth Knowing
- Multi-model support — switch between Claude, GPT-4, Gemini, or DeepSeek without changing your setup
- Media handling — supports sending and receiving images, audio, documents, and video through WhatsApp
- Long message chunking — responses longer than WhatsApp’s limit are automatically split into multiple messages
- Isolated sessions — each conversation gets its own context; group chats are isolated by group ID
- 3,200+ skills on ClawHub — extend your agent with capabilities like sending emails, web search, calendar access, and more
- Built-in rate limiting — protects your WhatsApp account from being flagged for sending too many messages too quickly
Key Takeaways
- No Business API required — OpenClaw uses Baileys (QR code linking), so anyone with a WhatsApp account can set this up
- Use a dedicated number — strongly recommended to separate your personal WhatsApp from your AI agent
- Start with
pairingmode — it’s the safest default; you approve each new contact manually - Keep the gateway running — use
pm2or a systemd service for always-on deployment - Node.js 22+ only — Bun is not supported; stick to Node.js for stable operation
- Open-source and self-hosted — your conversations stay on your machine, not on a third-party server
Frequently Asked Questions
Does OpenClaw require the WhatsApp Business API?
No. OpenClaw uses the Baileys protocol, which connects to WhatsApp by emulating a linked device — the same way WhatsApp Web works. You just scan a QR code with your phone. No Business API account or Meta approval is needed.
Which AI models does OpenClaw support?
OpenClaw supports 20+ leading AI models including Claude (Anthropic), GPT-4 (OpenAI), Gemini (Google), and DeepSeek. Anthropic Claude is the recommended default for best performance and reliability.
Will using OpenClaw get my WhatsApp account banned?
OpenClaw includes built-in rate limiting to protect your account. However, OpenClaw recommends running the assistant on a dedicated WhatsApp number rather than your personal one, to reduce the risk of account restrictions and keep your personal messages separate.
Can I control who can message my OpenClaw WhatsApp agent?
Yes. OpenClaw has a dmPolicy setting with four modes: pairing (unknown senders must be approved), allowlist (only your specified numbers), open (anyone), and disabled (no DMs). The default is pairing mode, which is the safest starting point.
What are the system requirements for OpenClaw?
You need Node.js 22 or higher, an API key (Anthropic is recommended), and an active internet connection. Note that Bun is not supported — use Node.js for stable operation. OpenClaw runs on Linux, Windows, and macOS.
Conclusion
OpenClaw brings a genuinely useful personal AI agent to WhatsApp in a way that’s fast to set up, free to run, and fully under your control. Whether you want a private assistant that only you can message, or a lightweight support bot for a small team, the combination of Baileys-based linking, multi-model support, and fine-grained access control makes it one of the most practical self-hosted WhatsApp AI tools available in 2026.
Check out the Thetips4you YouTube channel for more hands-on tutorials on AI tools, DevOps, Docker, and developer productivity.
Source: OpenClaw Full Setup Tutorial — AI Agent on WhatsApp in 15 Minutes (2026) by Thetips4you