🌀 OpenClaw Auto-Dream

Your AI doesn't just remember. It dreams.

A cognitive memory architecture that gives OpenClaw agents the ability to sleep, dream, and wake up smarter.
Five memory layers. Importance scoring. Forgetting curves. Knowledge graphs. Health dashboards.
Not file management — neuroscience.

MyClaw.ai · ClawHub · OpenClaw

🌐 中文 · Français · Deutsch · Русский · 日本語 · Italiano · Español

🦞 Part of the MyClaw.ai Ecosystem

MyClaw.ai is the AI personal assistant platform everyone's obsessed with — a fully-featured OpenClaw Agent running 24/7 on your own dedicated server. Not a chatbot. Not a wrapper. A real agent with full code control, internet access, cron jobs, file systems, databases, and tool integrations. Think of it as hiring a brilliant assistant who never sleeps, never forgets*, and can actually do things.

_{*With Auto-Dream installed, they literally never forget.}

Why MyClaw Changes Everything

Most AI tools give you a chat window. MyClaw gives you a server.

Every MyClaw instance runs OpenClaw — the open-source AI agent runtime — on dedicated infrastructure. Your agent has:

🖥️ A full Linux server — not a sandbox, not a container, a real machine
🌐 Unrestricted internet — browse, scrape, call APIs, send messages
⏰ Cron & background tasks — your agent works while you sleep
📁 Persistent file system — workspace, memory, configs, all yours
🧩 Skill ecosystem — install new abilities from ClawHub in one command
🔌 Channel integrations — Telegram, Discord, Slack, WhatsApp, and more
🔒 Your data, your server — no shared infrastructure, no data mining

This is why Auto-Dream exists. Because when your AI agent has a persistent server, persistent files, and persistent relationships with you — memory isn't a nice-to-have. It's the foundation of intelligence.

The Problem

Every AI agent forgets. Session ends, context gone. Files pile up. What was that decision from two weeks ago? Which workflow worked last time? Your agent has amnesia — functional, but forgetting everything the moment it sleeps.

Auto-Dream fixes this. Like the human brain consolidating memories during sleep, Auto-Dream runs periodic "dream cycles" that scan, extract, organize, score, link, and prune your agent's knowledge — automatically, safely, and intelligently.

Why This Matters for MyClaw Users

Your MyClaw agent runs 24/7. It handles your projects, tracks your decisions, remembers your preferences, manages your workflows. Over weeks and months, it accumulates thousands of daily log entries. Without Auto-Dream, that knowledge sits in raw files — unsorted, unscored, disconnected. Your agent has the data but can't think about it.

Auto-Dream transforms your agent from a tool that executes commands into a partner that understands context, learns from history, and connects the dots you didn't see.

Why This Is Different

Feature	Claude Code CLAUDE.md	Typical Memory Plugins	Auto-Dream
Memory layers	1 flat file	1 file or key-value	5 cognitive layers
Scoring	❌	❌	Importance × Recency × References
Forgetting	Manual cleanup	Delete or nothing	Gradual decay + archival
Knowledge graph	❌	❌	Linked entries + reachability
Health monitoring	❌	❌	5-metric score + trend tracking
Cross-instance	❌	❌	Export/import/merge bundles
Dashboard	❌	❌	Interactive HTML with charts

Architecture

┌──────────────────────────────────────────────────────────────────┐
│                                                                  │
│   ┌─────────────┐   ┌──────────────┐   ┌───────────────────┐   │
│   │   COLLECT    │──▶│ CONSOLIDATE  │──▶│     EVALUATE      │   │
│   │             │   │              │   │                   │   │
│   │ Scan 7 days │   │ Route layers │   │ Score importance  │   │
│   │ Flag markers│   │ Semantic dedup│   │ Forgetting curve  │   │
│   │ Extract     │   │ Assign IDs   │   │ Health metrics    │   │
│   │  insights   │   │ Link relations│  │ Generate insights │   │
│   └─────────────┘   └──────────────┘   └───────────────────┘   │
│                                                                  │
│                      ☽ Dream Cycle ☾                             │
└──────────────────────────────────────────────────────────────────┘
                              │
              ┌───────────────┼───────────────┐
              ▼               ▼               ▼
     ┌──────────────┐ ┌─────────────┐ ┌──────────────┐
     │  📊 Dashboard │ │ 🔔 Notify   │ │ 📝 Dream Log │
     │  HTML + Charts│ │ Push to chat│ │ Append report│
     └──────────────┘ └─────────────┘ └──────────────┘

