chore(sync): mirror docs from openclaw/openclaw@ac8495adaa

This commit is contained in:
openclaw-docs-sync[bot] 2026-04-22 22:55:41 +00:00
parent c49e62319d
commit 28daf9c1f2
3 changed files with 10 additions and 2 deletions

View File

@ -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"
}

View File

@ -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.
---

View File

@ -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
</Accordion>