Referenz zur Speicherkonfiguration

Diese Seite führt alle Konfigurationsoptionen für die OpenClaw-Speichersuche auf. Konzeptionelle Übersichten finden Sie unter:

Alle gemeinsamen Speichereinstellungen befinden sich unter memory auf oberster Ebene in openclaw.json. Suchstandards verwenden memory.search; agentenspezifische Suchüberschreibungen verwenden agents.entries.*.memory.search.

Gesprächsübergreifend erinnern

Konfigurieren Sie dies agentenspezifisch, wenn nur ein vertrauenswürdiger persönlicher Agent den gesprächsübergreifenden Transkriptabruf verwenden soll:

{  agents: {    entries: {      personal: {        memory: {          search: {            rememberAcrossConversations: true,          },        },      },    },  },}

Der Wert folgt der normalen Vererbung von memory.search mit einer agentenspezifischen Überschreibung. Wenn er nicht gesetzt ist, ist er standardmäßig nur aktiviert, wenn das globale session.dmScope nicht gesetzt oder "main" ist und keine Bindung eine session.dmScope-Überschreibung besitzt. Jede konfigurierte DM-Isolierung deaktiviert ihn standardmäßig. Ein explizites true oder false hat immer Vorrang. Die Aktivierung impliziert die Indizierung von Sitzungstranskripten und fügt sessions zu den aufgelösten Speicherquellen des Agenten hinzu. Bei QMD aktiviert sie außerdem den Sitzungsexport dieses Agenten; für diesen Modus ist keine separate Einstellung memory.qmd.sessions.enabled erforderlich.

Der integrierte Speicher-Provider von OpenClaw unterstützt diesen geschützten Pfad sowohl mit dem integrierten als auch mit dem QMD-Backend. Alternative Speicher-Provider können weiterhin ihre eigenen Abruf-Hooks und erweiterten Active-Memory-Werkzeuge verwenden, diese Einstellung wird jedoch übersprungen, sofern der aktuelle Provider keinen geschützten Abruf privater Transkripte unterstützt. openclaw doctor meldet einen nicht unterstützten Provider oder eine explizite Active-Memory-Liste toolsAllow, in der memory_search fehlt.

Die Abrufgrenze ist enger als bei der allgemeinen Sitzungssuche:

• nur erkannte private Gespräche desselben Agenten sind zulässig
• das aktuell beantwortete Gespräch ist ausgeschlossen
• Gruppen und Kanäle sind als Quellen und Ziele ausgeschlossen
• unbekannte Gesprächsarten werden standardmäßig abgelehnt
• der Abruf in einer Sandbox kann die spezielle gesprächsübergreifende Autorisierung nicht verwenden

Die Einstellung ändert weder tools.sessions.visibility noch Sitzungsschlüssel, Transkriptspeicherung, Zustellungsrouting oder die Berechtigungen von sessions_list, sessions_history und sessions_send. Active Memory führt einen begrenzten, schreibgeschützten Abrufdurchlauf aus; ein nicht verfügbarer oder wegen Zeitüberschreitung abgebrochener Abruf blockiert die Antwort nicht.

Provider-Auswahl

Wenn provider nicht gesetzt ist, verwendet OpenClaw OpenAI-Embeddings. Legen Sie provider explizit fest, um Bedrock, DeepInfra, Gemini, GitHub Copilot, Mistral, Ollama, Voyage, ein lokales GGUF-Modell oder einen OpenAI-kompatiblen /v1/embeddings-Endpunkt zu verwenden. Legacy-Konfigurationen, die noch provider: "auto" angeben, werden als openai aufgelöst.

Wenn provider nicht gesetzt ist, das veraltete provider: "auto" vorhanden ist oder provider: "none" absichtlich den reinen FTS-Modus auswählt, kann der Speicherabruf weiterhin die lexikalische FTS-Rangfolge verwenden, wenn Embeddings nicht verfügbar sind.

