Work in Progress: This guide is being actively developed.

What's Wrong?

Click your problem. Get the fix.

Install Problems WhatsApp Issues Not Working How Do I...

🔥 Most Common Problems

❌

"command not found: clawdbot"

ClawdBot installed but terminal can't find it
📱

QR Code Won't Scan

WhatsApp QR keeps expiring or won't work
😶

ClawdBot Not Responding

I send messages but nothing happens

📥 I Can't Install It

🔍

"command not found"

Terminal says clawdbot doesn't exist

Fix this →
⚠️

Node.js Version Error

Says I need Node 22 or higher

Fix this →
🔒

Permission Denied

Can't install because of permissions

Fix this →
🪟

Windows Install Failed

Doesn't work on Windows

Fix this →

💬 WhatsApp Problems

📷

QR Code Won't Scan

QR expires or doesn't work

Fix this →
📴

Keeps Disconnecting

WhatsApp disconnects randomly

Fix this →
😶

Not Responding

Messages sent but no reply

Fix this →
🚫

Will I Get Banned?

Worried about WhatsApp ban

Learn more →

💔 It's Not Working

🚫

Gateway Won't Start

Error when starting gateway

Fix this →
🔑

Invalid API Key

API key error message

Fix this →
⏱️

Rate Limit Error

Too many requests error

Fix this →
💳

No Credits Left

Out of API credits

Fix this →
🐢

Super Slow

Takes forever to respond

Fix this →
🧠

Using Too Much Memory

Computer running slow

Fix this →

🤔 How Do I...

🚀

Get Started?

I'm brand new to ClawdBot

Start here →
💬

Connect WhatsApp?

Link my WhatsApp account

Show me →
✈️

Connect Telegram?

Create a Telegram bot

Show me →
🔑

Get an API Key?

Where to get Claude/GPT key

Show me →
☁️

Run It 24/7?

Keep it running all the time

Show me →
🧩

Add More Features?

Install skills and plugins

Show me →

Still Stuck?

Run this command and share the output when asking for help:

clawdbot status --all
Ask on Discord GitHub Issues