🦐 Nightly Dream — Memory Consolidation System

"While you sleep, your memories consolidate. Now your AI does too."

A biologically-inspired memory consolidation system. Every night, fragments of your interactions are distilled into structured long-term knowledge — duplicates merged, insights captured, stale memories gracefully archived.

Features

• 🌙 Four-Stage Dream Cycle: Orient → Gather → Consolidate → Prune
• 📊 5-Metric Health Score: Freshness, Coverage, Coherence, Efficiency, Reachability
• 🎯 Importance Scoring: Base weight × recency × reference boost
• 🗑️ Forgetting Curve: Automatic archival of stale, low-importance entries
• 🔗 Knowledge Graph: Related entries tracked via index.json
• 📈 Milestones: First dream, streaks, entry count milestones
• 🏥 Smart Skip: No new content? Still delivers value with memory recall
• 📊 Dashboard: Auto-generated HTML health dashboard
• 🔔 Rich Notifications: Growth metrics, highlights, insights, stale threads

Memory Architecture

workspace/
├── MEMORY.md              # Structured long-term knowledge
└── memory/
    ├── index.json         # Entry metadata + health stats
    ├── procedures.md       # Workflow preferences
    ├── archive.md         # Archived entries (faded)
    ├── dream-log.md       # Consolidation reports
    ├── dashboard.html     # Generated health dashboard
    ├── YYYY-MM-DD.md      # Daily interaction logs
    └── episodes/          # Project narratives

Quick Start

Manual Trigger

"Run dream" / "Consolidate memory" / "Dream now"

Automatic (Cron)

Pre-configured cron job runs at 03:00 daily.

Dream Cycle Flow

Step 0: Smart Skip

Checks for unconsolidated logs. If none → still delivers value via memory recall.

Step 1: Collect

Reads unconsolidated daily logs. Extracts decisions, facts, lessons, todos.

Step 2: Consolidate

Compares with MEMORY.md. Semantic dedup. New → append, Updated → modify, Duplicate → skip.

Step 3: Score & Prune

Computes health score (5 metrics). Archives stale entries below importance threshold.

Step 4: Notify

Sends rich notification with growth metrics, highlights, insights, and suggestions.

Health Metrics

Importance Markers

Archival Rules

Entry archived when ALL true:

• 90+ days since last referenced
• Importance \x3C 0.3
• Not marked PIN or PERMANENT
• Not in episodes/

Manual Commands

⚠️ Timeout Configuration (Critical!)

This skill requires a longer timeout to run properly. Add this to your openclaw.json under agents.defaults:

"agents": {
  "defaults": {
    "timeoutSeconds": 300
  }
}

Without this, the dream consolidation will timeout and fail. The skill scans many files and needs time to read, analyze, and write memory.

Cron Configuration (macOS launchd)

Create ~/Library/LaunchAgents/com.openclaw.claws-dream.plist:

\x3C?xml version="1.0" encoding="UTF-8"?>
\x3C!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
\x3Cplist version="1.0">
\x3Cdict>
    \x3Ckey>Label\x3C/key>
    \x3Cstring>com.openclaw.claws-dream\x3C/string>
    \x3Ckey>ProgramArguments\x3C/key>
    \x3Carray>
        \x3Cstring>/bin/bash\x3C/string>
        \x3Cstring>/Users/clawliu/.openclaw/workspace/skills/claws-dream/scripts/dream.sh\x3C/string>
    \x3C/array>
    \x3Ckey>StartCalendarInterval\x3C/key>
    \x3Cdict>
        \x3Ckey>Hour\x3C/key>
        \x3Cinteger>3\x3C/integer>
        \x3Ckey>Minute\x3C/key>
        \x3Cinteger>0\x3C/integer>
    \x3C/dict>
    \x3Ckey>RunAtLoad\x3C/key>
    \x3Cfalse/>
    \x3Ckey>StandardOutPath\x3C/key>
    \x3Cstring>/Users/clawliu/.openclaw/workspace/logs/claws-dream.log\x3C/string>
    \x3Ckey>StandardErrorPath\x3C/key>
    \x3Cstring>/Users/clawliu/.openclaw/workspace/logs/claws-dream.err\x3C/string>
\x3C/dict>
\x3C/plist>

Load with:

launchctl load ~/Library/LaunchAgents/com.openclaw.claws-dream.plist

Linux (systemd timer)

Create /etc/systemd/system/claws-dream.service:

[Unit]
Description=claws-dream nightly memory consolidation

[Service]
Type=oneshot
ExecStart=/bin/bash /home/user/.openclaw/workspace/skills/claws-dream/scripts/dream.sh
User=user

Create /etc/systemd/system/claws-dream.timer:

[Unit]
Description=Run claws-dream daily at 3 AM

[Timer]
OnCalendar=*-*-* 03:00:00
Persistent=true

[Install]
WantedBy=timers.target

Enable with:

sudo systemctl daemon-reload
sudo systemctl enable --now claws-dream.timer

Linux (cron)

0 3 * * * /bin/bash /home/user/.openclaw/workspace/skills/claws-dream/scripts/dream.sh >> /home/user/.openclaw/workspace/logs/claws-dream.log 2>&1

Windows (WSL)

:: Run via Windows Task Scheduler pointing to WSL
wsl bash -c "bash /mnt/c/Users/you/.openclaw/workspace/skills/claws-dream/scripts/dream.sh"

Or create a .bat file:

@echo off
wsl bash -c "bash /home/you/.openclaw/workspace/skills/claws-dream/scripts/dream.sh"

Windows (PowerShell Task Scheduler)

$action = New-ScheduledTaskAction -Execute 'bash' -Argument '-c "bash /home/you/.openclaw/workspace/skills/claws-dream/scripts/dream.sh"'
$trigger = New-ScheduledTaskTrigger -Daily -At 3am
Register-ScheduledTask -TaskName 'claws-dream' -Action $action -Trigger $trigger -RunLevel Limited

Reference Files

• references/dream-prompt.md — Full consolidation prompt

• references/first-dream-prompt.md — First run initialization

• references/scoring.md — Health score algorithms

• references/memory-template.md — File templates

• references/dashboard-template.md — HTML dashboard template

Safety Rules

1. Never delete daily logs — only mark with \x3C!-- consolidated -->
2. Never remove ⚠️ PERMANENT items — user-protected
3. Safe changes — if MEMORY.md changes >30%, save .bak first
4. Scope — only read/write memory/ directory and MEMORY.md

Version 2.2 — Built with 🦐 by Crayfish Liu