openclaw/docs/start
Peter Steinberger 21d919deb8
fix(onboard): keep the wizard alive through provider auth failures and polish standalone install UX (#100632)
Fixes rough edges in the standalone install flow (install.sh -> openclaw onboard), found and verified by running the flow in a clean container and on a clean macOS Tahoe VM:

- Provider auth setup failures (e.g. the preselected "Anthropic Claude CLI" option on a host without a Claude CLI login) no longer kill the whole wizard. The interactive wizard notes the error and returns to the provider picker; explicit --auth-choice automation still fails fast.
- Onboarding config now persists before the channel/search/skills steps, so a crash or cancel during channel pairing no longer loses auth + gateway decisions.
- With model auth skipped, finalize no longer auto-sends the "Wake up, my friend!" message (which always failed with a provider auth error). The hatch seed is gated on usable model credentials and a "Model auth missing" note explains the next step.
- Search provider picker no longer labels non-key credentials (e.g. SearXNG base URL) as "API key required".
- install.sh no longer warns "PATH missing npm global bin dir" with manual fix steps after it already persisted the export line; it reports the PATH was updated and how to reload the current shell.
- Removed the dead interactive hooks onboarding step (setupInternalHooks); quickstart enables default hooks silently.

Verified live per fix in a clean Debian/Node 24 container and on a clean macOS 26.5 Parallels VM (wizard re-prompt, SearXNG label), plus wizard/onboard test suites and tsgo:core.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
2026-07-07 04:11:23 +01:00
..
bootstrapping.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
docs-directory.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
getting-started.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
hubs.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
lore.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
onboarding-overview.md feat: verify AI access during macOS onboarding before the first chat (#100288) 2026-07-05 06:59:30 -07:00
onboarding.md feat(macos): load provider catalog during AI onboarding (#101132) 2026-07-06 20:57:56 +01:00
openclaw.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
quickstart.md
setup.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
showcase.md docs: add X-verified builds and devtools to showcase 2026-07-06 08:16:12 -07:00
wizard-cli-automation.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
wizard-cli-reference.md fix(onboard): keep the wizard alive through provider auth failures and polish standalone install UX (#100632) 2026-07-07 04:11:23 +01:00
wizard.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00