From bbfd2dbce3c67570d2cf3b18ebce0668d313c516 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Tue, 28 Apr 2026 06:49:08 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@fb40ed99a7f0c325b9769f2bcea9f18df7ff1ffb --- .openclaw-sync/source.json | 4 ++-- docs/.generated/config-baseline.sha256 | 4 ++-- docs/gateway/config-agents.md | 3 +-- docs/gateway/configuration-examples.md | 1 - docs/reference/session-management-compaction.md | 3 ++- 5 files changed, 7 insertions(+), 8 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index 3e8e60eb8..80af3d0f0 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "ad57a6d61658f4e73b926138a3b010da5db4e225", - "syncedAt": "2026-04-28T06:38:19.511Z" + "sha": "fb40ed99a7f0c325b9769f2bcea9f18df7ff1ffb", + "syncedAt": "2026-04-28T06:47:35.988Z" } diff --git a/docs/.generated/config-baseline.sha256 b/docs/.generated/config-baseline.sha256 index 203865d7b..d89e8c0da 100644 --- a/docs/.generated/config-baseline.sha256 +++ b/docs/.generated/config-baseline.sha256 @@ -1,4 +1,4 @@ -4fd357ae137b920586ce5760d461be586f4f9a94e49b73cad1f81110167cd9da config-baseline.json -f874cddd0744be277af58ef14261af7994aba669c642f613be10f92b095998ba config-baseline.core.json +f888e19429506211e4b8b4113594641825d300c0c0a721121092cae2201b721f config-baseline.json +481eb68ecf9538d8f6d9808af1a7416b05a3b5d00080552b955a77dbd90819e3 config-baseline.core.json a9f058ee9616e189dab7fc223e1207a49ae52b8490b8028935c9d0a2b16f81b2 config-baseline.channel.json 1f5592bfd141ba1e982ce31763a253c10afb080ab4ea2b6538299b114e29cee1 config-baseline.plugin.json diff --git a/docs/gateway/config-agents.md b/docs/gateway/config-agents.md index 0746cc4c1..87cbfac7f 100644 --- a/docs/gateway/config-agents.md +++ b/docs/gateway/config-agents.md @@ -1153,7 +1153,6 @@ See [Multi-Agent Sandbox & Tools](/tools/multi-agent-sandbox-tools) for preceden mode: "warn", // warn | enforce pruneAfter: "30d", maxEntries: 500, - rotateBytes: "10mb", resetArchiveRetention: "30d", // duration or false maxDiskBytes: "500mb", // optional hard budget highWaterBytes: "400mb", // optional cleanup target @@ -1196,7 +1195,7 @@ See [Multi-Agent Sandbox & Tools](/tools/multi-agent-sandbox-tools) for preceden - `mode`: `warn` emits warnings only; `enforce` applies cleanup. - `pruneAfter`: age cutoff for stale entries (default `30d`). - `maxEntries`: maximum number of entries in `sessions.json` (default `500`). Runtime writes batch cleanup with a small high-water buffer for production-sized caps; `openclaw sessions cleanup --enforce` applies the cap immediately. - - `rotateBytes`: rotate `sessions.json` when it exceeds this size (default `10mb`). + - `rotateBytes`: deprecated and ignored; `openclaw doctor --fix` removes it from older configs. - `resetArchiveRetention`: retention for `*.reset.` transcript archives. Defaults to `pruneAfter`; set `false` to disable. - `maxDiskBytes`: optional sessions-directory disk budget. In `warn` mode it logs warnings; in `enforce` mode it removes oldest artifacts/sessions first. - `highWaterBytes`: optional target after budget cleanup. Defaults to `80%` of `maxDiskBytes`. diff --git a/docs/gateway/configuration-examples.md b/docs/gateway/configuration-examples.md index 29d47401a..febc08e3c 100644 --- a/docs/gateway/configuration-examples.md +++ b/docs/gateway/configuration-examples.md @@ -163,7 +163,6 @@ Save to `~/.openclaw/openclaw.json` and you can DM the bot from that number. mode: "warn", pruneAfter: "30d", maxEntries: 500, - rotateBytes: "10mb", resetArchiveRetention: "30d", // duration or false maxDiskBytes: "500mb", // optional highWaterBytes: "400mb", // optional (defaults to 80% of maxDiskBytes) diff --git a/docs/reference/session-management-compaction.md b/docs/reference/session-management-compaction.md index 594ae40b1..e8cedc70c 100644 --- a/docs/reference/session-management-compaction.md +++ b/docs/reference/session-management-compaction.md @@ -75,13 +75,14 @@ Session persistence has automatic maintenance controls (`session.maintenance`) f - `mode`: `warn` (default) or `enforce` - `pruneAfter`: stale-entry age cutoff (default `30d`) - `maxEntries`: cap entries in `sessions.json` (default `500`) -- `rotateBytes`: rotate `sessions.json` when oversized (default `10mb`) - `resetArchiveRetention`: retention for `*.reset.` transcript archives (default: same as `pruneAfter`; `false` disables cleanup) - `maxDiskBytes`: optional sessions-directory budget - `highWaterBytes`: optional target after cleanup (default `80%` of `maxDiskBytes`) Normal Gateway writes batch `maxEntries` cleanup for production-sized caps, so a store may briefly exceed the configured cap before the next high-water cleanup rewrites it back down. `openclaw sessions cleanup --enforce` still applies the configured cap immediately. +OpenClaw no longer creates automatic `sessions.json.bak.*` rotation backups during Gateway writes. The legacy `session.maintenance.rotateBytes` key is ignored and `openclaw doctor --fix` removes it from older configs. + Enforcement order for disk budget cleanup (`mode: "enforce"`): 1. Remove oldest archived, orphan transcript, or orphan trajectory artifacts first.