Agenten-Speicher & Kontext verwalten

OpenClaw nimmt einen Datei-first-Ansatz für Speicher. Im Gegensatz zu cloud-basierten KI-Assistenten, die alles auf Remote-Servern speichern, speichert OpenClaw Kern-Kognitionszustände, Identität und Wissen in Klartext-Markdown-Dateien in deinem Workspace. Das gibt dir vollständige Transparenz und Eigentum über den Speicher deines Agenten.

Das Verstehen dieser Speicherarchitektur ist essentiell für den Aufbau zuverlässiger, persistenter Agenten, die sich daran erinnern, was du ihnen sagst, und über Sitzungen hinweg konsistent bleiben.

Die acht automatisch geladenen Dateien

OpenClaw lädt automatisch acht spezifische Dateinamen beim Boot. Diese Dateien werden beim Start jeder Sitzung in den Kontext des Agenten injiziert, was sie zur Grundlage des Wissens und der Identität deines Agenten macht:

• SOUL.md - Kern-Identität, Persönlichkeit, Ton und harte Regeln
• AGENTS.md - Operative Anweisungen und Routing-Regeln
• USER.md - Was der Agent über dich weiß (Präferenzen, Kontext)
• TOOLS.md - Umgebungsspezifische Tool-Konfigurationen
• IDENTITY.md - Agenten-Name, Emoji und Markenbeschreibung
• HEARTBEAT.md - Heartbeat-Automatisierungsregeln und Zeitpläne
• BOOTSTRAP.md - Initiale System-Bootstrapping-Anweisungen
• MEMORY.md - Langfristig kuratierte Fakten und Wissen

Kritisches Wissen, das dein Agent in jeder Sitzung wissen muss, gehört in eine dieser Dateien. Benutzerdefinierte Dateinamen werden nicht automatisch injiziert, selbst wenn sie auf der Festplatte existieren.

SOUL.md verstehen

SOUL.md ist die wichtigste Datei in deinem OpenClaw-Setup. Es definiert, wer dein Agent ist. Denke daran als eine Verfassung für deinen Agenten, nicht als eine Persönlichkeits-quirk-Liste.

Was in SOUL.md gehört

• Name und Rolle - "Du bist Aria, ein Kundensupport-Agent für Meridian SaaS"
• Ton und Kommunikationsstil - Direkt, freundlich, geduldig, gibt zu, wenn Informationen fehlen
• Harte Grenzen und Sicherheits-Invariante - "Diskutiere niemals Competitor-Preise", "Empfehle immer einen Profi für rechtliche Fragen"
• Kernverhalten - "Lehre zuerst, verkaufe zweit", "Zitiere immer Quellen"
• Kosten-Guardrails - Regeln über Token-Nutzung und API-Aufruf-Limits
• Speicher-Regeln - Anweisungen, was zu erinnern ist und wie

Was NICHT in SOUL.md gehört

• Mission Statements oder "Persönlichkeits-Füller"
• Detaillierte Task-Anweisungen (tu die in AGENTS.md oder MEMORY.md)
• Projekt-spezifischer Kontext (tu den in Tagesnotizen)
• Benutzer-Präferenzen (tu die in USER.md)

SOUL.md Best Practices

• Behandle es als nicht-verhandelbare Regeln, nicht als Vorschläge
• Füge explizite Regeln hinzu, die Überschreibungen verbieten, um Manipulation zu verhindern
• Halte es stabil - häufige Änderungen deuten auf eine instabile Identität hin
• Konzentriere dich auf Vertrauensgrenzen, Tool-Limits und Genehmigungsanforderungen

MEMORY.md verstehen

MEMORY.md ist, wo du kuratierte, dauerhafte Fakten speicherst, die über Sitzungen hinweg bestehen sollten. Im Gegensatz zu Tagesnotizen, die ephemer sind, enthält MEMORY.md Wissen, zu dem dein Agent immer Zugang haben sollte.

Was in MEMORY.md gehört

• Bevorzugte Antwortformate und Stile
• Laufende Projekte und ihren aktuellen Stand
• Tool-Standards und Konfigurationen
• Regeln, die konsistent über die Zeit gelten sollten
• Wichtige Fakten über deine Arbeit oder dein Business
• Wiederkehrende Muster und Präferenzen

MEMORY.md vs Tagesnotizen

Denke so daran:

• MEMORY.md = dauerhafte Wahrheiten (wie eine Enzyklopädie)
• memory/YYYY-MM-DD.md = laufender Kontext (wie ein Tagebuch)

Tagesnotizen erfassen, was heute passiert ist, aktuelle Projekte und temporären Kontext. MEMORY.md speichert, was für immer wahr sein sollte. Halte MEMORY.md prägnant und fokussiert auf dauerhafte Wahrheiten.

USER.md: Dein Agent weiß über dich

USER.md ist spezifisch für das, was der Agent über dich weiß. Das beinhaltet deine Kommunikationspräferenzen, Zeitzone, relevanten Kontext über deine Arbeit, und alles andere, das dem Agenten hilft, dir besser zu dienen.

