From 28daf9c1f281e37292ca64b90fcae7f4942daeb3 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Wed, 22 Apr 2026 22:55:41 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@ac8495adaa563735e0f8b8d1b1fb2f3257ac9b80 --- .openclaw-sync/source.json | 4 ++-- docs/gateway/configuration-reference.md | 2 ++ docs/gateway/configuration.md | 6 ++++++ 3 files changed, 10 insertions(+), 2 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index b829fc1e6..37b4db235 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "c87c9742eddf7a432d6a1b18fbc957280626bff0", - "syncedAt": "2026-04-22T22:47:34.225Z" + "sha": "ac8495adaa563735e0f8b8d1b1fb2f3257ac9b80", + "syncedAt": "2026-04-22T22:55:40.910Z" } diff --git a/docs/gateway/configuration-reference.md b/docs/gateway/configuration-reference.md index f5630c63b..eb55aded9 100644 --- a/docs/gateway/configuration-reference.md +++ b/docs/gateway/configuration-reference.md @@ -3903,6 +3903,8 @@ Split config into multiple files: - Sibling keys: merged after includes (override included values). - Nested includes: up to 10 levels deep. - Paths: resolved relative to the including file, but must stay inside the top-level config directory (`dirname` of `openclaw.json`). Absolute/`../` forms are allowed only when they still resolve inside that boundary. +- OpenClaw-owned writes that change only one top-level section backed by a single-file include write through to that included file. For example, `plugins install` updates `plugins: { $include: "./plugins.json5" }` in `plugins.json5` and leaves `openclaw.json` intact. +- Root includes, include arrays, and includes with sibling overrides are read-only for OpenClaw-owned writes; those writes fail closed instead of flattening the config. - Errors: clear messages for missing files, parse errors, and circular includes. --- diff --git a/docs/gateway/configuration.md b/docs/gateway/configuration.md index 72a4d54c8..c28c791b6 100644 --- a/docs/gateway/configuration.md +++ b/docs/gateway/configuration.md @@ -508,6 +508,12 @@ placeholders such as `***` or shortened token values. - **Sibling keys**: merged after includes (override included values) - **Nested includes**: supported up to 10 levels deep - **Relative paths**: resolved relative to the including file + - **OpenClaw-owned writes**: when a write changes only one top-level section + backed by a single-file include such as `plugins: { $include: "./plugins.json5" }`, + OpenClaw updates that included file and leaves `openclaw.json` intact + - **Unsupported write-through**: root includes, include arrays, and includes + with sibling overrides fail closed for OpenClaw-owned writes instead of + flattening the config - **Error handling**: clear errors for missing files, parse errors, and circular includes