Autodream — Memory Consolidation

Consolidates scattered daily memory files into a clean, organized MEMORY.md.

When to Use

• - Manually: User says "consolidate memory", "dream", "clean up memory", "organize my memories"
• Via heartbeat: Periodically check if consolidation is needed (24h+ since last run AND 5+ new files)
• After major events: Big refactor, project changes, many new daily files

Quick Start

CODEBLOCK0

Replace {{workspace}} with your actual workspace path (e.g., ~/.openclaw/workspace).

If Installed Globally

CODEBLOCK1

What It Does (4 Phases)

Phase 1: Orientation

• - Reads existing MEMORY.md (if any)
• Scans memory/ for daily files
• Identifies files changed since last consolidation

Phase 2: Gather Signal

• - Extracts structured entries from each daily file
• Classifies into categories: People, Projects, Preferences, Technical Decisions, Events, Lessons
• Scores importance of each entry

Phase 3: Consolidation

• - Removes exact duplicates (hash-based)
• Removes fuzzy duplicates (similarity > 75%)
• Prunes stale entries (completed tasks, old debugging notes)
• Normalizes relative dates ("yesterday" → "2026-03-24")

Phase 4: Prune & Index

• - Enforces max line limit (default: 200 lines)
• Prioritizes by importance × recency
• Writes clean MEMORY.md with category sections
• Backs up previous MEMORY.md to INLINECODE7

Heartbeat Integration

Add to your HEARTBEAT.md:

CODEBLOCK2

Configuration

Create .autodream.json in workspace root to customize:

CODEBLOCK3

Safety

• - Non-destructive: Always backs up existing MEMORY.md before modifying
• Backups: Stored in INLINECODE11
• Reports: Consolidation reports in INLINECODE12
• Dry run: Always available with INLINECODE13
• Protected entries: Entries with ⚠️, IMPORTANT, NEVER, ALWAYS are never pruned

Output Format

CODEBLOCK4