Memory System

OpenClaw's memory system stores conversations, context, and information as files in your workspace. This file-based approach means you can read, edit, search, and version control your memories just like any other files.

OpenClaw stores memories as Markdown files:

• Daily Notes - Automatic daily memory files
• Conversation History - Stored in session files
• Context - Loaded automatically when needed
• Editable - You can read and modify memory files directly

Memories are stored in your workspace (~/clawd by default):

• Daily Notes - ~/clawd/YYYY-MM-DD.md
• Sessions - ~/clawd/sessions/
• Memories - Organized by date and topic

Daily Notes Format

Daily notes are created automatically:

# 2026-01-25

## Conversations
- Discussed project ideas with user
- Helped with configuration setup

## Important Information
- User prefers dark mode
- Workspace location: ~/projects

Memory search (finding relevant past context) may use embeddings. Depending on your setup, you may need to configure an embeddings model or API key in addition to your main LLM—it is not always enabled out of the box. OpenClaw supports several embeddings providers, including Voyage AI (native support). If memory search or “what the agent remembers” seems limited, check your configuration for embeddings provider settings. See Configuration and your provider’s docs for embedding options.

QMD & builtin (2026.2.21): With the QMD backend, per-agent memorySearch.enabled=false is respected at gateway startup; multi-collection searches run as per-collection queries. BM25-only search mode skips embed runs (e.g. memory index --force). The builtin backend avoids sync races on shutdown so onSearch/onSessionStart no longer fail with "database is not open" in ephemeral CLI flows. /status session summaries include cacheRead/cacheWrite for cache hit percentages.

The agent automatically accesses memories:

• Context Loading - Relevant memories loaded for conversations
• Search - Agent searches memories when needed
• Updates - Memories updated based on conversations

Manual Access

You can also access memories directly:

• Read memory files with any text editor
• Search with tools like Raycast or Obsidian
• Edit memories directly
• Version control with Git

Automatic Creation

• Daily notes created automatically
• Conversations recorded
• Important information extracted

Context Persistence

• Memories persist across sessions
• Context maintained over time
• Agent remembers your preferences

Searchable

• Search memories with text tools
• Agent searches automatically
• Fast retrieval of relevant information

Viewing Memories

View your memories:

• Open workspace directory: ~/clawd
• Browse daily notes
• Check session files

Editing Memories

Edit memory files directly:

• Open in any text editor
• Make changes
• Agent will use updated information

Searching Memories

Search your memories:

• Use grep or text search tools
• Use Raycast or Obsidian for advanced search
• Agent searches automatically during conversations

• Let It Grow - More memories = better context
• Review Regularly - Check daily notes periodically
• Edit When Needed - Correct inaccurate information
• Backup Workspace - Regular backups of memory files
• Use Search Tools - Leverage search for finding information

Memory files are stored locally:

• Local Storage - All memories on your machine
• No Cloud Sync - Never leaves your device
• You Control - Read, edit, or delete anytime
• Private by Default - Only you have access

OpenClaw’s built-in memory is file-based: daily notes, session history, and optional embeddings-based search. If you want structured long-term memory, automatic curation into a context tree, or higher-accuracy recall, you can add a community skill. ByteRover (on ClawHub) provides a memory skill with automatic memory flush at compaction, daily knowledge mining, and a context plugin that injects relevant context into prompts—see ByteRover’s OpenClaw integration docs. Browse Skills and ClawHub for other memory-related skills.