openclaw/docs/cli
Peter Steinberger e2a112a556
feat(onboard): guided CLI onboarding with live AI verification and classic fallback (#101880)
* feat(onboard): guided CLI onboarding with live AI verification and classic fallback

Interactive `openclaw onboard` (and bare `openclaw` on a fresh install) now
runs a guided flow with macOS-app parity: detect existing AI access, live-test
candidates with a real completion before persisting anything, walk down the
ladder on failure with mapped reasons, and offer verified manual API-key entry
from installed provider manifests (masked input). In-flow escapes: classic
wizard, Crestodian chat, skip-AI. Classic wizard gains an optional post-auth
live verification step. `--classic`, `--modern`, and `--non-interactive`
contracts unchanged. Docs corrected for post-#99935 routing.

Closes #101851

* improve(onboard): quiet probe diagnostics in wizard TTY, carry risk ack into classic escape

Candidate live-tests during guided setup are probes: rename their run id and
lane to the existing probe conventions (logging/subsystem.ts console
suppression, command-queue quiet probe lanes) so expected failures stop
leaking raw diagnostics into the Clack UI; file diagnostics unchanged. The
classic-wizard escape now passes the already-collected risk acknowledgement
through instead of re-prompting in the same session.

* fix(onboard): quiet the session-derived setup-inference probe lane too

The live-test run enqueues on two lanes: the explicit probe lane and one
derived from its temp session key. Extend the shared quiet-probe predicate to
cover the derived lane so a failing candidate cannot leak lane-task
diagnostics into the wizard TTY.

* improve(onboard): suppress subsystem console output during wizard live tests

Provider-transport subsystem loggers (model-fetch start/response, transport
errors) carry no run id, so probe suppression cannot catch them and a failing
candidate printed raw log lines into the Clack TTY. Reuse the TUI console
subsystem-filter seam via a finally-safe scoped helper around guided
activation and the classic live-verify; file logging is unchanged and the
gateway (macOS app) surface is unaffected.

* fix(onboard): never auto-replace a configured model when its live check fails

The re-run verification probe executes outside the configured workspace (setup
never runs workspace plugins), so a workspace-backed current model can fail
the check while working fine in the agent. Stop the auto ladder on an
existing-model failure and hand the decision to the manual stage instead of
silently persisting a different candidate as the default. Docs note the
fail-safe and the workspace caveat.

* feat(onboard): two-way switching between Crestodian chat and the menu wizards

From the chat, `open setup wizard`, `open classic wizard`, and `open channel
wizard for <channel>` hand off to the guided flow, the classic wizard, or the
masked `channels add` wizard after the chat TUI tears down (mirrors the
open-tui handoff; gateway surface gets a text pointer instead). The hosted
channel wizard no longer dead-ends at sensitive steps — it offers the switch
and remembers the channel. New read-only `channel info <channel>` operation
and ring-zero action surface label, blurb, configured state, and the real
docs URL from channel-setup discovery so the assistant can explain Slack or
Telegram prerequisites instead of guessing; both prompts instruct it to use
them. `channels add --channel <id>` now preselects the channel. Docs cover
the interchangeable flows.

* fix(onboard): avoid param reassignment in open-setup handoff

* improve(onboard): separate ask-about vs connect intent in channel prompt guidance

Live test showed the agent detouring an explicit connect request through
channel_info because the guidance said to consult it first. Both prompts now
distinguish asking about a channel (channel info + docs link) from asking to
connect (connect right away).

* fix(channels): mark channel token entry as sensitive input

The shared single-token prompt lacked sensitive:true, so terminal wizards
echoed pasted channel tokens and the Crestodian chat bridge (which refuses
plain-text secrets based on this flag) hosted the Telegram token step in
visible chat. Found live-testing the chat-to-wizard switch; pre-existing on
main but load-bearing for the masked-wizard contract this PR documents.

* fix(onboard): restore terminal state around the guided flow's TUI launch

Mirror the classic finalize handoff so the chat TUI never inherits the wizard
prompter's raw/paused terminal state on the default first-run path.

* fix(channels): type the token prompter mock for the sensitive-flag assertion

* fix(gateway): map the TUI-only open-setup action to none for app clients

Engine-side surface gating already prevents open-setup replies on the gateway
surface; this keeps the client-visible action enum stable even if that gate
ever regresses. (Reviewed with the switching round; missed in its commit.)

* docs: regenerate docs map for onboarding page changes
2026-07-09 12:40:55 +01:00
..
acp.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
agent.md fix(agent): preserve explicit recipient sessions (#101507) 2026-07-07 10:07:13 +01:00
agents.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
approvals.md fix(gateway): support native Windows exec approvals (#101669) 2026-07-07 14:50:59 +01:00
attach.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
audit.md feat: correlate native search outcomes in audit history (#98704) 2026-07-06 12:30:12 +01:00
backup.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
browser.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
channels.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
clawbot.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
commitments.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
completion.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
config.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
configure.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
crestodian.md feat(onboard): guided CLI onboarding with live AI verification and classic fallback (#101880) 2026-07-09 12:40:55 +01:00
cron.md improve(cron): show consecutive failure count and last error in cron CLI output (#99602) 2026-07-06 01:44:51 -07:00
daemon.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
dashboard.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
devices.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
directory.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
dns.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
docs.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
doctor.md Fix container image upgrade migrations before gateway readiness (#101881) 2026-07-08 14:19:05 -04:00
flows.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
gateway.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
health.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
hooks.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
index.md feat(cli): add openclaw promos to discover and claim ClawHub promotional model offers (#100236) 2026-07-07 01:10:42 -06:00
infer.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
logs.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
mcp.md docs: update Control UI MCP settings route 2026-07-07 16:53:48 +01:00
memory.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
message.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
migrate.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
models.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
node.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
nodes.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
onboard.md feat(onboard): guided CLI onboarding with live AI verification and classic fallback (#101880) 2026-07-09 12:40:55 +01:00
pairing.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
path.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
plugins.md feat: publish plugins with extended-stable releases (#100448) 2026-07-05 16:16:26 -07:00
policy.md policy: preview review-required gateway repairs (#99776) 2026-07-08 10:44:56 -07:00
promos.md feat(cli): add openclaw promos to discover and claim ClawHub promotional model offers (#100236) 2026-07-07 01:10:42 -06:00
proxy.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
qr.md fix(pairing): advertise reachable Tailnet routes (#100317) 2026-07-05 07:43:43 -07:00
reset.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
sandbox.md fix: land ten small reliability fixes (#100483) 2026-07-06 00:08:51 +01:00
secrets.md Add Vault SecretRef plugin (#89255) 2026-07-09 05:30:12 -05:00
security.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
sessions.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
setup.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
skills.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
status.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
system.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
tasks.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
transcripts.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
tui.md fix(tui): follow active gateway port (#73338) 2026-07-06 05:27:35 +01:00
uninstall.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
update.md feat(update): notify extended-stable availability (#100438) 2026-07-06 19:57:03 -07:00
voicecall.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
webhooks.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
wiki.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
workboard.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00