Help

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