docs(memory): document active-memory circuit breaker config and lancedb memory query CLI

- docs/concepts/active-memory.md: extend the "Useful tuning fields" config
  table with the new `config.circuitBreakerMaxTimeouts` and
  `config.circuitBreakerCooldownMs` keys (with their schema-declared ranges
  and defaults) added by 89cd2b6362, so operators tuning Active Memory
  recall after consecutive timeouts can find the knobs alongside
  `cacheTtlMs`.
- docs/plugins/memory-lancedb.md: extend the "Commands" section with the
  new `openclaw memory query` subcommand 6b44dce0c8 registered when
  memory-lancedb is the active memory plugin, including the `--cols`,
  `--filter`, `--limit`, and `--order-by` options and the safety bounds
  (200-character filter cap, sanitized character allowlist, positive
  integer limit, in-memory order-by).
This commit is contained in:
Vincent Koc
2026-04-29 04:40:43 -07:00
parent 0207f9ceec
commit c357235fe6
2 changed files with 23 additions and 8 deletions

View File

@@ -221,6 +221,19 @@ openclaw ltm search "project preferences"
openclaw ltm stats
```
The plugin also extends `openclaw memory` with a non-vector `query` subcommand
that runs against the LanceDB table directly:
```bash
openclaw memory query --cols id,text,createdAt --limit 20
openclaw memory query --filter "category = 'preference'" --order-by createdAt:desc
```
- `--cols <columns>`: comma-separated column allowlist (defaults to `id`, `text`, `importance`, `category`, `createdAt`).
- `--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.
- `--limit <n>`: positive integer; default `10`.
- `--order-by <column>:<asc|desc>`: in-memory sort applied after the filter; the sort column is auto-included in the projection.
Agents also get LanceDB memory tools from the active memory plugin:
- `memory_recall` for LanceDB-backed recall