Explizite nicht lokale Provider werden standardmäßig abgelehnt. Wenn Sie memory.search.provider auf einen konkreten, remote angebundenen Provider wie Bedrock, DeepInfra, Gemini, GitHub Copilot, LM Studio, Mistral, Ollama, OpenAI, Voyage oder einen OpenAI-kompatiblen benutzerdefinierten Provider setzen und dieser Provider zur Laufzeit nicht verfügbar ist, gibt memory_search ein Ergebnis des Typs „nicht verfügbar“ zurück, statt unbemerkt einen reinen FTS-Abruf zu verwenden. Korrigieren Sie die Provider-/Authentifizierungskonfiguration, wechseln Sie zu einem erreichbaren Provider oder setzen Sie provider: "none", wenn Sie bewusst einen reinen FTS-Abruf verwenden möchten.

Benutzerdefinierte Provider-IDs

memory.search.provider kann auf einen benutzerdefinierten models.providers.<id>-Eintrag für speicherspezifische Provider-Adapter wie ollama oder für OpenAI-kompatible Modell-APIs wie openai-responses / openai-completions verweisen. OpenClaw löst den api-Owner dieses Providers für den Embedding-Adapter auf und behält dabei die benutzerdefinierte Provider-ID für die Verarbeitung von Endpunkt, Authentifizierung und Modellpräfix bei. Dadurch können Multi-GPU- oder Multi-Host-Konfigurationen Speicher-Embeddings einem bestimmten lokalen Endpunkt zuweisen:

{  models: {    providers: {      "ollama-5080": {        api: "ollama",        baseUrl: "http://gpu-box.local:11435",        apiKey: "ollama-local",        models: [{ id: "qwen3-embedding:0.6b", name: "Qwen3 Embedding 0.6B" }],      },    },  },  memory: {    search: {      provider: "ollama-5080",      model: "qwen3-embedding:0.6b",    },  },}

Auflösung des API-Schlüssels

Remote-Embeddings erfordern einen API-Schlüssel. Bedrock verwendet stattdessen die standardmäßige Anmeldedatenkette des AWS SDK (Instanzrollen, SSO, Zugriffsschlüssel oder einen Bedrock-API-Schlüssel).

Konfiguration des Remote-Endpunkts

Verwenden Sie provider: "openai-compatible" für einen generischen OpenAI-kompatiblen /v1/embeddings-Server, der keine globalen OpenAI-Chat-Anmeldedaten erben soll.

{  memory: {    search: {      provider: "openai-compatible",      model: "text-embedding-3-small",      remote: {        baseUrl: "https://api.example.com/v1/",        apiKey: "YOUR_KEY",      },    },  },}

Providerspezifische Konfiguration

{  memory: {    search: {      provider: "openai-compatible",      remote: {        baseUrl: "https://embeddings.example/v1",        apiKey: "${EMBEDDINGS_API_KEY}",      },      model: "asymmetric-embedder",      queryInputType: "query",      documentInputType: "passage",    },  },}

{  memory: {    search: {      provider: "bedrock",      model: "amazon.titan-embed-text-v2:0",    },  },}

{  "Effect": "Allow",  "Action": "bedrock:InvokeModel",  "Resource": "*"}

arn:aws:bedrock:*::foundation-model/amazon.titan-embed-text-v2:0

openclaw memory status --deep --agent mainopenclaw memory index --force --agent main

Indexierungsverhalten

Speicher-Engines verwalten Synchronisierung, Batch-Verarbeitung, Überwachung und Indexierungsheuristiken nach der Compaction. OpenClaw hält diese Verhaltensweisen mit gepflegten Standardwerten aktiviert, anstatt installationsspezifische Zeitsteuerungsoptionen bereitzustellen.

Konfiguration der hybriden Suche

Alle unter memory.search.query:

Der hybride Abruf bleibt aktiviert; MMR und zeitlicher Zerfall bleiben durch die integrierte Engine-Richtlinie deaktiviert.

Vollständiges Beispiel

{  memory: {    search: {      query: {        maxResults: 6,        minScore: 0.35,      },    },  },}

Zusätzliche Speicherpfade

{  memory: {    search: {      extraPaths: ["../team-docs", "/srv/shared-notes"],    },  },}

Pfade können absolut oder relativ zum Arbeitsbereich sein. Verzeichnisse werden rekursiv nach .md-Dateien durchsucht. Die Behandlung symbolischer Verknüpfungen hängt vom aktiven Backend ab: Die integrierte Engine überspringt symbolische Verknüpfungen, während QMD dem Verhalten des zugrunde liegenden QMD-Scanners folgt.

