Merlin

Merlin Docs

Memory

Durable facts injected into future prompt stacks.

Memory is not a chat transcript. It is compact durable state stored under .claw/runtime/memory and formatted into the prompt stack on later turns.

Memory Types

Type Role
Core memory Stable workspace facts and preferences.
Relevant memory Query-selected facts from relevant.json plus the current session key’s memory.
Agent memory Used when an agent spec sets memoryScope to agent.

Commands

claw memory add "Prefer terse implementation reports"
claw memory list
claw memory replace "old fact" "new fact"
claw memory remove "stale fact"

CLI replace and remove use exact core-memory text. The agent memory tool uses substring matching and fails when a match is ambiguous.

The memory tool follows the same policy: save stable user, project, and workflow preferences; do not save secrets, raw dumps, or temporary task progress.