From ba17b8b728fc05f4aa88ef43ce0313ed82bbc3d4 Mon Sep 17 00:00:00 2001 From: Peter Date: Tue, 28 Apr 2026 09:42:16 -0400 Subject: [PATCH] docs(active-memory): document cacheTtlMs bounds (#65708) (openclaw#65737) Verified: - pnpm install --frozen-lockfile - pnpm build - pnpm check - pnpm test (local full suite failed in unrelated plugin/logging shards; PR-specific docs/changelog checks and GitHub checks passed) - GitHub status checks for c2c5a94df85360043f2087f554894c7b6ad462ca completed without failure Co-authored-by: WuKongAI-CMU <210765158+WuKongAI-CMU@users.noreply.github.com> Co-authored-by: Tak Hoffman <781889+Takhoffman@users.noreply.github.com> --- CHANGELOG.md | 1 + docs/concepts/active-memory.md | 16 ++++++++-------- 2 files changed, 9 insertions(+), 8 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 5a953da91a9..a10b6c517b9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,6 +12,7 @@ Docs: https://docs.openclaw.ai ### Fixes - fix(device-pairing): validate callerScopes against resolved token scopes on repair [AI]. (#72925) Thanks @pgondhi987. +- Active Memory docs: document the `cacheTtlMs` 1000-120000 ms range and 15000 ms default so setup snippets do not lead users past the schema limit. Fixes #65708. (#65737) Thanks @WuKongAI-CMU. - fix(agents): canonicalize provider aliases in byProvider tool policy lookup [AI]. (#72917) Thanks @pgondhi987. - fix(security): block npm_execpath injection from workspace .env [AI-assisted]. (#73262) Thanks @pgondhi987. - Tools/web_fetch: decode response bodies from raw bytes using declared HTTP, XML, or HTML meta charsets before extraction, so Shift_JIS and other legacy-charset pages no longer return mojibake. Fixes #72916. Thanks @amknight. diff --git a/docs/concepts/active-memory.md b/docs/concepts/active-memory.md index db62ce65e01..4e971b735e8 100644 --- a/docs/concepts/active-memory.md +++ b/docs/concepts/active-memory.md @@ -578,14 +578,14 @@ The most important fields are: Useful tuning fields: -| Key | Type | Meaning | -| ----------------------------- | -------- | ------------------------------------------------------------- | -| `config.maxSummaryChars` | `number` | Maximum total characters allowed in the active-memory summary | -| `config.recentUserTurns` | `number` | Prior user turns to include when `queryMode` is `recent` | -| `config.recentAssistantTurns` | `number` | Prior assistant turns to include when `queryMode` is `recent` | -| `config.recentUserChars` | `number` | Max chars per recent user turn | -| `config.recentAssistantChars` | `number` | Max chars per recent assistant turn | -| `config.cacheTtlMs` | `number` | Cache reuse for repeated identical queries | +| Key | Type | Meaning | +| ----------------------------- | -------- | ---------------------------------------------------------------------------------- | +| `config.maxSummaryChars` | `number` | Maximum total characters allowed in the active-memory summary | +| `config.recentUserTurns` | `number` | Prior user turns to include when `queryMode` is `recent` | +| `config.recentAssistantTurns` | `number` | Prior assistant turns to include when `queryMode` is `recent` | +| `config.recentUserChars` | `number` | Max chars per recent user turn | +| `config.recentAssistantChars` | `number` | Max chars per recent assistant turn | +| `config.cacheTtlMs` | `number` | Cache reuse for repeated identical queries (range: 1000-120000 ms; default: 15000) | ## Recommended setup