Five Memory Layers

Layer	Storage	What Goes Here
Working	LCM plugin (optional, detected at setup)	Real-time context compression & semantic recall
Episodic	`memory/episodes/*.md`	Project narratives, event timelines, story arcs
Long-term	`MEMORY.md`	Facts, decisions, people, milestones, strategy
Procedural	`memory/procedures.md`	Workflows, preferences, tool patterns, shortcuts
Index	`memory/index.json`	Metadata, importance scores, relations, health stats

Features

🧠 Cognitive Dream Cycle

Runs automatically via cron (default: 4 AM daily). Three phases:

Collect — Scans unconsolidated daily logs (last 7 days), detects priority markers (⚠️ PERMANENT, 🔥 HIGH, 📌 PIN, ), extracts decisions / people / facts / projects / lessons / procedures / open threads
Consolidate — Routes each insight to the correct memory layer, performs semantic deduplication, assigns unique IDs (mem_NNN), creates relation links between connected entries
Evaluate — Scores importance using base_weight × recency × reference_boost / 8.0, applies forgetting curves (>90 days + low importance → archived, never deleted), calculates 5-metric health score, generates 1–3 non-obvious insights, writes dream report, sends notification

📊 Importance Scoring

Every entry gets a score on every dream cycle:

importance = (base_weight × recency_factor × reference_boost) / 8.0

Recency: max(0.1, 1.0 - days/180) — gradual decay over 6 months
References: log₂(count + 1) — logarithmic boost for frequently-referenced entries
Markers: 🔥 HIGH doubles base weight; ⚠️ PERMANENT always scores 1.0

📉 Intelligent Forgetting

Memories aren't deleted — they're gracefully archived:

Entry must be >90 days unreferenced AND importance < 0.3
Compressed to a one-line summary in memory/archive.md
Original ID preserved for relation tracking
⚠️ PERMANENT and 📌 PIN entries are immune

🕸️ Knowledge Graph

Entries are linked by semantic relations. The reachability metric measures graph connectivity:

Union-find algorithm across all entry relations
Detects isolated knowledge clusters
Suggests cross-references to improve coherence

🩺 Health Score (5 Metrics)

health = (freshness×0.25 + coverage×0.25 + coherence×0.2 + efficiency×0.15 + reachability×0.15) × 100

Metric	What It Measures
Freshness	% of entries referenced in last 30 days
Coverage	% of knowledge categories updated in last 14 days
Coherence	% of entries with at least one relation link
Efficiency	How concise MEMORY.md stays (inversely proportional to line count)
Reachability	How well-connected the memory graph is

🔔 Push Notifications

Dream results delivered to your chat automatically:

Level	What You Get
`silent`	Nothing — logged to dream-log.md only
`summary`	`🌀 Health: 82/100 \| +5 new, ~3 updated, -1 archived \| 💡 Top insight`
`full`	Complete dream report with all sections

📊 Interactive Dashboard

A zero-dependency HTML dashboard with:

Animated health gauge (0–100)
5 metric cards with color-coded status
Memory distribution donut chart
Importance histogram
Health trend line chart (last 30 cycles)
Force-directed knowledge graph visualization
Recent changes, insights, suggestions, stale entries

Generate it: "Show memory dashboard"

🔄 Cross-Instance Migration

Move memories between MyClaw instances:

"Export memory bundle"    →  memory/export-2026-03-28.json
"Import memory bundle"    →  merges with existing (newer wins)
"Export only procedures"  →  selective layer export

Portable JSON bundle format with full metadata, conflict resolution, and pre-import backup. Perfect for users managing multiple MyClaw instances or upgrading to a new server.

