Speicher Tiefenblick

Dieser Leitfaden behandelt die technischen Details von OpenClaws Speichersystem. Wenn Sie bereits den Leitfaden zur Verwaltung von Agenten-Speicher gelesen haben, geht diese Seite tiefer in die Engine-Abläufe, Suchfunktionalität und Konfiguration.

Die Speicher-Engine Architektur

OpenClaws Speichersystem basiert auf einer Datei-zuerst-Philosophie. Im Gegensatz zu undurchsichtigen Datenbank-Backends lebt der Speicher als einfache Markdown-Dateien in Ihrem Workspace, was Ihnen volle Sicht und Kontrolle gibt.

Kernelemente

• Datei-Lader: Liest und analysiert die acht automatisch geladenen Dateien beim Sitzungsstart
• Kontext-Injektor: Fügt Speicherinhalt in das Modell-Kontextfenster ein
• Speichersuche: Bietet semantische Suche über Speicherdateien
• QMD (Query Memory Doctor): Diagnose-Tool für Speicher-Gesundheitschecks
• Kontext-Kompaktor: Verwaltet Kontextfenster-Effizienz während Gesprächen

Speicher-Suchstrategien

Das memory_search-Tool ermöglicht semantische Abfragen über Ihren Speicherkorpus. Verstehen, wann und wie es verwendet wird, verbessert sowohl Geschwindigkeit als auch Genauigkeit.

Wann Speichersuche verwenden

• Bestimmte Informationen über viele Speicherdateien finden
• Verwandte Konzepte ohne exakte Schlüsselwörter finden
• Historische Entscheidungen oder vergangene Interaktionen abfragen
• Fragen beantworten, die mehrere Speicherquellen umfassen

Suchsyntax und Tipps

Effektive Speicher-Suchen erfordern gute Abfrageformulierung:

• Natürliche Fragen verwenden, keine Schlüsselwörter
• Specific über das Gesuchte sein
• maxResults-Parameter nutzen, um Antwortvolumen zu begrenzen
• minScore nutzen, um niedrige Übereinstimmungen herauszufiltern

Suchkorpus-Optionen

Das memory_search-Tool unterstützt verschiedene Korpus-Bereiche:

• memory: Nur über MEMORY.md und Tagesnotizen suchen
• wiki: Kompilierte Wiki-Ergänzungen durchsuchen (falls konfiguriert)
• all: Alle verfügbaren Quellen durchsuchen

Der QMD Memory Doctor

QMD (Query Memory Doctor) ist ein Diagnose-Tool, das Ihr Speicher-Setup analysiert. Es hilft, Probleme zu identifizieren, bevor sie Schäden verursachen.

Was QMD prüft

• Dateistruktur-Gültigkeit
• Größe und Überladung-Erkennung
• Fehlende Dateireferenzen
• Inkonsistente Formatierung
• Erkennung von veraltetem Inhalt

QMD ausführen

QMD wird über das memory_search-Tool mit speziellen Abfragen aufgerufen. Das Tool leitet automatisch diagnostische Anfragen an QMD-Funktionalität weiter, wenn erkannt.

Speicher-Konfigurationsreferenz

Während Speicherdateien die primäre Konfiguration sind, gibt es Engine-Einstellungen, die das Speicherverhalten beeinflussen.

Automatisch geladene Dateien Referenz

Optimierungs-Empfehlungen

• Automatisch geladene Dateien unter 10 KB halten für schnellste Bootzeiten
• Tagesnotizen für transienten Kontext nutzen, nicht MEMORY.md
• MEMORY.md monatlich überprüfen und bereinigen
• Alte Tagesnotizen archivieren, um Suchüberladung zu vermeiden

Kontextfenster-Überlegungen

Jedes Byte in Speicherdateien verbraucht Kontext-Token. Dieses Verhältnis zu verstehen hilft bei der Leistungsoptimierung.

Token-Budget für Speicher

Als grobe Richtlinie:

• 1 KB Text entspricht ca. 300-400 Token
• Die acht automatisch geladenen Dateien nutzen typischerweise 1500-3000 Token
• Speicher-Suchergebnisse fügen zusätzlichen Kontext pro Abfrage hinzu

Persistence und Leistung abwägen

Mehr Speicherinhalt bedeutet:

• Langsamerer Sitzungsstart
• Höhere pro-Nachricht Token-Kosten
• Mehr Kontextspace verwendet, bevor Ihr Gespräch beginnt

Finden Sie die Balance, die für Ihren Anwendungsfall funktioniert. Interaktive Sitzungen profitieren von schlankerem Speicher. Komplexe Aufgaben können umfassenderes Laden rechtfertigen.

Fortgeschritten: Eigene Suchkorpora

Für fortgeschrittene Setups können Sie zusätzliche Suchquellen über die Standard-Speicherdateien hinaus konfigurieren.

Wiki-Ergänzungen

Kompilierter Wiki-Inhalt kann als zusätzlicher Suchkorpus registriert werden. Nützlich für:

• Produktdokumentation
• Codebase-Referenzen
• Externe Wissensdatenbanken

Speicher-Probleme beheben

Häufige Probleme und Lösungen

• Agent findet Informationen nicht: memory_search nutzen, um Inhalt zu finden, dann prüfen ob in richtiger Datei
• Langsamer Start: Automatisch geladene Dateigrößen reduzieren
• Inkonsistentes Verhalten: SOUL.md auf widersprüchliche Regeln prüfen
• Verlorener Kontext: Wichtige Info zu MEMORY.md speichern, nicht nur Chat

Sicherheits-Überlegungen

Speicherdateien enthalten möglicherweise sensible Informationen. Beachten Sie diese Sicherheitspraktiken:

• Keine Anmeldedaten oder API-Schlüssel in Speicherdateien speichern
• Umgebungsvariablen und TOOLS.md für Geheimnisse nutzen
• Vor dem Teilen prüfen, was in Kontext eingeschlossen wird
• Workspace-Zugriffskontrollen für gemeinsame Setups in Betracht ziehen