---
summary: "Help hub: common fixes, install sanity, and where to look when something breaks"
read_when:
  - You are new and want a "what do I click/run" guide
  - Something broke and you want the fastest path to a fix
title: "Help"
---

Quick "get unstuck" path for the most common problems:

- [Troubleshooting](/help/troubleshooting) — symptom-first decision tree
- [Debugging](/help/debugging) — watch mode, raw streams, dev profile
- [Install sanity](/install/node#troubleshooting) — Node / npm / PATH checks
- [Gateway troubleshooting](/gateway/troubleshooting) — gateway-specific issues
- [Doctor](/gateway/doctor) — automated repair + diagnostic bundle

## FAQ

- [FAQ](/help/faq) — day-to-day concepts and operational questions
- [First-run FAQ](/help/faq-first-run) — install, onboard, auth, subscriptions, early failures
- [Models FAQ](/help/faq-models) — model selection, failover, auth profiles

## Diagnostics

- [Environment variables](/help/environment) — where OpenClaw loads env vars and precedence
- [Diagnostics flags](/diagnostics/flags) — runtime diagnostics and verbose modes
- [Node + tsx crash](/debug/node-issue) — specific Node / tsx runtime crash scenarios

## Testing

- [Testing](/help/testing) — test suites and Docker runners
- [Update and plugin tests](/help/testing-updates-plugins) — package update, migration, and plugin install validation
- [Live tests](/help/testing-live) — network-touching provider and CLI smokes

## Community and meta

- [OpenClaw lore](/start/lore) — the story
- [Docs hubs](/start/hubs) — how this documentation is organized
- [Docs directory](/start/docs-directory) — full file map