openclaw/docs/help
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
..
debugging.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
environment.md docs: align source contract wording (#100186) 2026-07-05 01:41:40 -04:00
faq-first-run.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
faq-models.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
faq.md fix(auto-reply): stop treating wait as abort trigger (#98639) 2026-07-07 03:03:23 +01:00
index.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
scripts.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
testing-live.md docs: restore source-backed contract details (#100182) 2026-07-05 01:26:25 -04:00
testing-updates-plugins.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
testing.md refactor(qa): add canonical live channel adapters (#99707) 2026-07-06 09:24:34 -07:00
troubleshooting.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00