> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Speicher # `openclaw memory` Semantische Gedächtnisindizierung und -suche verwalten. Bereitgestellt durch das gebündelte Plugin `memory-core`. Der Befehl ist verfügbar, wenn `plugins.slots.memory` `memory-core` auswählt (Standard); andere Gedächtnis-Plugins stellen ihre eigenen CLI-Namensräume bereit. Verwandt: * Gedächtniskonzept: [Gedächtnis](/de/concepts/memory) * Gedächtnis-Wiki: [Gedächtnis-Wiki](/de/plugins/memory-wiki) * Wiki-CLI: [wiki](/de/cli/wiki) * Plugins: [Plugins](/de/tools/plugin) ## Beispiele ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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, fallen sie auf den Standardagenten zurück. * `--verbose`: während Prüfungen und Indizierung detaillierte Logs ausgeben. `memory status`: * `--deep`: Bereitschaft des lokalen Vektorspeichers, des Embedding-Providers und 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 Vektorprüfungen und Embedding-Wartung auch mit `--deep`. * `--index`: eine Neuindizierung ausführen, wenn der Speicher geändert wurde (impliziert `--deep`). * `--fix`: veraltete Recall-Sperren reparieren und Promotion-Metadaten normalisieren. * `--json`: JSON-Ausgabe drucken. 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. Siehe [Dreaming wird nie ausgeführt](/de/concepts/dreaming#dreaming-never-runs-status-shows-blocked) für 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, gewinnt `--query`. * 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 niedriger Bewertung herausfiltern. * `--json`: JSON-Ergebnisse drucken. `memory promote`: Promotions aus dem Kurzzeitgedächtnis in der Vorschau anzeigen und anwenden. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw memory promote [--apply] [--limit ] [--include-promoted] ``` * `--apply` -- Promotions in `MEMORY.md` schreiben (Standard: nur Vorschau). * `--limit ` -- die Anzahl der angezeigten Kandidaten begrenzen. * `--include-promoted` -- Einträge einschließen, die bereits in früheren Zyklen promoted wurden. Vollständige Optionen: * Bewertet Kurzzeitkandidaten aus `memory/YYYY-MM-DD.md` anhand gewichteter Promotion-Signale (`frequency`, `relevance`, `query diversity`, `recency`, `consolidation`, `conceptual richness`). * Verwendet Kurzzeitsignale sowohl aus Gedächtnis-Recalls als auch aus täglichen Ingestionsläufen sowie Verstärkungssignale der light/REM-Phase. * 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 zurückzugebender/anzuwendender Kandidaten. * `--min-score `: minimale gewichtete Promotion-Bewertung. * `--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 drucken. `memory promote-explain`: Einen bestimmten Promotion-Kandidaten und die Aufschlüsselung seiner Bewertung erklären. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw memory promote-explain [--agent ] [--include-promoted] [--json] ``` * ``: Kandidatenschlüssel, Pfadfragment oder Snippet-Fragment zum Nachschlagen. * `--agent `: auf einen einzelnen Agenten beschränken (Standard: der Standardagent). * `--include-promoted`: bereits promoted Kandidaten einschließen. * `--json`: JSON-Ausgabe drucken. `memory rem-harness`: REM-Reflexionen, Kandidatenwahrheiten und tiefe Promotion-Ausgabe in der Vorschau anzeigen, ohne etwas zu schreiben. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 drucken. ## Dreaming Dreaming ist das Hintergrundsystem zur Gedächtniskonsolidierung mit drei kooperativen Phasen: **light** (Kurzzeitmaterial 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. * Aus dem Chat mit `/dreaming on|off` umschalten (oder mit `/dreaming status` prüfen). Channel-Aufrufer müssen Eigentümer sein, um die Einstellung zu ändern; Gateway-Clients benötigen `operator.admin`. Schreibgeschützter Status und Hilfe bleiben für autorisierte Befehlsabsender verfügbar. * Dreaming läuft nach einem verwalteten Sweep-Zeitplan (`dreaming.frequency`) und führt Phasen in dieser Reihenfolge aus: light, REM, deep. * Nur die deep-Phase schreibt dauerhaftes Gedächtnis nach `MEMORY.md`. * Für Menschen lesbare Phasenausgabe und Tagebucheinträge werden in `DREAMS.md` (oder bestehendes `dreams.md`) geschrieben, mit optionalen Berichten pro Phase in `memory/dreaming//YYYY-MM-DD.md`. * Das Ranking verwendet gewichtete Signale: Recall-Häufigkeit, Abrufrelevanz, Abfragevielfalt, zeitliche Aktualität, Konsolidierung über Tage hinweg und abgeleitete konzeptuelle Reichhaltigkeit. * Die Promotion liest die aktuelle tägliche Notiz vor dem Schreiben nach `MEMORY.md` erneut, sodass bearbeitete oder gelöschte Kurzzeit-Snippets nicht aus veralteten Recall-Speicher-Snapshots promoted werden. * Geplante und manuelle `memory promote`-Läufe teilen dieselben Standardwerte der deep-Phase, sofern Sie keine CLI-Schwellenüberschreibungen übergeben. * Automatische Läufe werden über konfigurierte Gedächtnis-Workspaces aufgefächert. Standardplanung: * **Sweep-Taktung**: `dreaming.frequency = 0 3 * * *` * **Deep-Schwellenwerte**: `minScore=0.8`, `minRecallCount=3`, `minUniqueQueries=3`, `recencyHalfLifeDays=14`, `maxAgeDays=30` Beispiel: ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "plugins": { "entries": { "memory-core": { "config": { "dreaming": { "enabled": true } } } } } } ``` Hinweise: * `memory index --verbose` druckt Details pro Phase (Provider, Modell, Quellen, Batch-Aktivität). * `memory status` schließt alle zusätzlichen Pfade ein, die über `memorySearch.extraPaths` konfiguriert sind. * Wenn tatsächlich aktive Felder für Remote-API-Schlüssel des Gedächtnisses 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-Versionsabweichungen: Dieser Befehlspfad erfordert ein Gateway, das `secrets.resolve` unterstützt; ältere Gateways geben einen Fehler wegen unbekannter Methode zurück. * Passen Sie die geplante Sweep-Taktung mit `dreaming.frequency` an. Die Deep-Promotion-Richtlinie ist ansonsten intern, außer `dreaming.phases.deep.maxPromotedSnippetTokens`, das die Länge promoted Snippets begrenzt und dabei die Herkunft sichtbar hält. Verwenden Sie CLI-Flags bei `memory promote`, wenn Sie einmalige manuelle Schwellenüberschreibungen benötigen. * `memory rem-harness --path --grounded` zeigt fundierte `What Happened`, `Reflections` und `Possible Lasting Updates` aus historischen täglichen Notizen in der Vorschau an, ohne etwas zu schreiben. * `memory rem-backfill --path ` schreibt umkehrbare fundierte Tagebucheinträge zur UI-Prüfung in `DREAMS.md`. * `memory rem-backfill --path --stage-short-term` speist außerdem fundierte dauerhafte Kandidaten in den aktuellen Kurzzeit-Promotion-Speicher ein, sodass die normale deep-Phase sie bewerten kann. * `memory rem-backfill --rollback` entfernt zuvor geschriebene fundierte Tagebucheinträge, und `memory rem-backfill --rollback-short-term` entfernt zuvor bereitgestellte fundierte Kurzzeitkandidaten. * Siehe [Dreaming](/de/concepts/dreaming) für vollständige Phasenbeschreibungen und Konfigurationsreferenz. ## Verwandt * [CLI-Referenz](/de/cli) * [Gedächtnisübersicht](/de/concepts/memory)