Referenz zur Speicherkonfiguration

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

Alle gemeinsamen Speichereinstellungen befinden sich unter dem übergeordneten memory in openclaw.json. Suchstandards verwenden memory.search; agentspezifische Suchüberschreibungen verwenden agents.entries.*.memory.search.

Gesprächsübergreifend erinnern

Konfigurieren Sie dies pro Agent, wenn nur ein vertrauenswürdiger persönlicher Agent den gesprächsübergreifenden Abruf von Transkripten verwenden soll:

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

Der Wert folgt der normalen Vererbung von memory.search mit einer agentspezifischen Überschreibung. Wenn er nicht festgelegt ist, wird er nur standardmäßig aktiviert, wenn global session.dmScope nicht festgelegt oder "main" ist und keine Bindung eine session.dmScope-Überschreibung enthält. Jede konfigurierte DM-Isolierung deaktiviert ihn standardmäßig. Ein explizites true oder false hat immer Vorrang. Die Aktivierung schließt die Indizierung von Sitzungstranskripten ein und fügt sessions zu den aufgelösten Speicherquellen des Agent hinzu. Mit QMD wird außerdem der Sitzungsexport dieses Agent aktiviert; 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, wenn der aktuelle Provider den geschützten Abruf privater Transkripte nicht 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 Agent kommen infrage
• das gerade 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 zeitüberschrittener Abruf blockiert die Antwort nicht.

Provider-Auswahl

Wenn provider nicht festgelegt 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. Veraltete Konfigurationen, die weiterhin provider: "auto" angeben, werden als openai aufgelöst.

Wenn provider nicht festgelegt 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.

Explizit angegebene nicht lokale Provider werden standardmäßig abgelehnt. Wenn Sie memory.search.provider auf einen konkreten, remote gestützten 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 Nichtverfügbarkeitsergebnis zurück, anstatt stillschweigend ausschließlich den FTS-Abruf zu verwenden. Korrigieren Sie die Provider-/Authentifizierungskonfiguration, wechseln Sie zu einem erreichbaren Provider oder legen Sie provider: "none" fest, wenn Sie bewusst ausschließlich den 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-Eigentümer dieses Providers für den Embedding-Adapter auf und behält gleichzeitig 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 AWS-SDK-Anmeldedatenkette (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 die globalen OpenAI-Chat-Anmeldedaten nicht übernehmen 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 Zeitsteuerungen bereitzustellen.

Konfiguration der hybriden Suche

Alle unter memory.search.query:

Die hybride Abfrage bleibt aktiviert; MMR und zeitlicher Verfall bleiben gemäß der integrierten 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 Workspace sein. Verzeichnisse werden rekursiv nach .md-Dateien durchsucht. Die Behandlung symbolischer Links hängt vom aktiven Backend ab: Die integrierte Engine überspringt symbolische Links, während QMD dem Verhalten des zugrunde liegenden QMD-Scanners folgt.

Verwenden Sie für eine 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 gemeinsame Namen beibehalten, wenn der Pfad außerhalb des aktuellen Workspace 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 und überspringt das Duplikat.

Multimodaler Speicher (Gemini)

Indexieren Sie Bilder und Audiodateien neben Markdown mit 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 bei einer Neuindexierung oder bei Transkriptaktualisierungen die erneute Einbettung unveränderten Textes.

Batch-Indexierung

Verfügbar für gemini, openai und voyage. OpenAI Batch ist bei großen Nachbefüllungen in der Regel am schnellsten und kostengünstigsten.

Nebenläufigkeit, Abfrageintervalle und Timeout-Verhalten 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 folgt tools.sessions.visibility. Die standardmäßige Sichtbarkeit tree umfasst die aktuelle Sitzung, von ihr gestartete Sitzungen und über die implizite Gruppenwahrnehmung beobachtete Gruppensitzungen desselben Agenten. Andere, nicht zugehörige Sitzungen erfordern die Sichtbarkeit agent (oder all nur, wenn zusätzlich agentenübergreifender Abruf erforderlich ist und die Agent-zu-Agent-Richtlinie dies zulässt).

rememberAcrossConversations erweitert diese Einstellung nicht. Es stellt eine separate, ausschließlich zur Laufzeit geltende 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 desselben Agenten vom Gateway zu Direktnachrichten:

{  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"] allein keine Transkripte 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 sitzungsü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 Bestandteil 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 jedes Agenten unter agents/<agentId>/agent/openclaw-agent.sqlite.

QMD-Backend-Konfiguration

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

searchMode: "search" verwendet ausschließlich lexikalische/BM25-Suche. OpenClaw führt für diesen Modus keine Bereitschaftsprüfungen semantischer Vektoren und keine QMD-Embedding-Wartung aus, auch nicht während memory status --deep; vsearch und query erfordern weiterhin QMD-Vektorbereitschaft und Embeddings.

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

OpenClaw bevorzugt die aktuellen QMD-Sammlungs- und MCP-Abfragestrukturen, unterstützt jedoch weiterhin ältere QMD-Versionen, indem es bei Bedarf kompatible Muster-Flags für Sammlungen 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 verwenden weiterhin den Kompatibilitätspfad pro Sammlung. Dieselbe Quelle bedeutet, dass dauerhafte Speichersammlungen (standardmäßige Speicherdateien plus benutzerdefinierte Pfade) zusammen gruppiert werden, während Sammlungen von Sitzungstranskripten eine separate Gruppe bleiben, damit die Quellendiversifizierung weiterhin beide Eingaben umfasst.

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

QMD wird bei der ersten Speichernutzung verzögert initialisiert; der Adapter verwaltet die Zeitpläne für Aktualisierungen und Embeddings.

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 Light-/Deep-/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