openclaw/docs/cli
Peter Steinberger dc425bdacf
fix(update): explain target metadata preflight failures (#151649)
Preserve detected npm, pnpm, Bun, and Git modes when update target metadata cannot be inspected. Validate installation identity before target lookup and carry typed failure reasons and recovery commands through terminal summaries, JSON, update history, and bounded public reports using the existing admission and reporting owners.

Unowned installations remain successful skips without package replacement or Gateway restart. Homebrew retains its typed skip and brew guidance. Public reports retain fixed descriptions and next steps without local paths or raw registry responses. No options, dependencies, or database schemas change.

This repairs the candidate updater's diagnostics; an installed updater that refuses before staging cannot receive this fix, and the reporter's underlying metadata failure remains unidentified. Related: #151589. Thanks to @Nsikak1 for the bounded update failure report.

Validation: exact-head CI run 35355091194 passed at 6f179ca22d19a398c6172443077e5f2e886b95c8 with zero pending checks; committed-branch Codex review was scoped-clean and ClawSweeper found no actionable findings. Recorded Linux Testbox compatibility proof covered eight installation shapes per driver, including 12 successful package updates, Git previews, and Homebrew Cellar/opt skips. Fifty focused tests and complete Linux changed-file checks passed.
2026-09-18 08:39:02 -07:00
..
doctor fix: restore healthy Gateways after legacy updates (#151682) 2026-09-18 05:34:31 -07:00
gateway fix(cli): prevent agent shell reports from appearing as human input (#150499) 2026-09-17 23:32:34 -07:00
mcp fix(mcp): stop unused servers from accumulating across sessions (#150364) 2026-09-17 00:45:31 -07:00
plugins fix(cli): avoid duplicate catalog version prefixes (#145975) 2026-09-17 18:26:18 -07:00
policy fix: skip official setup approvals and default to Astra (#145646) 2026-09-12 00:34:25 -07:00
update fix(update): restore Gateway and clear stale warnings after repair (#151003) 2026-09-17 16:36:11 -07:00
acp.md fix: stop ACP client when terminal input closes (#148611) 2026-09-14 19:20:13 -07:00
agent.md fix(cli): prevent agent shell reports from appearing as human input (#150499) 2026-09-17 23:32:34 -07:00
agents.md fix: Ask OpenClaw drops requested agent display names (#151449) 2026-09-17 23:40:46 -07:00
approvals.md docs: fix 16 secops-owned audit findings across gateway, cli, and security pages (#144030) 2026-09-10 20:28:21 +08:00
attach.md feat(talk): support native realtime for thin audio clients (#134003) 2026-09-03 21:51:49 -07:00
audit.md docs: correct verified accuracy defects in CLI, tools, and automation pages (#143179) 2026-09-09 23:57:06 +09:00
backup.md fix(doctor): quarantine changed audit archives and continue repairs (#150425) 2026-09-16 21:33:09 -07:00
browser.md feat(browser): expose native extension tab IDs (#138338) 2026-09-17 12:59:20 -07:00
channels.md fix(gateway): stop endless thaw recovery on busy gateways (#149369) 2026-09-15 20:56:51 -07:00
clawbot.md docs: correct verified accuracy defects in CLI, tools, and automation pages (#143179) 2026-09-09 23:57:06 +09:00
claws.md feat(claws): activate plugin requirement batches without restarting (#145713) 2026-09-12 02:23:43 -07:00
completion.md fix(cli): stop Bash flag completion after the option terminator (#149678) 2026-09-16 22:00:11 +05:30
config.md fix(config): preserve session-store owners on unrelated writes (#151468) 2026-09-18 00:52:02 -07:00
configure.md docs: STE structural cleanup for gateway, cli and concepts (46 audit findings) (#143931) 2026-09-10 18:50:32 +08:00
connect.md feat: share selected sessions read-only with a paired team Gateway (#136253) 2026-09-12 13:35:17 -07:00
cron.md fix(cron): reject blank automation working directories (#129714) 2026-09-18 07:26:34 -07:00
daemon.md fix(gateway): support pinned daemon runtime paths (#82290) 2026-09-16 21:20:21 -06:00
dashboard.md fix: preserve dashboard HTTP errors when diagnostics fail (#145227) 2026-09-11 13:46:03 -07:00
devices.md fix: reject agent Cron calls after caller revocation (#150921) 2026-09-17 16:21:59 +01:00
directory.md docs: STE structural cleanup for gateway, cli and concepts (46 audit findings) (#143931) 2026-09-10 18:50:32 +08:00
dns.md docs: fix 20 link defects confirmed live in the verified backlog (#144133) 2026-09-11 03:48:10 +08:00
docs.md fix(docs): reject malformed search result collections (#145613) 2026-09-12 00:20:46 -07:00
doctor.md docs: close remaining one-way link findings in cli, plugins, tools, providers (#143855) 2026-09-10 16:15:08 +08:00
file-transfer.md docs: close the small audit categories (generated, governance, link, split) (#144029) 2026-09-10 21:52:03 +08:00
fleet.md feat(fleet): show log timestamps (#132554) 2026-09-10 17:54:19 -07:00
gateway.md docs(gateway): warn that installation starts the service (#139562) 2026-09-10 17:23:20 +05:30
health.md docs: STE structural cleanup for gateway, cli and concepts (46 audit findings) (#143931) 2026-09-10 18:50:32 +08:00
hooks.md docs: STE pass on terminology consistency and run-on sentences (#143770) 2026-09-10 15:51:49 +09:00
index.md docs: fix 20 link defects confirmed live in the verified backlog (#144133) 2026-09-11 03:48:10 +08:00
infer.md fix(audio): honor discovered transcription executable paths (#148270) 2026-09-14 14:51:05 -07:00
logs.md fix(cli): reject explicitly blank Gateway ports (#139613) 2026-09-06 06:47:43 -07:00
mcp.md docs: fix one-way and absolute links across cli, tools, gateway, and channels (#143157) 2026-09-10 07:40:16 +09:00
memory.md fix(memory): keep reindex cleanup from blocking Gateway callbacks (#148230) 2026-09-14 18:26:42 -07:00
message.md fix(cli): honor Teams message search targets and limits (#149353) 2026-09-16 06:57:08 +05:30
migrate.md fix(codex): preserve selected account failures (#151831) 2026-09-18 07:45:35 -07:00
models.md fix(cli): report retained model catalog refresh failures (#148084) 2026-09-14 16:22:53 +05:30
node.md feat: automatically update idle headless nodes (#151545) 2026-09-18 06:20:27 -07:00
nodes.md docs: STE structural cleanup for gateway, cli and concepts (46 audit findings) (#143931) 2026-09-10 18:50:32 +08:00
onboard.md feat(onboarding): add Apple on-device setup and utility model (#150376) 2026-09-16 20:53:06 -07:00
openclaw.md fix: guide model provider setup through protected Settings (#150800) 2026-09-17 17:03:18 +05:30
pairing.md docs: STE structural cleanup for gateway, cli and concepts (46 audit findings) (#143931) 2026-09-10 18:50:32 +08:00
path.md docs: fix checkable ux defects in docs/cli and docs/concepts (#143927) 2026-09-10 18:39:20 +08:00
plugins.md feat(plugins): manage multiple plugins in one CLI command (#149910) 2026-09-16 04:10:52 -07:00
policy.md docs: close remaining one-way link findings in cli, plugins, tools, providers (#143855) 2026-09-10 16:15:08 +08:00
promos.md docs: fix one-way and absolute links across cli, tools, gateway, and channels (#143157) 2026-09-10 07:40:16 +09:00
proxy.md docs: STE structural cleanup for gateway, cli and concepts (46 audit findings) (#143931) 2026-09-10 18:50:32 +08:00
qr.md fix(pairing): QR setup rejects trusted-proxy gateways without a shared secret (#147036) 2026-09-13 21:36:05 +08:00
reset.md docs: STE structural cleanup for gateway, cli and concepts (46 audit findings) (#143931) 2026-09-10 18:50:32 +08:00
resume.md feat: continue web sessions in the terminal (#122870) 2026-08-12 17:07:48 -07:00
sandbox.md docs: fix 16 secops-owned audit findings across gateway, cli, and security pages (#144030) 2026-09-10 20:28:21 +08:00
secrets.md docs: fix 16 secops-owned audit findings across gateway, cli, and security pages (#144030) 2026-09-10 20:28:21 +08:00
security.md fix: bound filesystem reads and keep sandbox reads responsive (#146654) 2026-09-12 19:41:19 -07:00
sessions.md fix(sessions): reuse canonical token count formatting (#117517) 2026-09-16 20:10:52 -07:00
setup.md feat(agents): add role templates and a team preset for onboarding (#145712) 2026-09-12 00:07:12 -07:00
skills.md fix(skills): restore usage counts and current Workshop inventory (#151048) 2026-09-18 12:17:09 +05:30
status.md fix(status): make online JSON status responsive on large fleets (#150269) 2026-09-16 13:56:47 -07:00
system.md docs(cli): document system Gateway port and password options (#139071) 2026-09-10 16:01:11 +05:30
tasks.md docs: fix checkable ux defects in docs/cli and docs/concepts (#143927) 2026-09-10 18:39:20 +08:00
transcripts.md fix(meetings): make saved notes readable and searchable (#145367) 2026-09-11 16:25:07 -07:00
triage.md feat(triage): add Kimi Code and Qwen Code handoffs (#149877) 2026-09-16 01:49:16 -07:00
tui.md docs: close remaining one-way link findings in cli, plugins, tools, providers (#143855) 2026-09-10 16:15:08 +08:00
uninstall.md docs: fix one-way and absolute links across cli, tools, gateway, and channels (#143157) 2026-09-10 07:40:16 +09:00
update.md fix(update): explain target metadata preflight failures (#151649) 2026-09-18 08:39:02 -07:00
voicecall.md docs(plugins): remove obsolete Gateway restart guidance (#146516) 2026-09-12 16:48:13 -07:00
webhooks.md docs: STE pass on terminology consistency and run-on sentences (#143770) 2026-09-10 15:51:49 +09:00
wiki.md fix(memory-wiki): bound exact page reads (#129897) 2026-09-04 22:05:24 -07:00
workboard.md fix(workboard): preserve ready-card history on idle dispatch (#149160) 2026-09-15 20:46:50 +05:30
worker.md docs: fix checkable ux defects in docs/cli and docs/concepts (#143927) 2026-09-10 18:39:20 +08:00