🔮 Dream Insights

After each cycle, 1–3 non-obvious observations:

Pattern connections — "Project X's strategy mirrors what worked for Project Y"
Temporal trends — "Strategic decisions cluster on Mondays — weekly planning detected"
Gap detection — "No lessons recorded for last 4 projects — retrospectives overdue"
Trend alerts — "Health declining 3 cycles: 85→79→72 — stale entries accumulating"
Density analysis — "mem_042 referenced by 8 entries but has no outbound links"

Quick Start

Install

Via ClawHub (recommended):

clawhub install openclaw-auto-dream

Via your MyClaw agent (easiest):

Just tell your agent: "Install Auto-Dream" — it handles everything.

Manual:

git clone https://github.com/LeoYeAI/openclaw-auto-dream.git \
  ~/.openclaw/workspace/skills/openclaw-auto-dream

Setup

Tell your agent: "Set up Auto-Dream"

The agent will:

Create a cron job (default: daily at 4 AM in your timezone)
Initialize memory/index.json with v3.0 schema
Ask your preferred notification level
Run the first dream cycle

Manual Trigger

"Run memory maintenance"
"Consolidate my memories"
"Dream now"

Dashboard

"Show memory dashboard"
"Generate memory dashboard"

Dream Report Example

## 🌀 Dream Report — 2026-03-28 04:00 UTC

### 📊 Stats
- Scanned: 7 files | New: 5 | Updated: 3 | Pruned: 1
- MEMORY.md: 142 lines | Episodes: 2 | Procedures: 8 entries

### 🧠 Health: 76/100
- Freshness: 72% | Coverage: 80% | Coherence: 55% | Efficiency: 90% | Reachability: 40%

### 🔮 Insights
- [Pattern] MyClaw growth trajectory mirrors early Shopify — consider their Series A playbook
- [Gap] No episode file for infrastructure migration — 12 related entries scattered across daily logs

### 📝 Changes
- [New] mem_089 — Product roadmap decision: prioritize mobile SDK
- [Updated] mem_042 — Team headcount updated: 30 → 35
- [Archived] mem_015 — Old staging API endpoint (superseded 95 days ago)

### 💡 Suggestions
- Coherence at 55% — link mem_089 to related project entries
- Reachability at 0.40 — 3 isolated memory clusters detected; add cross-references

Safety

Rule	Why
Never delete daily logs	Immutable source of truth
Never remove `⚠️ PERMANENT`	User protection is absolute
Episodes are append-only	Narrative history preserved forever
Auto-backup on >30% change	Prevents accidental corruption
Index backup every cycle	Always recoverable
Secrets policy	Only consolidates secrets already present

Release Notes

v4.0.0 — Intelligent Dream UX (2026-03-30)

🌟 Dream cycles that feel alive

Skip-with-Recall: When no new content, surfaces an old memory reminder + streak count instead of empty skip
Cumulative Growth Metrics: Notifications show "142 → 145 entries (+2.1%)" + dream streak
Stale Thread Detection: Scans Open Threads for items >14 days untouched, surfaces top 3 in notification
Milestone Celebrations: Triggers at 1st/7th/30th dream, 100/200/500 entries
Weekly Summary: On Sundays, generates week-over-week growth and biggest memories
Auto-Refresh Dashboard: Regenerates dashboard.html each dream cycle
Emotional Anchor (First Dream): Personalized reflection paragraph for deeper connection

v3.6.0 — First Dream AHA Moment (2026-03-30)

Instant First Dream: Post-install scan runs immediately — no 24h wait
Before/After Comparison: Shows memory state change in real-time
Empty instance handling: Works even with zero daily logs
New reference: first-dream-prompt.md for post-install experience

v3.5.0 — English Rewrite (2026-03-30)

Full SKILL.md rewritten to English for international audience

v3.4.0 — Dashboard Redesign (2026-03-29)

Chinese-native dashboard: Complete UI redesign with mobile responsive layout
Placeholder system: Template uses __DREAM_DATA_PLACEHOLDER__ for dynamic data injection

