Minimal Config

Only embedding.apiKey is required:

openclaw config set plugins.slots.memory memex
openclaw config set plugins.entries.memex.config.embedding '{"provider":"openai-compatible","apiKey":"${EMBED_API_KEY}","model":"text-embedding-3-small","baseURL":"https://api.openai.com/v1"}'

Config Reference

Auto-Recall (memory injection)

Injects relevant memories into the prompt before each turn.

# On by default. To disable:
openclaw config set plugins.entries.memex.config.autoRecall false

# Limit to specific agents (default: all agents):
openclaw config set plugins.entries.memex.config.autoRecallAgents '["main","cabbie"]'

# Number of results per turn (default: 3, R@3=90%, R@5=96%):
openclaw config set plugins.entries.memex.config.autoRecallLimit 5

Auto-Capture (LLM-driven storage)

Injects a system prompt nudging the LLM to store facts via memory_store.

# On by default. To disable:
openclaw config set plugins.entries.memex.config.autoCapture false

# Limit to specific agents:
openclaw config set plugins.entries.memex.config.autoCaptureAgents '["main"]'

Scopes (per-agent memory isolation)

Control which agent sees which memories.

# Give an agent access to global + its own scope (default):
openclaw config set plugins.entries.memex.config.scopes.agentAccess.coder '["global","agent:coder"]'

# Isolate an agent — only sees its own memories:
openclaw config set plugins.entries.memex.config.scopes.agentAccess.coder '["agent:coder"]'

# Set all scopes at once:
openclaw config set plugins.entries.memex.config.scopes '{"default":"global","agentAccess":{"main":["global","agent:main"],"coder":["agent:coder"],"infra":["global","agent:infra"]}}'

Document Search

Auto-discovers agent workspace markdown files. On by default.

# Disable:
openclaw config set plugins.entries.memex.config.documents.enabled false

# Change re-index interval (default 30 min, 0 = disabled):
openclaw config set plugins.entries.memex.config.documents.reindexIntervalMinutes 60

Reranker (optional)

Cross-encoder reranker. Off by default. Recommended when autoRecallLimit=1.

openclaw config set plugins.entries.memex.config.reranker '{"enabled":true,"endpoint":"http://localhost:8090/v1/rerank","model":"bge-reranker-v2-m3-Q8_0"}'

All Settings

Setting	Default	Description
`embedding.apiKey`	(required)	Embedding API key
`embedding.model`	text-embedding-3-small	Embedding model
`embedding.baseURL`	—	OpenAI-compatible endpoint
`autoRecall`	true	Inject memories before each turn
`autoRecallAgents`	(all)	Agent whitelist for recall
`autoRecallLimit`	3	Results per turn
`autoCapture`	true	LLM-driven memory storage
`autoCaptureAgents`	(all)	Agent whitelist for capture
`scopes.default`	global	Default memory scope
`scopes.agentAccess`	(all global)	Per-agent scope access
`documents.enabled`	true	Document search
`reranker.enabled`	false	Cross-encoder reranker

System	Memory E2E Accuracy	Reader LLM
Hindsight/TEMPR	91.4%	GPT-4o
Memex	90%	GPT-4o
Zep/Graphiti	~85%	GPT-4o
mem0	~78%	GPT-4o
MemGPT	~75%	GPT-4o

memex

Memex — Unified Memory for OpenClaw

LongMemEval (ICLR 2025) — Memory Retrieval

Install