fix(installer): complete first-run onboarding (#101901)

* fix(installer): complete first-run onboarding

* docs(installer): document finalization paths

* fix(installer): honor verify without tty

* fix(installer): align config finalization
This commit is contained in:
Jason (Json) 2026-07-07 18:23:56 -06:00 committed by GitHub
parent 23cf16a7d5
commit 2fbd4cdcba
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
3 changed files with 468 additions and 141 deletions

View file

@ -85,10 +85,10 @@ Recommended for most interactive installs on macOS/Linux/WSL.
</Step>
<Step title="Post-install tasks">
- Refreshes a loaded gateway service best-effort (`openclaw gateway install --force`, then restart)
- Runs `openclaw doctor --non-interactive` on upgrades and git installs (best effort)
- Attempts onboarding when appropriate (TTY available, onboarding not disabled, and bootstrap/config checks pass)
- Runs a post-install smoke verify when `--verify` is set
- Resolves the just-installed `openclaw` binary for follow-up commands
- For an unconfigured install, starts onboarding before doctor or gateway probes. With `--no-onboard` or no TTY, it prints the command to finish setup later.
- For a configured install, refreshes and restarts a loaded gateway service best-effort and runs doctor. Upgrades update plugins when possible, or print the manual command in a headless prompt-enabled run.
- When `--verify` runs, it checks the installed version and checks gateway health only after configuration exists.
</Step>
</Steps>