Verwenden Sie für die agentenspezifische, agentenübergreifende Transkriptsuche agents.entries.*.memory.search.qmd.extraCollections anstelle von memory.qmd.paths. Diese zusätzlichen Sammlungen folgen derselben { path, name, pattern? }-Struktur, werden jedoch pro Agent zusammengeführt und können explizite gemeinsam verwendete Namen beibehalten, wenn der Pfad außerhalb des aktuellen Arbeitsbereichs liegt. Wenn derselbe aufgelöste Pfad sowohl in memory.qmd.paths als auch in memory.search.qmd.extraCollections vorkommt, behält QMD den ersten Eintrag bei und überspringt das Duplikat.

Multimodaler Speicher (Gemini)

Indexieren Sie Bilder und Audiodateien zusammen mit Markdown mithilfe von Gemini Embedding 2:

Unterstützte Formate: .jpg, .jpeg, .png, .webp, .gif, .heic, .heif (Bilder); .mp3, .wav, .ogg, .opus, .m4a, .aac, .flac (Audio).

Embedding-Cache

Verhindert, dass unveränderter Text bei einer Neuindexierung oder bei Transkriptaktualisierungen erneut eingebettet wird.

Batch-Indexierung

Verfügbar für gemini, openai und voyage. Die Batch-Verarbeitung von OpenAI ist bei umfangreichen Nachindexierungen üblicherweise am schnellsten und kostengünstigsten.

Parallelität, Abfrageintervalle und Zeitüberschreitungsverhalten werden vom Provider verwaltet.

Sitzungsspeichersuche

Indexieren Sie Sitzungstranskripte und stellen Sie sie über memory_search bereit:

Die gewöhnliche, vom Modell aufgerufene Suche in Sitzungstranskripten richtet sich nach tools.sessions.visibility. Die standardmäßige Sichtbarkeit tree umfasst die aktuelle Sitzung, von ihr gestartete Sitzungen und Gruppensitzungen desselben Agenten, die über die implizite Gruppenwahrnehmung beobachtet werden. Andere, nicht zusammenhängende Sitzungen erfordern die Sichtbarkeit agent (oder all nur, wenn auch agentenübergreifender Abruf erforderlich ist und die Agent-zu-Agent-Richtlinie dies zulässt).

rememberAcrossConversations erweitert diese Einstellung nicht. Es stellt eine separate, nur zur Laufzeit gültige Autorisierung bereit, die während des begrenzten Active-Memory-Durchlaufs auf private Transkripte desselben Agenten beschränkt ist.

Die folgenden Beispiele platzieren diese Einstellungen unter memory.search auf oberster Ebene. Sie können entsprechende Einstellungen auch in einer agentenspezifischen Überschreibung memory.search anwenden, wenn nur ein Agent Sitzungstranskripte indizieren und durchsuchen soll.

Für den Abruf vom Gateway in Direktnachrichten durch denselben Agenten:

{  memory: {    search: {      experimental: { sessionMemory: true },      sources: ["memory", "sessions"],    },  },  tools: {    sessions: { visibility: "agent" },  },}

{  memory: {    backend: "qmd",    search: {      experimental: { sessionMemory: true },      sources: ["memory", "sessions"],    },    qmd: {      sessions: { enabled: true },    },  },  tools: {    sessions: { visibility: "agent" },  },}

Bei Verwendung von QMD exportiert sources: ["sessions"] Transkripte nicht von selbst nach QMD. Legen Sie zusätzlich memory.qmd.sessions.enabled: true fest. Die übergeordnete Einstellung rememberAcrossConversations: true bildet die Ausnahme: Sie impliziert den erforderlichen QMD-Sitzungsexport für diesen Agenten. Implizite Exporte bleiben privat: Sie verwenden immer den standardmäßigen internen Exportspeicherort (ein konfiguriertes sessions.exportDir gilt nur für explizite Exporte), werden nur beim konversationsübergreifenden Abruf dieses Agenten durchsucht und können von gewöhnlichem memory_get nicht gelesen werden. Explizites memory.qmd.sessions.enabled: true behält sein bestehendes Verhalten bei und macht exportierte Transkripte zu einem Teil des gewöhnlichen Speicherkorpus.

