CR ClawReady.in Independent guide
Setup Help
Open menu
Guide Menu expand_more

whatsapp

OpenClaw WhatsApp Setup for Indian Users

Set up OpenClaw with WhatsApp using dedicated-number guidance, QR/session warnings, privacy risks, and safer group boundaries.

Difficulty
intermediate
Duration
30-45 minutes
Tested On
WhatsApp channel setup
Access Mode
Dedicated number where possible
verified
Status readiness check
Pre-Flight Approved
Risk rating high
Gateway status Private
High-risk guide Do not connect your personal WhatsApp number. WhatsApp aggressively bans automated personal accounts. Use a dedicated business number.

Who this is for

This guide is for developers building OpenClaw assistants meant to interact over WhatsApp. In India, WhatsApp is the default communication layer, meaning the stakes for account bans or privacy leaks are extremely high.

Prerequisites

  • OpenClaw installed and Gateway running.
  • A secondary phone or a virtual number dedicated solely to this bot.
  • A clean WhatsApp Business account installed on that secondary device.

Setup Steps

  1. Prepare the dedicated device

    Ensure your dedicated WhatsApp Business number is active and can receive messages.

  2. Add the WhatsApp Channel

    Use the OpenClaw CLI to initiate the WhatsApp connection process. This will generate a QR code in your terminal.

    bash
    openclaw channel add whatsapp

  3. Scan the QR Code

    Open WhatsApp Business on your dedicated device. Go to Linked Devices and scan the QR code printed in your terminal.

  4. Configure Allowlist Security

    OpenClaw will now reply to anyone who messages that number. To prevent spam and API abuse, edit your claw.config.json.

    "channels": {
  "whatsapp": {
    "enabled": true,
    "dmPolicy": "allowlist",
    "allowlist": ["919876543210"]
  }
}

    (Replace with your actual personal number, including the country code without the +)

  5. Restart the Gateway

    Restart OpenClaw to enforce the allowlist.

    bash
    openclaw restart 
    [OK] WhatsApp channel connected.

Group Boundaries & Bad Output

  • Spam Bans: WhatsApp will ban numbers that send too many messages quickly or receive user reports. Your OpenClaw agent should never send unprompted outbound messages.
  • Group Exposure: If you add your bot to a family or business group, it will read every message if configured poorly. Ensure groupPolicy is set to mentions_only.

Rollback & Disconnect

To disconnect the bot, simply log out of the “Linked Device” from your phone, and run:

bash
openclaw channel remove whatsapp

When to ask for help

WhatsApp API setups (via Meta) versus WhatsApp Web bridging (via Baileys/Puppeteer) have drastically different ban risks and scaling limits. If you need to deploy this for a production business in India without risking a ban, request a WhatsApp Architecture Review.

Sources

ClawReady.in is an independent educational resource and setup service. It is not affiliated with, endorsed by, or operated by OpenClaw.