USER.md hat keine strikte Größenlimitierung und ist die Anlaufstelle für benutzerspezifisches Wissen. Wenn dein Agent etwas über dich wissen muss, das über Sitzungen hinweg bestehen sollte, ist USER.md der richtige Ort.

Die drei-Schichten-Speicher-Architektur

Community-entwickelte Best-Practice organisiert Speicher in drei Schichten:

Schicht 1: Kern-Identität (SOUL.md)

Wer der Agent ist. Stabil, ändert sich selten. Definiert Persönlichkeit und nicht-verhandelbare Regeln.

Schicht 2: Langfristiger operationeller Speicher (MEMORY.md + AGENTS.md)

Wie der Agent arbeitet. Präferenzen, Muster, laufende Projekte. Aktualisiert sich ab und zu, aber nicht häufig.

Schicht 3: Flüchtiger Speicher (Tagesnotizen)

Was gerade passiert. Heutige Tasks, recenter Kontext, temporäre Informationen. Wird zurückgesetzt oder archiviert nach jedem Tag.

Kontextverlust verhindern

Kontextverlust ist eine der häufigsten Beschwerden über OpenClaw. So verhinderst du ihn:

Pre-Compaction Memory Flush

Bevor das Kontextfenster voll wird, speichere explizit wichtige Informationen in MEMORY.md. Du kannst deinen Agenten bitten, "was wir besprochen haben in MEMORY.md speichern", bevor die Grenzen erreicht werden.

Die richtige Datei für den richtigen Zweck nutzen

Wenn du deinem Agenten etwas Wichtiges im Chat sagst, das er sich dauerhaft merken soll, sage explizit "Merke dir das für zukünftige Sitzungen - füge es zu MEMORY.md hinzu." Geh nicht davon aus, dass es sich erinnert.

Kontextfenster-Guards

Füge Regeln in AGENTS.md hinzu, die den Agenten daran erinnern, wichtige Informationen periodisch in Speicherdateien zu konsolidieren, bevor der Kontext zu voll wird.

Gestaffelte Zusammenfassung

Für langlaufende Projekte, erstelle Zusammenfassungs-Notizen in MEMORY.md bei wichtigen Meilensteinen, anstatt dich auf die volle Gesprächshistorie zu verlassen.

Speicher-Schutz-Stack

Der Speicher-Schutz-Stack ist eine Reihe von Praktiken, um den Speicher deines Agenten sicher und zuverlässig zu halten:

• In-File-Schreibregeln: Füge Regeln in Speicherdateien hinzu, dass der Agent sie nicht ohne explizite Erlaubnis modifizieren sollte
• SOUL.md Verhaltensregeln: Verbietet explizit Überschreibungen in SOUL.md
• AGENTS.md Routing: Nutze AGENTS.md um "erinnern"-Anfragen entsprechend zu routen
• Automatisierte Backups: Sichere regelmäßig Speicherdateien
• Größenprüfungen: Überwache Speicherdatei-Größen und erkenne unerwartete Änderungen
• Auto-Wiederherstellung bei Löschen: Habe einen Prozess, um von Backup wiederherzustellen, wenn Speicher gelöscht wird

Häufige Speicherfehler zu vermeiden

• Sich nur auf Chat verlassen: Wenn es wichtig ist, tu es in eine Datei
• Benutzerdefinierte Dateinamen nutzen: OpenClaw lädt nur die 8 spezifischen Dateien automatisch
• Symlinks: Sie werden blockiert - nutze nur echte Dateien
• Zu viel in Tagesnotizen: Wichtige Infos gehen verloren, wenn Notizen archiviert werden
• SOUL.md zu oft ändern: Es destabilisiert die Identität des Agenten
• Projekt-Details in SOUL.md tun: Nutze MEMORY.md oder Tagesnotizen stattdessen

Versionskontrolle für Speicher

Integriere deinen OpenClaw Workspace mit Git. Das gibt dir:

• Historie der Änderungen an Speicherdateien
• Einfaches Wiederherstellen zu vorherigen Versionen
• Backup und Redundanz
• Erkennung von unerwarteten Modifikationen

Zuverlässige Speicher-Gewohnheiten aufbauen

Der Speicher deines Agenten ist nur so gut wie das, was du reinsteckst. Baue diese Gewohnheiten:

1. Wenn du deinem Agenten etwas Wichtiges sagst, weise ihn explizit an, es in die entsprechende Datei zu speichern
2. Überprüfe und bereinige regelmäßig MEMORY.md, um Bloating zu verhindern
3. Am Ende signifikanter Sitzungen, lass den Agenten wichtige Punkte zu MEMORY.md zusammenfassen
4. Nutze Tagesnotizen für laufenden Kontext, aber konsolidiere wichtige Punkte zu MEMORY.md
5. Überprüfe periodisch, ob Speicherdateien enthalten, was du erwartest

OpenClaws Datei-first-Speicheransatz gibt dir Transparenz und Kontrolle, die Cloud-basierte Systeme nicht bieten können. Nutze das, indem du absichtlich bist, wohin was gehört.