# Claws Dream > ⚠️ DEPRECATED — OpenClaw 2026.4.5+ has official Dreaming (memory-core) built-in. This skill is no longer maintained. Use the official /dreaming slash command instead. Retired 2026-04-06. - Skill: `lord1egypt/claws-dream` (Agent Skill) - Install (CLI): `npx skillmds@latest add lord1egypt/claws-dream` - Raw SKILL.md: https://api.skillmd.com/api/skills/lord1egypt/claws-dream/raw - Safety review: pending (external: skill-scanner PASS, skillspector CAUTION) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: Lord1Egypt (https://skillmd.com/u/lord1egypt) - Updated: 2026-09-08 - Page: https://skillmd.com/skills/lord1egypt/claws-dream --- # 🦐 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 | Metric | Weight | Description | |--------|--------|-------------| | Freshness | 25% | Entries referenced in last 30 days | | Coverage | 25% | Sections updated in last 14 days | | Coherence | 20% | Entries with relation links | | Efficiency | 15% | MEMORY.md line count (concise) | | Reachability | 15% | Connected components in graph | ## Importance Markers | Marker | Effect | |--------|--------| | 🔥 HIGH | 2x importance weight | | 📌 PIN | Exempt from archival | | ⚠️ PERMANENT | Never archive or modify | ## Archival Rules Entry archived when ALL true: - 90+ days since last referenced - Importance < 0.3 - Not marked PIN or PERMANENT - Not in episodes/ ## Manual Commands | Command | Action | |---------|--------| | "Dream now" | Run full consolidation | | "Memory status" | Show health score + stats | | "Memory dashboard" | Generate dashboard.html | | "Memory export" | Export memories to JSON | ## ⚠️ Timeout Configuration (Critical!) **This skill requires a longer timeout to run properly.** Add this to your `openclaw.json` under `agents.defaults`: ```json "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`: ```xml Label com.openclaw.claws-dream ProgramArguments /bin/bash /Users/clawliu/.openclaw/workspace/skills/claws-dream/scripts/dream.sh StartCalendarInterval Hour 3 Minute 0 RunAtLoad StandardOutPath /Users/clawliu/.openclaw/workspace/logs/claws-dream.log StandardErrorPath /Users/clawliu/.openclaw/workspace/logs/claws-dream.err ``` Load with: ```bash launchctl load ~/Library/LaunchAgents/com.openclaw.claws-dream.plist ``` ### Linux (systemd timer) Create `/etc/systemd/system/claws-dream.service`: ```ini [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`: ```ini [Unit] Description=Run claws-dream daily at 3 AM [Timer] OnCalendar=*-*-* 03:00:00 Persistent=true [Install] WantedBy=timers.target ``` Enable with: ```bash sudo systemctl daemon-reload sudo systemctl enable --now claws-dream.timer ``` ### Linux (cron) ```bash 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) ```batch :: 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: ```batch @echo off wsl bash -c "bash /home/you/.openclaw/workspace/skills/claws-dream/scripts/dream.sh" ``` ### Windows (PowerShell Task Scheduler) ```powershell $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 `` 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_