diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index 31e8599bd..2c573cb30 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "2cacd2097b520c2ea2d1d7a0f8c0747995a8d7d7",
-  "syncedAt": "2026-04-25T01:22:58.480Z"
+  "sha": "41f9768cd8deec1ae23e5948a6d4462d1312ec5f",
+  "syncedAt": "2026-04-25T01:31:36.012Z"
 }
diff --git a/docs/concepts/context-engine.md b/docs/concepts/context-engine.md
index a419c4ebf..b420cc1a4 100644
--- a/docs/concepts/context-engine.md
+++ b/docs/concepts/context-engine.md
@@ -210,7 +210,10 @@ enabled for the run:
 - `true` — the engine owns compaction behavior. OpenClaw disables Pi's built-in
   auto-compaction for that run, and the engine's `compact()` implementation is
   responsible for `/compact`, overflow recovery compaction, and any proactive
-  compaction it wants to do in `afterTurn()`.
+  compaction it wants to do in `afterTurn()`. OpenClaw may still run the
+  pre-prompt overflow safeguard; when it predicts the full transcript will
+  overflow, the recovery path calls the active engine's `compact()` before
+  submitting another prompt.
 - `false` or unset — Pi's built-in auto-compaction may still run during prompt
   execution, but the active engine's `compact()` method is still called for
   `/compact` and overflow recovery.