Back to issues
High priorityTested by MilanVerified fix

WhatsApp QR Code Not Scanning

The QR code displays in terminal but scanning it with WhatsApp gives 'Not Valid' or the connection drops immediately.

Likely Cause

Baileys session mismatch — your local auth_info_multi folder is out of sync with WhatsApp's servers.

Tags

WhatsAppAuth

Recovery Steps

  1. 1Stop OpenClaw completely (Ctrl+C or kill the process).
  2. 2Delete the auth_info_multi folder in your project root.
  3. 3Run openclaw start so a fresh QR can generate.
  4. 4Scan within 60 seconds before it expires.
  5. 5Avoid switching networks or devices mid-scan.

Still blocked?

If the steps above do not clear it, review the full fixes index or book direct troubleshooting help.