How to Set Up an OpenClaw WhatsApp Bot

What Is an OpenClaw WhatsApp Bot?

An OpenClaw WhatsApp bot is a full AI agent that lives inside your WhatsApp conversations. Powered by leading AI models like Claude, GPT-5.2, Gemini, or DeepSeek — and extended with 5,700+ skills from ClawHub — it goes far beyond basic WhatsApp chatbots. It understands natural language, holds multi-turn conversations, browses the web, manages files, writes code, and performs real-world actions.

You can use it as a personal AI assistant in WhatsApp DMs, add it to group chats, or run it as a 24/7 automated agent for tasks like web research, content creation, and coding help — all from the messaging app you already use every day.

Step 1: Set Up the WhatsApp Business API

WhatsApp bots require access to the WhatsApp Business API through Meta's Business Platform. Here's how to get started:

1. Go to the Meta for Developers portal and create an app (select "Business" as the app type).
2. In your app's dashboard, click Add Product and select WhatsApp. Follow the prompts to connect a Meta Business Account.
3. Navigate to WhatsApp > API Setup. You'll see a temporary access token and a test phone number. For production, add your own phone number and generate a permanent access token under System Users.
4. Copy your Phone Number ID and Access Token. You'll need both to connect OpenClaw.

Step 2: Deploy with OpenClaw Launch

With your WhatsApp credentials in hand, deploying on OpenClaw Launch takes 30 seconds:

1. Go to openclawlaunch.com and open the configurator.
2. Select "WhatsApp" as your chat platform, then paste your Phone Number ID and Access Token.
3. Pick your AI model — Claude Sonnet 4.6 is recommended for the best balance of speed and intelligence. You can switch models later without redeploying.
4. Click Deploy. Your OpenClaw WhatsApp bot launches in under 30 seconds. Docker, config files, and networking are handled automatically.

Step 3: Configure the Webhook

Meta requires a webhook URL so WhatsApp can forward incoming messages to your bot. OpenClaw Launch provides this automatically — after deployment, you'll see your webhook URL and verify token on your Dashboard page.

1. In the Meta for Developers portal, go to WhatsApp > Configuration.
2. Paste the Callback URL and Verify Token provided by OpenClaw Launch.
3. Subscribe to the messages webhook field. This tells Meta to forward all incoming messages to your bot.
4. Click Verify and Save. Meta will send a verification request to confirm the connection.

Step 4: Start Chatting

Once the webhook is configured, your OpenClaw WhatsApp bot is live. It can:

• Answer questions and hold multi-turn conversations
• Browse the web and summarize links
• Write and review code
• Draft emails, documents, and creative content
• Use 5,700+ ClawHub skills (web search, file management, and more)
• Switch AI models on the fly with the /model command

See the OpenClaw Manual for a full list of chat commands.

Troubleshooting

Messages Not Arriving

If your bot isn't receiving messages, the most common cause is a webhook misconfiguration:

• Verify the Callback URL in Meta's portal matches the webhook URL shown on your OpenClaw Launch dashboard exactly.
• Check that the Verify Token matches — a single character difference will cause verification to fail.
• Make sure you've subscribed to the messages webhook field. Without it, Meta won't forward incoming messages.

WhatsApp Business API Limits

• New WhatsApp Business accounts start with a limited messaging tier. You can send messages to up to 250 unique users per 24-hour period initially, scaling up as you build a track record.
• Template messages (pre-approved message formats) are required for outbound conversations. Replies to user-initiated messages don't require templates.
• Meta enforces a 24-hour customer service window — your bot can reply freely within 24 hours of the user's last message. After that, only template messages are allowed.

Bot Not Responding

• Double-check that your Access Token is valid and hasn't expired. Temporary tokens from the API Setup page expire after 24 hours — use a permanent System User token for production.
• Verify the WhatsApp plugin is enabled in your OpenClaw config. Both the channel config and the plugin entry must be active.
• Check your instance logs on the Dashboard page for any error messages from the WhatsApp plugin.

Self-Hosting vs. OpenClaw Launch

You can also self-host an OpenClaw WhatsApp bot with Docker, but it requires a VPS with a public HTTPS endpoint, manual config files, webhook setup, and ongoing maintenance. See our install guide for the full process. OpenClaw Launch skips all of that — configure visually and deploy in seconds.