How to Connect OpenClaw to WhatsApp (2026 Guide)

WhatsApp integration is one of OpenClaw’s best features. Chat with your AI agent from your phone, get notifications, and automate messaging.

Method 1: StartClaw (30 seconds)

If you’re using StartClaw:

1. Open your StartClaw dashboard
2. Click your agent → Integrations
3. Click Connect WhatsApp
4. Scan the QR code with your phone
5. Done!

WhatsApp stays connected 24/7. If it ever disconnects, StartClaw auto-reconnects.

Method 2: Self-Hosted (15-30 minutes)

For self-hosted OpenClaw:

Step 1: Start OpenClaw

cd openclaw npm run start

Step 2: Open the Web UI

Navigate to http://localhost:18789

Step 3: Connect WhatsApp

1. Click Integrations in sidebar
2. Click WhatsApp → Connect
3. QR code appears on screen

Step 4: Scan with Your Phone

1. Open WhatsApp on your phone
2. Go to Settings → Linked Devices
3. Tap Link a Device
4. Scan the QR code

Step 5: Verify

You should see “WhatsApp Connected” in the UI.

Keeping WhatsApp Connected (Self-Hosted)

The challenge with self-hosting: WhatsApp disconnects frequently.

Common causes:

• Phone loses internet temporarily
• Server restarts
• WhatsApp updates
• Session expires

On StartClaw: We handle reconnection automatically.

Self-hosted fixes:

• Keep your phone on stable WiFi
• Use pm2 or systemd to auto-restart OpenClaw
• Monitor logs for disconnection events

What You Can Do with WhatsApp

Once connected:

Chat with your AI:

• “What’s on my calendar today?”
• “Search for flights to London next month”
• “Draft an email to my team about the delay”

Get notifications:

• Urgent email alerts
• Calendar reminders
• Automation status updates

Control automations:

• “Pause my email monitoring”
• “Run the daily report now”
• “What automations are active?”

FAQ

Q: Does this violate WhatsApp ToS? A: OpenClaw uses WhatsApp Web protocol, similar to the official web app. It’s a gray area - use responsibly.

Q: Can I use a separate phone number? A: Yes! Many users get a second SIM for their AI agent.

Q: What if the QR code doesn’t appear? A: Check that OpenClaw is running and port 18789 is accessible.

Q: Can I connect multiple WhatsApp numbers? A: On StartClaw Pro/Enterprise, yes. Self-hosted requires multiple instances.

Q: Does my phone need to stay on? A: Your phone needs internet, but WhatsApp works with screen off.

Troubleshooting

QR Code Won’t Scan

• Ensure good lighting
• Hold phone steady
• Try regenerating the QR code

”WhatsApp Web is open elsewhere”

• Log out of all WhatsApp Web sessions on your phone
• Settings → Linked Devices → Log out all

Connection Keeps Dropping

• Check phone internet stability
• Self-hosted: Set up monitoring/auto-restart
• Consider StartClaw for reliable connections

The Reliable Way

WhatsApp integration is the #1 support request from self-hosters. The connection is finicky.

StartClaw maintains 99.7% WhatsApp uptime with automatic reconnection. Most users switch after fighting disconnections for a few weeks.

Try StartClaw Free - WhatsApp that actually stays connected.