> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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  theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw memory status
openclaw memory status --deep
openclaw memory index --force
openclaw memory search "meeting notes"
openclaw memory search --query "deployment" --max-results 20
openclaw memory status --json
openclaw memory status --deep --index
openclaw memory status --deep --index --verbose
openclaw memory status --agent main
openclaw memory index --agent main --verbose
```

## Options

`memory status` and `memory index`:

* `--agent <id>`: scope to a single agent. Without it, these commands run for each configured agent; if no agent list is configured, they fall back to the default agent.
* `--verbose`: emit detailed logs during probes and indexing.

`memory status`:

* `--deep`: probe vector + embedding availability.
* `--index`: run a reindex if the store is dirty (implies `--deep`).
* `--json`: print JSON output.

`memory index`:

* `--force`: force a full reindex.

`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.
* `--agent <id>`: scope to a single agent (default: the default agent).
* `--max-results <n>`: limit the number of results returned.
* `--min-score <n>`: filter out low-score matches.
* `--json`: print JSON results.

Notes:

* `memory index --verbose` prints per-phase details (provider, model, sources, batch activity).
* `memory status` includes any extra paths configured via `memorySearch.extraPaths`.
* If effectively active memory remote API key fields are configured as SecretRefs, the command resolves those values from the active gateway snapshot. If gateway is unavailable, the command fails fast.
* Gateway version skew note: this command path requires a gateway that supports `secrets.resolve`; older gateways return an unknown-method error.


Built with [Mintlify](https://mintlify.com).