--- read_when: - Sie möchten den semantischen Speicher indizieren oder durchsuchen - Sie debuggen die Speicherverfügbarkeit oder Indizierung - Sie möchten abgerufene Kurzzeitgedächtnisinhalte in `MEMORY.md` hochstufen summary: CLI-Referenz für `openclaw memory` (status/index/search/promote/promote-explain/rem-harness) title: Speicher x-i18n: generated_at: "2026-05-06T17:53:41Z" model: gpt-5.5 provider: openai source_hash: 7137f8a9529095204699de5fee7a0baf5d5a377792dc93b4059145d0eefab737 source_path: cli/memory.md workflow: 16 --- # `openclaw memory` Semantische Memory-Indizierung und Suche verwalten. Bereitgestellt vom Active Memory-Plugin (Standard: `memory-core`; setzen Sie `plugins.slots.memory = "none"`, um es zu deaktivieren). Verwandt: - Memory-Konzept: [Memory](/de/concepts/memory) - Memory-Wiki: [Memory-Wiki](/de/plugins/memory-wiki) - Wiki-CLI: [wiki](/de/cli/wiki) - Plugins: [Plugins](/de/tools/plugin) ## Beispiele ```bash openclaw memory status openclaw memory status --deep openclaw memory status --fix openclaw memory index --force openclaw memory search "meeting notes" openclaw memory search --query "deployment" --max-results 20 openclaw memory promote --limit 10 --min-score 0.75 openclaw memory promote --apply openclaw memory promote --json --min-recall-count 0 --min-unique-queries 0 openclaw memory promote-explain "router vlan" openclaw memory promote-explain "router vlan" --json openclaw memory rem-harness openclaw memory rem-harness --json openclaw memory status --json openclaw memory status --deep --index openclaw memory status --deep --index --verbose openclaw memory status --agent main openclaw memory index --agent main --verbose ``` ## Optionen `memory status` und `memory index`: - `--agent `: auf einen einzelnen Agenten beschränken. Ohne diese Option werden diese Befehle für jeden konfigurierten Agenten ausgeführt; wenn keine Agentenliste konfiguriert ist, verwenden sie den Standardagenten. - `--verbose`: während Probes und Indizierung detaillierte Logs ausgeben. `memory status`: - `--deep`: Bereitschaft des lokalen Vektorspeichers, Bereitschaft des Embedding-Providers und Bereitschaft der semantischen Vektorsuche prüfen. Einfaches `memory status` bleibt schnell und führt keine Live-Embedding- oder Provider-Erkennungsarbeit aus; ein unbekannter Vektorspeicher- oder semantischer Vektorstatus bedeutet, dass er in diesem Befehl nicht geprüft wurde. QMD-lexikalisches `searchMode: "search"` überspringt semantische Vektor-Probes und Embedding-Wartung auch mit `--deep`. - `--index`: eine Neuindizierung ausführen, wenn der Speicher dirty ist (impliziert `--deep`). - `--fix`: veraltete Recall-Sperren reparieren und Promotion-Metadaten normalisieren. - `--json`: JSON-Ausgabe ausgeben. Wenn `memory status` `Dreaming status: blocked` anzeigt, ist der verwaltete Dreaming-Cron aktiviert, aber der Heartbeat, der ihn antreibt, wird für den Standardagenten nicht ausgelöst. Unter [Dreaming wird nie ausgeführt](/de/concepts/dreaming#dreaming-never-runs-status-shows-blocked) finden Sie die zwei häufigen Ursachen. `memory index`: - `--force`: eine vollständige Neuindizierung erzwingen. `memory search`: - Abfrageeingabe: entweder positionales `[query]` oder `--query ` übergeben. - Wenn beide angegeben sind, hat `--query` Vorrang. - Wenn keines angegeben ist, beendet sich der Befehl mit einem Fehler. - `--agent `: auf einen einzelnen Agenten beschränken (Standard: der Standardagent). - `--max-results `: die Anzahl der zurückgegebenen Ergebnisse begrenzen. - `--min-score `: Treffer mit niedrigem Score herausfiltern. - `--json`: JSON-Ergebnisse ausgeben. `memory promote`: Kurzfristige Memory-Promotions als Vorschau anzeigen und anwenden. ```bash openclaw memory promote [--apply] [--limit ] [--include-promoted] ``` - `--apply` -- Promotions nach `MEMORY.md` schreiben (Standard: nur Vorschau). - `--limit ` -- die Anzahl der angezeigten Kandidaten begrenzen. - `--include-promoted` -- Einträge einschließen, die bereits in vorherigen Zyklen promoted wurden. Vollständige Optionen: - Bewertet kurzfristige Kandidaten aus `memory/YYYY-MM-DD.md` anhand gewichteter Promotion-Signale (`frequency`, `relevance`, `query diversity`, `recency`, `consolidation`, `conceptual richness`). - Verwendet kurzfristige Signale sowohl aus Memory-Recalls als auch aus täglichen Ingestion-Durchläufen sowie Verstärkungssignale aus Light-/REM-Phasen. - Wenn Dreaming aktiviert ist, verwaltet `memory-core` automatisch einen Cron-Job, der im Hintergrund einen vollständigen Sweep (`light -> REM -> deep`) ausführt (kein manuelles `openclaw cron add` erforderlich). - `--agent `: auf einen einzelnen Agenten beschränken (Standard: der Standardagent). - `--limit `: maximale Anzahl der zurückzugebenden/anzuwendenden Kandidaten. - `--min-score `: minimaler gewichteter Promotion-Score. - `--min-recall-count `: minimale Recall-Anzahl, die für einen Kandidaten erforderlich ist. - `--min-unique-queries `: minimale Anzahl unterschiedlicher Abfragen, die für einen Kandidaten erforderlich ist. - `--apply`: ausgewählte Kandidaten an `MEMORY.md` anhängen und als promoted markieren. - `--include-promoted`: bereits promoted Kandidaten in die Ausgabe einschließen. - `--json`: JSON-Ausgabe ausgeben. `memory promote-explain`: Einen bestimmten Promotion-Kandidaten und seine Score-Aufschlüsselung erklären. ```bash openclaw memory promote-explain [--agent ] [--include-promoted] [--json] ``` - ``: nachzuschlagender Kandidatenschlüssel, Pfadfragment oder Snippet-Fragment. - `--agent `: auf einen einzelnen Agenten beschränken (Standard: der Standardagent). - `--include-promoted`: bereits promoted Kandidaten einschließen. - `--json`: JSON-Ausgabe ausgeben. `memory rem-harness`: REM-Reflexionen, Kandidatenwahrheiten und Deep-Promotion-Ausgabe als Vorschau anzeigen, ohne etwas zu schreiben. ```bash openclaw memory rem-harness [--agent ] [--include-promoted] [--json] ``` - `--agent `: auf einen einzelnen Agenten beschränken (Standard: der Standardagent). - `--include-promoted`: bereits promoted Deep-Kandidaten einschließen. - `--json`: JSON-Ausgabe ausgeben. ## Dreaming Dreaming ist das Hintergrundsystem zur Memory-Konsolidierung mit drei kooperativen Phasen: **light** (kurzfristiges Material sortieren/stagen), **deep** (dauerhafte Fakten nach `MEMORY.md` promoten) und **REM** (reflektieren und Themen sichtbar machen). - Mit `plugins.entries.memory-core.config.dreaming.enabled: true` aktivieren. - Im Chat mit `/dreaming on|off` umschalten (oder mit `/dreaming status` prüfen). - Dreaming läuft nach einem verwalteten Sweep-Zeitplan (`dreaming.frequency`) und führt Phasen der Reihe nach aus: light, REM, deep. - Nur die Deep-Phase schreibt dauerhafte Memory nach `MEMORY.md`. - Menschenlesbare Phasenausgaben und Tagebucheinträge werden nach `DREAMS.md` (oder vorhandenes `dreams.md`) geschrieben, mit optionalen Berichten pro Phase in `memory/dreaming//YYYY-MM-DD.md`. - Das Ranking verwendet gewichtete Signale: Recall-Häufigkeit, Retrieval-Relevanz, Abfragevielfalt, zeitliche Aktualität, Konsolidierung über mehrere Tage und abgeleitete konzeptuelle Reichhaltigkeit. - Promotion liest die Live-Tagesnotiz vor dem Schreiben nach `MEMORY.md` erneut, sodass bearbeitete oder gelöschte kurzfristige Snippets nicht aus veralteten Recall-Store-Snapshots promoted werden. - Geplante und manuelle `memory promote`-Läufe teilen dieselben Deep-Phasen-Standards, sofern Sie keine CLI-Schwellenwertüberschreibungen übergeben. - Automatische Läufe verteilen sich über konfigurierte Memory-Workspaces. Standardplanung: - **Sweep-Taktung**: `dreaming.frequency = 0 3 * * *` - **Deep-Schwellenwerte**: `minScore=0.8`, `minRecallCount=3`, `minUniqueQueries=3`, `recencyHalfLifeDays=14`, `maxAgeDays=30` Beispiel: ```json { "plugins": { "entries": { "memory-core": { "config": { "dreaming": { "enabled": true } } } } } } ``` Hinweise: - `memory index --verbose` gibt Details pro Phase aus (Provider, Modell, Quellen, Batch-Aktivität). - `memory status` enthält alle zusätzlichen Pfade, die über `memorySearch.extraPaths` konfiguriert sind. - Wenn effektiv aktive Remote-API-Schlüsselfelder für Memory als SecretRefs konfiguriert sind, löst der Befehl diese Werte aus dem aktiven Gateway-Snapshot auf. Wenn Gateway nicht verfügbar ist, schlägt der Befehl schnell fehl. - Hinweis zu Gateway-Versionsabweichung: Dieser Befehlspfad erfordert ein Gateway, das `secrets.resolve` unterstützt; ältere Gateways geben einen Fehler wegen unbekannter Methode zurück. - Stimmen Sie die geplante Sweep-Taktung mit `dreaming.frequency` ab. Die Deep-Promotion-Richtlinie ist ansonsten intern; verwenden Sie CLI-Flags für `memory promote`, wenn Sie einmalige manuelle Überschreibungen benötigen. - `memory rem-harness --path --grounded` zeigt grounded `What Happened`, `Reflections` und `Possible Lasting Updates` aus historischen Tagesnotizen als Vorschau an, ohne etwas zu schreiben. - `memory rem-backfill --path ` schreibt reversible grounded Tagebucheinträge zur UI-Prüfung nach `DREAMS.md`. - `memory rem-backfill --path --stage-short-term` speist außerdem grounded dauerhafte Kandidaten in den Live-Speicher für kurzfristige Promotions ein, damit die normale Deep-Phase sie bewerten kann. - `memory rem-backfill --rollback` entfernt zuvor geschriebene grounded Tagebucheinträge, und `memory rem-backfill --rollback-short-term` entfernt zuvor gestagte grounded kurzfristige Kandidaten. - Vollständige Phasenbeschreibungen und die Konfigurationsreferenz finden Sie unter [Dreaming](/de/concepts/dreaming). ## Verwandt - [CLI-Referenz](/de/cli) - [Memory-Übersicht](/de/concepts/memory)