Skip to main content

​
Troubleshooting

​
First 60 seconds

Run these in order: 
clawdbot status
clawdbot status --all
clawdbot daemon status
clawdbot logs --follow
clawdbot doctor
If the gateway is reachable, deep probes: 
clawdbot status --deep

​
Common “it broke” cases

​
clawdbot: command not found

Almost always a Node/npm PATH issue. Start here:

​
Gateway “unauthorized”, can’t connect, or keeps reconnecting

​
Daemon says running, but RPC probe fails

​
Model/auth failures (rate limit, billing, “all models failed”)

​
When filing an issue

Paste a safe report: 
clawdbot status --all
If you can, include the relevant log tail from clawdbot logs --follow.