Quick "get unstuck" path for the most common problems:
- Troubleshooting - symptom-first decision tree
- Debugging - watch mode, raw streams, dev profile
- Install sanity - Node / npm / PATH checks
- Gateway troubleshooting - gateway-specific issues
- Doctor - automated repair + diagnostic bundle
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