Troubleshooting Whatsapp Login Fails

Fixing WhatsApp Login Issues

WhatsApp connections can fail for several reasons. This guide covers the most common login failures and their solutions.

QR Code Not Appearing

Cause: The WhatsApp Web connector cannot initialize.

Fix:

1. Delete the session cache: rm -rf ~/.openclaw/channels/whatsapp/session/
2. Restart the channel: openclaw channel restart whatsapp
3. A fresh QR code should appear — scan it quickly (within 60 seconds)

Session Keeps Disconnecting

Cause: WhatsApp detected multiple active sessions or the phone lost internet.

Fix:

• Ensure the phone is connected to stable Wi-Fi
• Disable battery optimization for WhatsApp on the phone
• Open WhatsApp on the phone periodically to keep the session active
• Enable autoReconnect: true in your channel configuration

Account Banned / Restricted

Cause: WhatsApp detected automated behavior or spam-like patterns.

Prevention:

• Use a legitimate phone number with a real WhatsApp account
• Do not send bulk messages or contact unknown numbers
• Keep message frequency within normal human patterns
• Use WhatsApp Business for bot-like interactions

Multi-Device Issues

WhatsApp limits the number of linked devices. If you reach the limit, unlink old devices from WhatsApp Settings > Linked Devices before connecting OpenClaw.