SQLite-Vektorbeschleunigung (sqlite-vec)

Wenn sqlite-vec nicht verfügbar ist, greift OpenClaw automatisch auf die prozessinterne Kosinusähnlichkeit zurück.

Indexspeicherung

Integrierte Speicherindizes befinden sich in der OpenClaw-SQLite-Datenbank des jeweiligen Agenten unter agents/<agentId>/agent/openclaw-agent.sqlite.

QMD-Backend-Konfiguration

Legen Sie zum Aktivieren memory.backend = "qmd" fest. Alle QMD-Einstellungen befinden sich unter memory.qmd:

searchMode: "search" arbeitet ausschließlich lexikalisch bzw. mit BM25. OpenClaw führt für diesen Modus keine semantischen Prüfungen der Vektorbereitschaft oder Wartung von QMD-Einbettungen aus, auch nicht während memory status --deep; vsearch und query erfordern weiterhin die QMD-Vektorbereitschaft und Einbettungen.

rerank: false ändert nur den QMD-Modus query und erfordert QMD 2.1 oder neuer. Im direkten CLI-Modus übergibt OpenClaw --no-rerank; im mcporter-basierten MCP-Modus übergibt es rerank: false an das vereinheitlichte Abfragewerkzeug von QMD. Lassen Sie die Einstellung weg, um das standardmäßige QMD-Reranking für Abfragen zu verwenden.

OpenClaw bevorzugt aktuelle QMD-Sammlungs- und MCP-Abfrageformate, unterstützt jedoch weiterhin ältere QMD-Versionen, indem es bei Bedarf kompatible Flags für Sammlungsmuster und ältere MCP-Werkzeugnamen ausprobiert. Wenn QMD die Unterstützung mehrerer Sammlungsfilter angibt, werden Sammlungen derselben Quelle mit einem einzigen QMD-Prozess durchsucht; ältere QMD-Builds behalten den Kompatibilitätspfad pro Sammlung bei. „Dieselbe Quelle“ bedeutet, dass dauerhafte Speichersammlungen (standardmäßige Speicherdateien sowie benutzerdefinierte Pfade) zusammen gruppiert werden, während Sammlungen von Sitzungstranskripten eine separate Gruppe bleiben, sodass der Diversifizierung nach Quellen weiterhin beide Eingaben zur Verfügung stehen.

{  memory: {    qmd: {      scope: {        default: "deny",        rules: [{ action: "allow", match: { chatType: "direct" } }],      },    },  },}

QMD wird verzögert initialisiert, wenn der Speicher erstmals verwendet wird; sein Adapter verwaltet die Zeitpläne für Aktualisierungen und Einbettungen.

Vollständiges QMD-Beispiel

{  memory: {    backend: "qmd",    citations: "auto",    qmd: {      includeDefaultMemory: true,      update: { interval: "5m", debounceMs: 15000 },      limits: { maxResults: 4, timeoutMs: 4000 },      scope: {        default: "deny",        rules: [{ action: "allow", match: { chatType: "direct" } }],      },      paths: [{ name: "docs", path: "~/notes", pattern: "**/*.md" }],    },  },}

Dreaming

Dreaming wird unter plugins.entries.memory-core.config.dreaming konfiguriert, nicht unter memory.search.

Dreaming wird als ein geplanter Durchlauf ausgeführt und verwendet interne Leicht-/Tief-/REM-Phasen als Implementierungsdetail.

Informationen zum konzeptionellen Verhalten und zu Slash-Befehlen finden Sie unter Dreaming.

Benutzereinstellungen

Beispiel

{  plugins: {    entries: {      "memory-core": {        subagent: {          allowModelOverride: true,          allowedModels: ["anthropic/claude-sonnet-4-6"],        },        config: {          dreaming: {            enabled: true,            frequency: "0 3 * * *",            model: "anthropic/claude-sonnet-4-6",          },        },      },    },  },}

Verwandte Themen

• Konfigurationsreferenz
• Speicherübersicht
• Speichersuche