From 819192016eaeefc0f25f6c3118fd9953294805d2 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Wed, 22 Apr 2026 22:36:41 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@7b2c9a6fa3d3d1c79e6e6f0574efffc71cdfc9d6 --- .openclaw-sync/source.json | 4 ++-- docs/gateway/configuration.md | 3 +++ docs/gateway/troubleshooting.md | 1 + 3 files changed, 6 insertions(+), 2 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index ea1215561..b6f8f3166 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "22814c1addb94a42c510db39afe4ee670a0deab5", - "syncedAt": "2026-04-22T22:24:43.358Z" + "sha": "7b2c9a6fa3d3d1c79e6e6f0574efffc71cdfc9d6", + "syncedAt": "2026-04-22T22:36:40.568Z" } diff --git a/docs/gateway/configuration.md b/docs/gateway/configuration.md index e68a2b51e..7b6409652 100644 --- a/docs/gateway/configuration.md +++ b/docs/gateway/configuration.md @@ -100,6 +100,9 @@ The Gateway also keeps a trusted last-known-good copy after a successful startup `openclaw.json` is later changed outside OpenClaw and no longer validates, startup and hot reload preserve the broken file as a timestamped `.clobbered.*` snapshot, restore the last-known-good copy, and log a loud warning with the recovery reason. +Startup read recovery also treats sharp size drops, missing config metadata, and a +missing `gateway.mode` as critical clobber signatures when the last-known-good +copy had those fields. If a status/log line is accidentally prepended before an otherwise valid JSON config, gateway startup and `openclaw doctor --fix` can strip the prefix, preserve the polluted file as `.clobbered.*`, and continue with the recovered diff --git a/docs/gateway/troubleshooting.md b/docs/gateway/troubleshooting.md index de864780a..820f769af 100644 --- a/docs/gateway/troubleshooting.md +++ b/docs/gateway/troubleshooting.md @@ -303,6 +303,7 @@ Common signatures: - `.clobbered.*` exists → an external direct edit or startup read was restored. - `.rejected.*` exists → an OpenClaw-owned config write failed schema or clobber checks before commit. - `Config write rejected:` → the write tried to drop required shape, shrink the file sharply, or persist invalid config. +- `missing-meta-vs-last-good`, `gateway-mode-missing-vs-last-good`, or `size-drop-vs-last-good:*` → startup treated the current file as clobbered because it lost fields or size compared with the last-known-good backup. - `Config last-known-good promotion skipped` → the candidate contained redacted secret placeholders such as `***`. Fix options: