Memory

Understanding the long-term memory system.

What is Memory?

Memory stores information that persists across sessions:

• User preferences
• Important facts
• Learned information
• Cross-session context

Memory vs Session

Feature	Session	Memory
Scope	Single conversation	All conversations
Lifetime	Temporary	Permanent
Content	Messages	Facts & preferences

Memory Types

Facts

Information about the user:

- User's name is John
- Works as a software engineer
- Lives in San Francisco

Preferences

User preferences:

- Prefers concise responses
- Likes code examples
- Uses TypeScript

Context

Important contextual information:

- Working on project X
- Uses VS Code
- Has a meeting at 3pm

Memory Operations

# View memories
openclaw memory show

# Add memory
openclaw memory add "User prefers Python"

# Search
openclaw memory search "preferences"

# Remove
openclaw memory remove <id>

Configuration

{
  memory: {
    enabled: true,
    maxItems: 100,
    autoExtract: true,    // Auto-extract from conversations
    relevanceThreshold: 0.7
  }
}

Memory Retrieval

During processing, relevant memories are retrieved:

1. Query constructed from message
2. Semantic search performed
3. Top relevant memories included in context

See Also

• Session
• CLI: memory