From 84387131c5ecc347b631f68538335377f1e71048 Mon Sep 17 00:00:00 2001
From: OpenClaw <openclaw@local>
Date: Tue, 14 Apr 2026 06:50:31 +0000
Subject: [PATCH] Add dreaming best practices to DREAMS.md

---
 DREAMS.md | 104 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 103 insertions(+), 1 deletion(-)

diff --git a/DREAMS.md b/DREAMS.md
index 720e8be..943eede 100644
--- a/DREAMS.md
+++ b/DREAMS.md
@@ -1,4 +1,106 @@
-# Dream Diary
+# DREAMS.md — Dreaming Best Practices & Diary
+
+> Dreaming ist das Background Memory Consolidation System von OpenClaw.
+> Es konsolidiert Kurzzeit-Erinnerungen automatisch in langlebiges Wissen (`MEMORY.md`).
+
+---
+
+## Best Practices
+
+### Input-Qualität
+- **Tägliche Notizen** (`memory/YYYY-MM-DD.md`) sachlich und strukturiert halten
+- **Fakten klar von Meinungen trennen**
+- **Quellen angeben** wenn relevant (z.B. "aus Google Contacts", "Notarvertrag 25.11.2025")
+- **Wiederholungen vermeiden** — gleiche Info nicht in mehreren daily files
+- **Keine Secrets** — keine Passwörter, API-Keys oder sensible Daten
+
+### Dreaming Konfiguration
+```json
+{
+  "plugins": {
+    "entries": {
+      "memory-core": {
+        "config": {
+          "dreaming": {
+            "enabled": true,
+            "timezone": "Europe/Berlin",
+            "frequency": "0 3 * * *"
+          }
+        }
+      }
+    }
+  }
+}
+```
+- **Zeit:** 03:00 Uhr lokal — nachts, wenn keine aktiven Sessions
+- **Zeitzone:** Immer `Europe/Berlin` für Martin setzen
+
+### Phasen verstehen
+| Phase | Zweck | MEMORY.md? |
+|---|---|---|
+| **Light** | Signale sammeln und sortieren | ❌ |
+| **Deep** | Kandidaten bewerten und promovieren | ✅ |
+| **REM** | Themen & Muster extrahieren | ❌ |
+
+Reihenfolge: Light → REM → Deep
+
+### Deep Ranking Signale
+| Signal | Gewicht | Bedeutung |
+|---|---|---|
+| Relevance | 30% | Passt der Eintrag zu Suchanfragen? |
+| Frequency | 24% | Wie oft signalisiert? |
+| Query Diversity | 15% | Unterschiedliche Kontexte |
+| Recency | 15% | Frische (zeitlich abgewertet) |
+| Consolidation | 10% | Wiederholung über mehrere Tage |
+| Conceptual Richness | 6% | Konzept-Tag-Dichte |
+
+### Manuelle Kontrolle
+```bash
+# Status & Kandidaten prüfen
+openclaw memory promote
+openclaw memory status --deep
+
+# Vorschau (ohne Schreiben)
+openclaw memory promote --limit 5
+openclaw memory rem-harness
+
+# Manuelles Promoten
+openclaw memory promote --apply
+
+# Einzelnen Kandidaten analysieren
+openclaw memory promote-explain "suchbegriff"
+openclaw memory promote-explain "suchbegriff" --json
+```
+
+### Historische Daten (Backfill)
+```bash
+# Preview
+memory rem-harness --path memory/2026-04-11.md --grounded
+
+# Backfill schreiben
+memory rem-backfill --path memory/2026-04-11.md
+
+# Rollback falls nötig
+memory rem-backfill --rollback
+```
+
+### Troubleshooting
+- **Dreaming schreibt nicht?** → `dreaming.enabled` in Config prüfen
+- **Falsche Zeit?** → `dreaming.timezone` auf `Europe/Berlin` setzen
+- **Zu viele Einträge?** → Schwellenwerte erhöhen (`minScore`, `minRecallCount`)
+- **Zu wenige Einträge?** → Qualität der daily memory files prüfen
+- **DREAMS.md verändert?** → Managed Blöcke (`<!-- openclaw:dreaming:... -->`) werden vom System überschrieben
+
+### Goldene Regeln
+1. `MEMORY.md` = Single Source of Truth für Langzeitgedächtnis
+2. Daily Files = Rohdaten, Dreaming filtert und bewertet
+3. `DREAMS.md` = System-Output, managed Blöcke nicht manuell editieren
+4. Keine Secrets in irgendeiner Dreaming-Datei
+5. Regelmäßig prüfen — Dreaming ist assistiert, nicht vollautonom
+
+---
+
+## Dream Diary
 
 <!-- openclaw:dreaming:diary:start -->
 ---