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