From 35cd8a8850de66cf5ec395e853f92016c876403d Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Mon, 27 Apr 2026 11:33:33 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@35335214b324c38b45ee80f612cf51453b210631 --- .openclaw-sync/source.json | 4 ++-- docs/concepts/compaction.md | 7 +++++++ docs/reference/session-management-compaction.md | 3 +++ 3 files changed, 12 insertions(+), 2 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index 554f79b93..12b9f835f 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "053aff6d350048f2be9cc9c2ca885b46d4a6e5ac", - "syncedAt": "2026-04-27T11:30:23.473Z" + "sha": "35335214b324c38b45ee80f612cf51453b210631", + "syncedAt": "2026-04-27T11:32:03.647Z" } diff --git a/docs/concepts/compaction.md b/docs/concepts/compaction.md index f70af2e82..4b78806af 100644 --- a/docs/concepts/compaction.md +++ b/docs/concepts/compaction.md @@ -106,6 +106,13 @@ The byte guard requires `truncateAfterCompaction: true`. Without transcript rota ### Successor transcripts When `agents.defaults.compaction.truncateAfterCompaction` is enabled, OpenClaw does not rewrite the existing transcript in place. It creates a new active successor transcript from the compaction summary, preserved state, and unsummarized tail, then keeps the previous JSONL as the archived checkpoint source. +Successor transcripts also drop exact duplicate long user turns that arrive +inside a short retry window, so channel retry storms are not carried into the +next active transcript after compaction. + +Pre-compaction checkpoints are retained only while they stay below OpenClaw's +checkpoint size cap; oversized active transcripts still compact, but OpenClaw +skips the large debug snapshot instead of doubling disk usage. ### Compaction notices diff --git a/docs/reference/session-management-compaction.md b/docs/reference/session-management-compaction.md index aa83a33a4..1c9c5f7b6 100644 --- a/docs/reference/session-management-compaction.md +++ b/docs/reference/session-management-compaction.md @@ -50,6 +50,9 @@ OpenClaw persists sessions in two layers: - Append-only transcript with tree structure (entries have `id` + `parentId`) - Stores the actual conversation + tool calls + compaction summaries - Used to rebuild the model context for future turns + - Large pre-compaction debug checkpoints are skipped once the active + transcript exceeds the checkpoint size cap, avoiding a second giant + `.checkpoint.*.jsonl` copy. ---