Help Hub: Troubleshooting, Debugging, and Diagnostics for OpenClaw
Find quick solutions for common issues with OpenClaw. This hub links to troubleshooting guides, debugging tips, install sanity checks, and FAQs for day-to-day operations.
Read this when
- You are new and want a "what do I click/run" guide
- Something broke and you want the fastest path to a fix
Fastest way to get unstuck, by symptom:
- Troubleshooting - symptom-first decision tree
- Debugging - watch mode, raw streams, dev profile
- Install sanity - Node / npm / PATH checks
- Gateway troubleshooting - gateway-specific issues
- Doctor -
openclaw doctor: health checks, config migrations, repair steps
FAQ
- FAQ - day-to-day concepts and operational questions
- First-run FAQ - install, onboard, auth, subscriptions, early failures
- Models FAQ - model selection, failover, auth profiles
Diagnostics
- Environment variables - where OpenClaw loads env vars and precedence
- Diagnostics flags - runtime diagnostics and verbose modes
- Node + tsx crash - specific Node / tsx runtime crash scenarios
Testing
- Testing - test suites and Docker runners
- Update and plugin tests - package update, migration, and plugin install validation
- Live tests - network-touching provider and CLI smokes
Community and meta
- OpenClaw lore - the story
- Docs hubs - how this documentation is organized
- Docs directory - full file map