Clawdbot for WhatsApp
Use Clawdbot on WhatsApp, the world's most popular messaging app. Chat with AI right from your phone, anywhere in the world.
WhatsApp Features
Personal Chats
Private AI conversations
Voice Messages
Send voice, get text replies
Image Analysis
Send photos for AI analysis
Document Sharing
Share PDFs and documents
Location Aware
Share location for context
Always Available
Chat from your phone anywhere
WhatsApp integration uses the WhatsApp Web protocol. This is not an official API and may have limitations:
- Requires an active WhatsApp account and phone number
- Your phone must stay connected to the internet
- May require periodic re-authentication
- Not suitable for business use (use WhatsApp Business API instead)
Setup Guide
Enable WhatsApp in your Clawdbot configuration:
# In your .env file
WHATSAPP_ENABLED=true
docker compose up -d
Watch the logs for the QR code:
docker compose logs -f
A QR code will appear in the terminal. Scan it with WhatsApp:
- Open WhatsApp on your phone
- Tap the three dots menu (Android) or Settings (iOS)
- Select "Linked Devices"
- Tap "Link a Device"
- Scan the QR code shown in the terminal
Once connected, you can:
- Send messages to the bot number to chat with AI
- Add the bot to group chats (optional)
- Send images, voice messages, and documents
Configuration Options
# In .env - with country code
WHATSAPP_ALLOWED_NUMBERS=1234567890,0987654321
# In .env
WHATSAPP_ALLOW_GROUPS=false
# In .env
WHATSAPP_AUTO_READ=true
# Session is saved in ./data/whatsapp
# Mount this volume for persistence
Troubleshooting
Check the logs for errors. Make sure WHATSAPP_ENABLED=true is set in your .env file. The QR code only appears on first connection.
Ensure your phone has a stable internet connection. WhatsApp Web requires your phone to stay online. Check if you're not logged into too many devices.
Delete the session folder (./data/whatsapp) and restart to get a new QR code.
Verify the number format is correct (include country code without +). Check if the number is in the allowed list if you've set restrictions.
Tips for WhatsApp
Use a Dedicated Number
Consider using a separate phone number for your bot to avoid mixing personal and bot messages.
Keep Phone Charged
WhatsApp Web disconnects if your phone runs out of battery or loses internet connection.
Voice Messages Work Great
Send voice messages for hands-free interaction. They'll be transcribed and processed by AI.