docs(memory): document active-memory circuit breaker config and lance… · openclaw/openclaw@c357235
vincentkoc
·
2026-04-29
·
via Recent Commits to openclaw:main
| Original file line number | Diff line number | Diff line change |
|---|
@@ -579,14 +579,16 @@ The most important fields are:
|
579 | 579 | |
580 | 580 | Useful tuning fields: |
581 | 581 | |
582 | | -| Key | Type | Meaning | |
583 | | -| ----------------------------- | -------- | ---------------------------------------------------------------------------------- | |
584 | | -| `config.maxSummaryChars` | `number` | Maximum total characters allowed in the active-memory summary | |
585 | | -| `config.recentUserTurns` | `number` | Prior user turns to include when `queryMode` is `recent` | |
586 | | -| `config.recentAssistantTurns` | `number` | Prior assistant turns to include when `queryMode` is `recent` | |
587 | | -| `config.recentUserChars` | `number` | Max chars per recent user turn | |
588 | | -| `config.recentAssistantChars` | `number` | Max chars per recent assistant turn | |
589 | | -| `config.cacheTtlMs` | `number` | Cache reuse for repeated identical queries (range: 1000-120000 ms; default: 15000) | |
| 582 | +| Key | Type | Meaning | |
| 583 | +| ---------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | |
| 584 | +| `config.maxSummaryChars` | `number` | Maximum total characters allowed in the active-memory summary | |
| 585 | +| `config.recentUserTurns` | `number` | Prior user turns to include when `queryMode` is `recent` | |
| 586 | +| `config.recentAssistantTurns` | `number` | Prior assistant turns to include when `queryMode` is `recent` | |
| 587 | +| `config.recentUserChars` | `number` | Max chars per recent user turn | |
| 588 | +| `config.recentAssistantChars` | `number` | Max chars per recent assistant turn | |
| 589 | +| `config.cacheTtlMs` | `number` | Cache reuse for repeated identical queries (range: 1000-120000 ms; default: 15000) | |
| 590 | +| `config.circuitBreakerMaxTimeouts` | `number` | Skip recall after this many consecutive timeouts for the same agent/model. Resets on a successful recall or after the cooldown expires (range: 1-20; default: 3). | |
| 591 | +| `config.circuitBreakerCooldownMs` | `number` | How long to skip recall after the circuit breaker trips, in ms (range: 5000-600000; default: 60000). | |
590 | 592 | |
591 | 593 | ## Recommended setup |
592 | 594 | |
|
| Original file line number | Diff line number | Diff line change |
|---|
@@ -221,6 +221,19 @@ openclaw ltm search "project preferences"
|
221 | 221 | openclaw ltm stats |
222 | 222 | ``` |
223 | 223 | |
| 224 | +The plugin also extends `openclaw memory` with a non-vector `query` subcommand |
| 225 | +that runs against the LanceDB table directly: |
| 226 | + |
| 227 | +```bash |
| 228 | +openclaw memory query --cols id,text,createdAt --limit 20 |
| 229 | +openclaw memory query --filter "category = 'preference'" --order-by createdAt:desc |
| 230 | +``` |
| 231 | + |
| 232 | +- `--cols <columns>`: comma-separated column allowlist (defaults to `id`, `text`, `importance`, `category`, `createdAt`). |
| 233 | +- `--filter <condition>`: SQL-style WHERE clause; capped at 200 characters and restricted to alphanumerics, comparison operators, quotes, parentheses, and a small set of safe punctuation. |
| 234 | +- `--limit <n>`: positive integer; default `10`. |
| 235 | +- `--order-by <column>:<asc|desc>`: in-memory sort applied after the filter; the sort column is auto-included in the projection. |
| 236 | + |
224 | 237 | Agents also get LanceDB memory tools from the active memory plugin: |
225 | 238 | |
226 | 239 | - `memory_recall` for LanceDB-backed recall |
|
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。
