openclaw/docs/cli
Peter Steinberger 198e3b37b2
feat(onboard): browser-first guided handoff (#110054)
* feat(onboard): add browser-first guided handoff

* chore: drop release-only CHANGELOG edit from browser-handoff branch

* fix(onboard): make browser handoff reach the gateway on real installs

The presence probe connected as a raw shared-auth client with a possibly
SecretRef-managed token, which the gateway rejects as an unpaired Control UI
client ("device identity required"), so the handoff never fired and always
fell through to the terminal hatch. Read presence as a CLI-mode loopback client
(the trusted path every openclaw command uses) so operator.read is granted, and
share that one auth path between the reachability gate and the wait loop. Also
short-circuit when gateway.controlUi.enabled is false so onboarding does not open
a dead dashboard URL and block for the full timeout.

* fix(onboard): share resolved target between handoff gate and wait

The reachability preflight now resolves the same target (and shared secret) the
wait loop uses, and presents the configured secret to the CLI-mode presence
read. Known remaining limitation: on fresh quickstart gateways whose auth token
is written to config but resolved differently at runtime, the presence read is
rejected with a token mismatch and the handoff falls back to the terminal hatch.
Tracked for follow-up before enabling the browser handoff by default.

* docs(onboarding): mark phase 3 browser handoff as held with diagnosis

* docs(onboarding): phase 3 proven end-to-end; token-mismatch hold was a test artifact

* fix(onboard): satisfy docs-map and test-type gates for the handoff branch

* refactor(onboard): split guided manual stage
2026-07-17 18:57:57 +01:00
..
acp.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
agent.md fix(session): stop repeated restart recovery after retry budget (#96230) 2026-07-17 15:36:09 +01:00
agents.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
approvals.md docs(cli): clarify that exec-policy show and approvals get exclude per-session /exec overrides (#94999) 2026-07-11 02:58:37 -07:00
attach.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
audit.md feat: add metadata-only message audit events (#103903) 2026-07-11 13:14:08 -07:00
backup.md fix: state backups hang on dev-channel installs (#109090) 2026-07-16 08:56:31 -07:00
browser.md docs(browser): clarify JSON flag placement (#103155) 2026-07-12 06:58:40 +01: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 fix(commitments): keep heartbeats responsive with large queues (#105780) 2026-07-15 03:58:03 -07:00
completion.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
config.md fix(config): warn before stripping JSON5 comments on config write (#107604) 2026-07-14 21:39:18 -07:00
configure.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
crestodian.md feat(setup): rename Crestodian to OpenClaw system agent 2026-07-14 11:03:02 -07:00
cron.md refactor(cron): retire cron_run_logs; ledger-owned retention and cancellation 2026-07-13 11:41:27 -07:00
daemon.md fix(sqlite): reject runtimes vulnerable to WAL corruption (#106065) 2026-07-13 13:59:00 +08:00
dashboard.md feat: Linux desktop companion app with auto-install, Gateway lifecycle, and Control UI window (#106352) 2026-07-13 05:17:27 -07:00
devices.md feat(gateway): auto-approve node pairing via SSH device-key verification (#104180) 2026-07-10 22:23:10 -07:00
directory.md fix(whatsapp): add live group directory (#109886) 2026-07-17 11:12:07 +01: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 refactor: move MCP OAuth state to SQLite (#109844) 2026-07-17 12:15:16 +01:00
fleet.md docs(fleet): remove MVP framing 2026-07-13 17:56:18 -07:00
flows.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
gateway.md docs: document external gateway supervision 2026-07-16 17:01:39 +01: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(setup): rename Crestodian to OpenClaw system agent 2026-07-14 11:03:02 -07:00
infer.md fix(models): refresh bundled provider catalogs (#109410) 2026-07-16 16:47:25 -07:00
logs.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
mcp.md refactor: move MCP OAuth state to SQLite (#109844) 2026-07-17 12:15:16 +01:00
memory.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
message.md feat: add portable table presentation blocks (#103583) 2026-07-10 22:29:13 -07:00
migrate.md feat(onboarding): offer detected Claude Code/Codex/Hermes memory imports across CLI, macOS, and Linux onboarding (#108977) 2026-07-16 10:10:01 -07:00
models.md fix(openai): align auth availability with effective routes (#104685) 2026-07-11 15:26:48 -07:00
node.md refactor(node-host): move configuration to shared SQLite (#108457) 2026-07-15 14:02:23 -07:00
nodes.md fix(node-pairing): require operator.admin to approve fs.listDir nodes (#105936) (#106004) 2026-07-13 16:40:55 -05:00
onboard.md feat(onboard): browser-first guided handoff (#110054) 2026-07-17 18:57:57 +01:00
openclaw.md fix: prevent stale rescue approvals from executing (#108147) 2026-07-15 01:53:00 -07:00
pairing.md fix: prevent session exports from writing outside workspace (#104708) 2026-07-14 09:20:43 -07:00
path.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
plugins.md improve: warn before non-ClawHub plugin installs (#102197) 2026-07-15 03:25:36 +10:00
policy.md chore: migrate active GPT-5.5 references to GPT-5.6 (#104452) 2026-07-11 06:30:57 -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 feat(mobile): default pairing to full node access (#105928) 2026-07-13 02:30:45 -07:00
reset.md refactor: store workspace setup state in SQLite (#109147) 2026-07-16 10:28:36 -07: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 refactor: flip sessions and transcripts to sqlite storage (#98236) 2026-07-11 14:50:37 -07:00
sessions.md refactor(cron): retire cron_run_logs; ledger-owned retention and cancellation 2026-07-13 11:41:27 -07:00
setup.md feat: report Pi and OpenCode in guided setup (#109624) 2026-07-16 22:35:33 -07:00
skills.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
status.md fix(secrets): keep startup alive when TTS SecretRefs are missing (#101265) 2026-07-16 21:07:01 -07: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(onboarding): skip setup for configured gateways and require inference first (#102883) 2026-07-11 10:25:14 -07:00
uninstall.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
update.md fix(update): repair obsolete managed Gateway Node (#108668) 2026-07-16 00:41:43 -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 feat(memory-wiki): isolate vaults per agent (#103349) 2026-07-10 05:19:13 +01:00
workboard.md feat(workboard): add manual card movement surfaces (#96554) 2026-07-13 23:01:06 -07:00
worker.md feat(cloud-workers): session placement, dispatch, and worker turn routing (#106332) 2026-07-13 08:03:53 -07:00