Troubleshooting
Find the failing layer before changing config.
Start with the symptom, run the diagnostic command, compare good output vs bad output, then apply the smallest fix.
dashboard Med severity
Fix: OpenClaw Dashboard Not Opening
Step-by-step diagnosis and fix for when the OpenClaw dashboard refuses to load. Covers SSH tunnels, Gateway binding, and firewall issues.
View fix
gateway High severity
Fix: Gateway Not Running
Step-by-step diagnosis for Gateway crashes. Covers port conflicts, Node.js version issues, permission errors, and PM2 background failures.
View fix
node Med severity
Fix OpenClaw Node Version Too Old
Check your Node.js version, shell path, service path, and VPS runtime before reinstalling OpenClaw or changing Gateway access.
View fix
telegram Med severity
Fix Telegram Bot Not Replying in OpenClaw
Check bot token, pairing, allowlist, dmPolicy, Gateway status, and logs without weakening access controls unnecessarily.
View fix