v3.3.0 — Framework Fix (2026-03-29)

🔧 First successful dream cycle

Initialized memory infrastructure: Created all missing files (index.json, dream-log.md, procedures.md, archive.md)
Simplified dream prompt: dream-prompt-lite.md rewritten to 1188 bytes for reliable cold-start
Slimmed SKILL.md: Removed overengineering, focused on practical execution
Increased timeout: 300s → 600s for complex first runs
3-day scan range: Daily incremental runs process only recent unconsolidated logs

v3.2.1 — Security & LCM Fix (2026-03-29)

LCM detect-only mode: No longer auto-installs plugins; prompts user instead
ClawHub security flag resolved: Removed auto-install commands that triggered scanner
Sensitive data policy: Renamed from "Secrets policy" to avoid false positives

v3.2.0 — Performance Optimization (2026-03-29)

⚡ ~90% token savings on idle days

Smart Skip: Dream cycle now checks for unconsolidated daily logs first. If nothing new in 7 days → instant exit (~2K tokens vs ~150K)
Lite Prompt: Self-contained 97-line prompt replaces 928 lines across 3 files. Scoring formulas, templates, and all rules inlined
Faster Execution: Cron reads 1 file instead of 3. Timeout reduced 600s → 300s
Full prompt preserved: dream-prompt.md (311 lines) kept for manual deep runs and debugging

v3.1.1 — Language & Stability (2026-03-28)

User language support: Dream notifications/reports auto-detect language from USER.md
Notification redesign: Uses cron delivery:announce instead of direct message tool calls
7 bug fixes: Scoring normalization, health formula, dashboard compatibility, reference integrity

v3.0.0 — Cognitive Architecture (2026-03-28)

🧠 Major release — full cognitive memory system

Push Notifications: 3 levels (silent/summary/full) auto-sent after dream cycle
Memory Health Dashboard: 18KB single-file HTML with Canvas charts and force-directed knowledge graph
Cross-Instance Migration: JSON bundle export/import with conflict resolution
Dream Insights: 1-3 non-obvious pattern observations per cycle
Reachability Graph: Union-find algorithm measuring memory connectivity
5-metric health formula: freshness × coverage × coherence × efficiency × reachability

v2.0.0 — Multi-Layer Memory (2026-03-28)

Five memory layers: Working (LCM) → Episodic → Long-term → Procedural → Index
Three-phase dream cycle: Collect → Consolidate → Evaluate
Importance scoring: base_weight × recency × reference_boost with forgetting curve
Memory index: index.json with IDs, timestamps, relations, reference counts
User markers: ⚠️ PERMANENT, 🔥 HIGH, 📌 PIN,

v1.0.0 — Initial Release (2026-03-28)

Basic daily log scanning and MEMORY.md consolidation
Semantic deduplication
90-day archival for unreferenced entries
Cron-triggered isolated session execution

Upgrading

From	To	Guide
v1.x	v2.x	migration-v1-to-v2.md
v2.x	v3.0	migration-v2-to-v3.md
v1.x	v3.0	migration-v2-to-v3.md (includes direct path)

All upgrades are non-destructive. Your data is always preserved.

How It Works Under the Hood

Auto-Dream leverages OpenClaw's native primitives — the same infrastructure that powers every MyClaw instance:

Primitive	Role
Cron	Schedules dream cycles at configurable intervals
Isolated Sessions	Runs consolidation without polluting main chat history
File System	Reads/writes memory files across all five layers
LCM	Provides working memory compression for long conversations

No external dependencies. No API keys. No databases. Just files and intelligence.

About MyClaw.ai

MyClaw.ai is the AI personal assistant platform that gives every user a dedicated server running OpenClaw — with full code control, unrestricted internet, cron jobs, and a growing ecosystem of installable skills.

The fastest-growing AI agent platform.

Your OpenClaw, ready for you. Run instantly. Cancel anytime.

🌐 myclaw.ai · 🐦 @MyClaw_Official · 💬 r/myclaw

License

"The brain doesn't stop working when you sleep. It starts its most important work."