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 (range: 1000-120000 ms; default: 15000) |

| 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) |

| `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). |

| `config.circuitBreakerCooldownMs` | `number` | How long to skip recall after the circuit breaker trips, in ms (range: 5000-600000; default: 60000). |

## Recommended setup

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