WhatsApp Integration
Connect OpenClaw to WhatsApp and have your AI assistant respond to messages instantly.
TL;DR
- ✓ Prerequisites: Node.js 22+, OpenClaw installed
- ✓ Configuration: Add WhatsApp section to openclaw.json
- ✓ Time: ~10 minutes
- ✓ Pairing: QR code authentication
Prerequisites
- 1.
OpenClaw installed
Follow the installation guide if you haven't already.
- 2.
WhatsApp account
You'll need an active WhatsApp account for pairing.
- 3.
Mobile device with WhatsApp
Required for QR code scanning during setup.
Setup Steps
Step 1: Configure openclaw.json
Add the WhatsApp configuration to your openclaw.json file:
{
"channels": {
"whatsapp": {
"enabled": true,
"allowFrom": ["*"]
}
}
}Step 2: Start OpenClaw
Start OpenClaw with WhatsApp enabled:
openclaw startYou'll see a QR code in the console. Scan it with your WhatsApp mobile app.
Step 3: Pair with QR Code
Open WhatsApp on your phone and go to:
- Settings → Linked Devices
- Tap "Link a Device"
- Scan the QR code from the console
🎉 Connected! Your WhatsApp AI assistant is now ready.
Advanced Configuration
Allow Specific Senders
Restrict who can interact with your AI assistant:
{
"channels": {
"whatsapp": {
"enabled": true,
"allowFrom": ["+1234567890", "+0987654321"]
}
}
}Troubleshooting
QR code not scanning?
Make sure your phone's screen brightness is at maximum and the QR code is fully visible in the console.
Session disconnected?
Restart OpenClaw and re-scan the QR code. WhatsApp sessions may expire after some time.
Messages not being received?
Check that your openclaw.json has "enabled": true for the WhatsApp channel.