# 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 -->
---

*April 11, 2026*

<!-- openclaw:dreaming:backfill-entry day=2026-04-11 source=/root/.openclaw/workspace/memory/2026-04-11.md -->

What Happened
1. No grounded facts were extracted.

Reflections
1. No grounded reflections emerged from this note yet.

---

*April 12, 2026*

<!-- openclaw:dreaming:backfill-entry day=2026-04-12 source=/root/.openclaw/workspace/memory/2026-04-12.md -->

What Happened
1. No grounded facts were extracted.

Reflections
1. No grounded reflections emerged from this note yet.
<!-- openclaw:dreaming:diary:end -->
