53 lines
1.5 KiB
Markdown
53 lines
1.5 KiB
Markdown
|
---
|
|||
|
|
summary: "CLI reference for `openclaw memory` (status/index/search)"
|
|||
|
|
read_when:
|
|||
|
|
- You want to index or search semantic memory
|
|||
|
|
- You’re debugging memory availability or indexing
|
|||
|
|
title: "memory"
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# `openclaw memory`
|
|||
|
|
|
|||
|
|
Manage semantic memory indexing and search.
|
|||
|
|
Provided by the active memory plugin (default: `memory-core`; set `plugins.slots.memory = "none"` to disable).
|
|||
|
|
|
|||
|
|
Related:
|
|||
|
|
|
|||
|
|
- Memory concept: [Memory](/concepts/memory)
|
|||
|
|
- Plugins: [Plugins](/tools/plugin)
|
|||
|
|
|
|||
|
|
## Examples
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
openclaw memory status
|
|||
|
|
openclaw memory status --deep
|
|||
|
|
openclaw memory status --deep --index
|
|||
|
|
openclaw memory status --deep --index --verbose
|
|||
|
|
openclaw memory index
|
|||
|
|
openclaw memory index --verbose
|
|||
|
|
openclaw memory search "release checklist"
|
|||
|
|
openclaw memory search --query "release checklist"
|
|||
|
|
openclaw memory status --agent main
|
|||
|
|
openclaw memory index --agent main --verbose
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Options
|
|||
|
|
|
|||
|
|
Common:
|
|||
|
|
|
|||
|
|
- `--agent <id>`: scope to a single agent (default: all configured agents).
|
|||
|
|
- `--verbose`: emit detailed logs during probes and indexing.
|
|||
|
|
|
|||
|
|
`memory search`:
|
|||
|
|
|
|||
|
|
- Query input: pass either positional `[query]` or `--query <text>`.
|
|||
|
|
- If both are provided, `--query` wins.
|
|||
|
|
- If neither is provided, the command exits with an error.
|
|||
|
|
|
|||
|
|
Notes:
|
|||
|
|
|
|||
|
|
- `memory status --deep` probes vector + embedding availability.
|
|||
|
|
- `memory status --deep --index` runs a reindex if the store is dirty.
|
|||
|
|
- `memory index --verbose` prints per-phase details (provider, model, sources, batch activity).
|
|||
|
|
- `memory status` includes any extra paths configured via `memorySearch.extraPaths`.
|