Work in Progress: This troubleshooting guide may be incomplete or outdated.

📱 QR Code Won't Scan

WhatsApp QR code keeps expiring or won't work

← Back to Help

✅ Quick Checklist

Using Node.js (not Bun) - Bun has QR issues
Scan within 30 seconds - QR codes expire fast
Phone has internet - Check WiFi/data
Computer has internet - Check connection
Using latest WhatsApp - Update your app

Step-by-Step Fix

1. Make sure you're using Node.js

node --version

Should say v22.x.x or higher. If it says "bun" or nothing, install Node.js:

nvm install 22
nvm use 22

2. Generate a fresh QR code

clawdbot channels login

A new QR code will appear in your terminal.

3. Scan it FAST (within 30 seconds)

On your phone:

Open WhatsApp
Tap Settings (gear icon)
Tap Linked Devices
Tap Link a Device
Point camera at the QR code

4. Still not working? Try verbose mode

clawdbot channels login --verbose

This shows more details about what's happening.

iPhone Users: Make sure WhatsApp has camera permission in Settings → WhatsApp → Camera

Pro Tip: If QR keeps expiring, your internet might be slow. Try connecting to a different WiFi network.

Related Problems

Keeps Disconnecting

WhatsApp drops connection

Not Responding

Connected but no replies

Was this helpful?

Let us know if this fixed your problem

Thanks for the feedback! We use this to improve our guides.