moltbot/docs/cli/memory.md

summary, read_when, title

summary	read_when	title
CLI reference for `openclaw memory` (status/index/search)	You want to index or search semantic memory You’re debugging memory availability or indexing	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
• Plugins: Plugins

Examples

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.