openclaw/docs/cli
Peter Steinberger 1b3f38e7e4
fix: avoid false Gateway failures during cold starts (#153063)
Avoid false Gateway timeout and unreachable reports during slow cold starts. Doctor, health, and status diagnostics now reuse the existing readiness owner and one monotonic deadline, preserve observed startup progress, and leave a Gateway that is still starting alone. Remove Doctor's duplicate restart polling loop.

Provider usage consumes the remaining allowance, reports Timeout before dispatch when exhausted, and cancels active usage work on expiry. Preserve explicit timeouts, target/auth selection, and real process/version/build failures.

Health and channel-status JSON can return a documented non-failing starting payload; consumers that need a complete snapshot must distinguish it and rerun after startup. No new configuration, flags, dependencies, or stored-data migration.

Validation: 592 cases across 37 files on isolated Linux Testbox; installed-package cold-start/down-Gateway matrix and unmodified 2026.9.5 updater-to-candidate Doctor proof; focused command/transport regressions and changed-file gates. The existing independent review is scoped-clean, and ClawSweeper reports no actionable correctness finding.

Thanks to @Suidge for the report and startup measurements.

Fixes #152970.
2026-09-19 23:53:35 -07:00
..
doctor fix: avoid false Gateway failures during cold starts (#153063) 2026-09-19 23:53:35 -07:00
gateway fix(daemon): preserve LaunchAgent rollback bytes and modes (#152195) 2026-09-18 17:53:06 -07:00
mcp fix(mcp): stop unused servers from accumulating across sessions (#150364) 2026-09-17 00:45:31 -07:00
plugins fix(gateway): keep the previous plugin generation serving when a replacement stalls on admitted work (#151273) 2026-09-18 12:52:09 -07:00
policy fix: skip official setup approvals and default to Astra (#145646) 2026-09-12 00:34:25 -07:00
update fix: restart Gateway after manual package replacement (#153078) 2026-09-19 20:26:20 -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
attach.md
audit.md
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: avoid false Gateway failures during cold starts (#153063) 2026-09-19 23:53:35 -07:00
clawbot.md
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
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): keep acknowledged manual runs durable across restart (#153360) 2026-09-19 23:00:58 -07:00
daemon.md fix(gateway): support pinned daemon runtime paths (#82290) 2026-09-16 21:20:21 -06:00
dashboard.md
devices.md fix: reject agent Cron calls after caller revocation (#150921) 2026-09-17 16:21:59 +01:00
directory.md
dns.md
docs.md fix(docs): reject malformed search result collections (#145613) 2026-09-12 00:20:46 -07:00
doctor.md
file-transfer.md
fleet.md feat(fleet): show the recorded container runtime in status (#144691) 2026-09-19 17:54:21 +01:00
gateway.md
health.md fix: avoid false Gateway failures during cold starts (#153063) 2026-09-19 23:53:35 -07:00
hooks.md
index.md
infer.md docs(providers): expand llmman guidance and add hybrid inference (#139606) 2026-09-19 10:07:03 -07:00
logs.md
mcp.md
memory.md fix(memory): retain forget lineage through writer admission (#152902) 2026-09-19 07:43:49 -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: read and edit agent documents on a paired node (#150734) 2026-09-18 23:23:25 -07:00
nodes.md fix: restore Mac presence context and Canvas media playback (#153381) 2026-09-19 21:37:59 -07: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
path.md
plugins.md feat(plugins): manage multiple plugins in one CLI command (#149910) 2026-09-16 04:10:52 -07:00
policy.md
promos.md
proxy.md
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
resume.md
sandbox.md
secrets.md fix(secrets): recover Gateway tokens corrupted by redacted saves (#151250) 2026-09-18 11:56:28 -07: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 fix(onboard): show explicit repair command for invalid config (#130035) 2026-09-18 15:04:10 -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: avoid false Gateway failures during cold starts (#153063) 2026-09-19 23:53:35 -07:00
system.md
tasks.md
transcripts.md fix(meetings): load full transcripts and generate missing summaries (#152463) 2026-09-19 00:36:34 -07:00
triage.md feat(triage): add Kimi Code and Qwen Code handoffs (#149877) 2026-09-16 01:49:16 -07:00
tui.md
uninstall.md
update.md fix(update): let finalization finish without an implicit deadline (#153085) 2026-09-19 14:26:19 -06:00
voicecall.md docs(plugins): remove obsolete Gateway restart guidance (#146516) 2026-09-12 16:48:13 -07:00
webhooks.md
wiki.md
workboard.md fix(workboard): preserve ready-card history on idle dispatch (#149160) 2026-09-15 20:46:50 +05:30
worker.md fix(nodes): finish worker cleanup when stopping environments (#152896) 2026-09-19 07:48:36 -07:00