WhatsApp Setup Guide
Configure WhatsApp channel in OpenClaw (formerly ClawDBot)
📋 Prerequisites
- OpenClaw installed and running
- WhatsApp account
- Meta Developer account (for WhatsApp Business API)
🔧 Setup Steps
1) Access Policy
{
channels: {
whatsapp: {
dmPolicy: "pairing",
allowFrom: ["+15551234567"],
groupPolicy: "allowlist",
groupAllowFrom: ["+15551234567"]
}
}
}
2) Link WhatsApp (QR)
openclaw channels login --channel whatsapp
openclaw gateway
openclaw pairing list whatsapp
openclaw pairing approve whatsapp <CODE>
Pairing code expires in about 1 hour.
⚠️ Common Issues
- Connected but no DM replies: run openclaw pairing list whatsapp and approve sender.
- Group messages ignored: check requireMention and mention patterns.
- Random reconnect loop: re-login and verify credentials directory health.