Troubleshooting

Quickly diagnose and fix Clawdbot runtime issues.

Quick Diagnostics

Run in order:

clawdbot status        # Basic check
clawdbot status --all  # Full diagnosis
clawdbot doctor        # Auto-fix
clawdbot logs --follow # Live logs

Common Issues

Authentication Issues

• Check API keys
• Re-authorize when OAuth token refresh fails

Configuration Issues

• Run clawdbot doctor for diagnosis
• Check JSON5 syntax

Network Issues

• Check port usage: lsof -i :18789
• Confirm gateway bind address

Channel Issues

• WhatsApp disconnects: Re-scan QR
• Discord not responding: Check Intent settings
• Telegram streaming issues: Check Bot permissions

Nuclear Reset

For complete reset:

rm -rf ~/.clawdbot
clawdbot setup

Note: This deletes all configuration, requiring channel re-pairing.

Get Help

• View logs: clawdbot logs
• GitHub Issues (opens in a new tab)