Channel Capabilities

Feature Supported Notes
Direct Messages ✓ Full support for 1:1 conversations
Group Chats ✓ Participate in group conversations
Media Messages ✓ Send and receive images, files
Voice Messages ✓ Audio message support
Reactions — Not available
Threads — Not available
Native Commands — Not available

Access Control Policies

DM Policies

Control who can send direct messages to your bot:

allowlist

Only senders in the allowFrom list can interact with the bot.

pairing

Unknown senders receive a pairing code that admin must approve before access is granted.

open

All direct messages are processed (requires allowFrom: ["*"]).

Group Policies

Control which groups your bot participates in:

allowlist

Only groups in groupAllowFrom are processed.

open

Bot responds in all groups it is added to.

Setup Guide

  1. Enable WhatsApp in your openclaw.json configuration
  2. Start the OpenClaw gateway with 'openclaw gateway start'
  3. Scan the QR code displayed in terminal with WhatsApp mobile app
  4. Wait for authentication to complete
  5. Configure DM policy and allowlist for access control

Configuration Example

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "dmPolicy": "pairing",
      "allowFrom": ["[email protected]"],
      "groupPolicy": "allowlist",
      "mediaMaxMb": 5
    }
  }
}

Use WhatsApp with AI Providers

Connect WhatsApp to your preferred AI model provider:

Frequently Asked Questions

How do I set up WhatsApp with OpenClaw?
To set up WhatsApp: Enable WhatsApp in your openclaw.json configuration. Start the OpenClaw gateway with 'openclaw gateway start'. Scan the QR code displayed in terminal with WhatsApp mobile app. Full configuration options are available in the openclaw.json file.
How do I control who can message my WhatsApp bot?
WhatsApp supports allowlist, pairing, open for DM access control and allowlist, open for groups. Use allowlists for maximum security or pairing mode for easy onboarding.
Does WhatsApp support media messages?
WhatsApp supports media including images, audio, video, documents. Maximum media size is configurable via mediaMaxMb setting (default: 4.096MB).
Can I use OpenClaw in WhatsApp groups?
WhatsApp supports group chats with configurable access policies. Groups and DMs are supported.