OpenClaw-Speicher erklärt: Architektur, Einrichtung und warum es vergisst

Die vollständige OpenClaw-Speicherarchitektur (3 Schichten erklärt)

Der OpenClaw-Speicher arbeitet auf drei verschiedenen Ebenen mit jeweils unterschiedlichen Persistenzeigenschaften und Fehlermodi.

Vollständiger Speicherlebenszyklus:

Write → Embed/Index → Search → Compact → Recover
  ↓          ↓           ↓         ↓         ↓
.md file   sqlite-vec  semantic  summary   MEMORY.md
created    indexes it  query     replaces  re-read at
           on save     returns   context   session start
                       chunks    window

Jede Stufe in dieser Kette kann unabhängig voneinander scheitern. Die meisten Vergessensprobleme sind auf genau eine defekte Stufe zurückzuführen.

Ebene 1 – Das aktive Kontextfenster

Dies ist der Arbeitsspeicher des Modells: alles, was derzeit für die aktive Konversation in das Kontextfenster geladen wird. Dazu gehören Ihre Systemeingabeaufforderung, der Konversationsverlauf und alle vom Suchtool abgerufenen Speicherblöcke.

Was füllt es aus:

• Systemaufforderung (oft groß)
• Erinnerungsauszüge abgerufen
• Verlauf der Werkzeugaufrufe
• Das Gespräch dreht sich

Praktische Grenze: Gehen Sie davon aus, dass etwa 60–70 % des angekündigten Kontextfensters des Modells für die tatsächliche Konversation nach der Systemaufforderung und dem Speicheraufwand zur Verfügung stehen.

Ebene 2 – Tägliche Notizen (Das rollierende Zwei-Tage-Fenster)

Tägliche Notizen sind Markdown-Dateien, die nur angehängt werden können und im Format YYYY-MM-DD benannt sind und in Ihrem Verzeichnis memory/ gespeichert sind. OpenClaw wird geladen heute und gestern Dateien automatisch zu Beginn jeder Sitzung.

• Hier werden Fakten über die heutige Arbeit, getroffene Entscheidungen und aktive Aufgaben angehängt
• Sie sind nicht zum Bearbeiten gedacht – behandeln Sie sie als Protokoll
• Nach zwei Tagen verlassen sie das automatische Ladefenster und können nur noch über die semantische Suche durchsucht werden

Schicht 3 – Dauerhafter Speicher (MEMORY.md und Memory-Wiki)

Langfristige Fakten, die sitzungsübergreifend erhalten bleiben sollten – Ihr Name, Projektkontext, Codierungspräferenzen, Architekturentscheidungen – gehören in MEMORY.md oder den strukturierten Plugin-Tresor memory-wiki.

Das Verdichtungsproblem – Warum Ihre Anweisungen mitten in der Aufgabe verschwinden

Komprimierung ist der am wenigsten dokumentierte Fehlermodus in OpenClaw. In den meisten Artikeln geht es um das Vergessen nach der Sitzung. Fast keine Adresse Komprimierung in der Mitte der Aufgabe in lang andauernden autonomen Arbeitsabläufen – Wenn der Agent eine mehrstufige Aufgabe ausführt, wird die Komprimierung lautlos bei Schritt 7 von 12 ausgelöst und die Verhaltensanweisungen aus Schritt 1 sind verschwunden.

Was bewirkt die Komprimierung:

1. Erkennt, dass sich das Kontextfenster der Kapazität nähert
2. Fasst das aktuelle Gespräch in einem komprimierten Block zusammen
3. Ersetzt den ursprünglichen Kontext durch die Zusammenfassung
4. Setzt die Ausführung fort

Wenn es ausgelöst wird: Im Standard-Plugin memory-core gibt es keinen konfigurierbaren Schwellenwert. Es wird basierend auf der Tokenanzahl ausgelöst, nicht auf der Aufgabenstufe. Bei einem 2-stündigen autonomen Lauf können Sie mit 3–5 Verdichtungszyklen rechnen.

So erstellen Sie eine komprimierungsresistente Dateiarchitektur

Verhaltensanweisungen in MEMORY.md anheften, nicht in der Konversation. Alles, was mehrere Komprimierungszyklen überstehen muss, muss in einer dauerhaften Datei gespeichert sein, die nach jeder Komprimierung erneut gelesen wird.

Empfohlenes Pinnmuster:

## Agent Behavioral Rules (always active)
- Never overwrite files without showing a diff first
- Write tests before implementation (TDD mode: on)
- Use TypeScript strict mode in all new files

## Project Context
- Stack: Node.js 22, Fastify, PostgreSQL 16
- Repo root: /home/user/project
- Active sprint goal: migrate auth to Clerk

Namenskonventionen, die die Komprimierung überleben:

• Stellen Sie kritischen Abschnitten ## [PINNED] voran – die Zusammenfassung behandelt Kopfzeilen in Großbuchstaben mit hoher Priorität
• Halten Sie jeden angehefteten Sachverhalt nach Möglichkeit in einer Zeile – dichte Absätze werden zusammengefasst, einzeilige Sachverhalte bleiben in der Regel wörtlich erhalten
• Wiederholen Sie die 3–5 wichtigsten Verhaltensregeln sowohl in MEMORY.md als auch in der heutigen Tagesnotiz – Redundanz ist Ihre Verdichtungsabsicherung

Zero-to-Memory-Einrichtung in 10 Minuten (komplettes Dateigerüst)

Dies ist die Installationsanleitung, die es sonst nirgendwo gibt. Kopieren Sie diese Struktur, geben Sie Ihren Kontext ein und schon kann es losgehen.

Verzeichnisbaum:

memory/
├── MEMORY.md
├── 2026-04-27.md          ← today's daily note (create manually)
└── wiki/                  ← only if using memory-wiki plugin
    ├── index.md
    ├── project-context.md
    └── decisions.md

Starter MEMORY.md:

# Persistent Memory

## Identity & Preferences
- Name: [your name]
- Role: [your role]
- Preferred response style: concise, no preamble

## Project: [Project Name]
- Stack: [your stack]
- Key constraints: [e.g., no external APIs, TypeScript only]
- Current focus: [active task or sprint goal]

## Behavioral Rules
- [Rule 1]
- [Rule 2]

## Decisions Made
- [YYYY-MM-DD] Decided to use X because Y

Starter-Tagesnotiz (2026-04-27.md):

# 2026-04-27

## Session Goals
- [ ] Task 1
- [ ] Task 2

## Notes

Plugin-Slot-Konfiguration (2026-Syntax):

{
  "plugins": {
    "slots": {
      "memory": "memory-core"
    }
  }
}

So deaktivieren Sie den Speicher vollständig:

{
  "plugins": {
    "slots": {
      "memory": false
    }
  }
}

Überprüfungsschritte:

1. Führen Sie eine Sitzung durch und bitten Sie den Agenten, sich an etwas zu erinnern, das Sie ihm in einer früheren Sitzung gesagt haben
2. Überprüfen Sie, ob memory/YYYY-MM-DD.md geschrieben wurde (es sollte neuen Inhalt haben)
3. Fragen Sie den Agenten direkt: „Was wissen Sie über mich?“ – es sollte von MEMORY.md abgerufen werden

Speicher-Wiki für eine Produktions-Wissensdatenbank konfigurieren

Aktivieren Sie es, indem Sie den Plugin-Slot tauschen:

{
  "plugins": {
    "slots": {
      "memory": "memory-wiki"
    }
  }
}

Memory-Wiki generiert einen strukturierten Tresor unter memory/wiki/. Jedes Thema bekommt eine eigene Seite. Das Plugin kompiliert einen digest.md, der hochzuverlässige, nicht widersprüchliche Fakten zusammenfasst, die der Agent beim Sitzungsstart laden kann.

Praktische Tresorstruktur für einen Produktionsagenten:

memory/wiki/
├── index.md              ← vault table of contents
├── digest.md             ← auto-generated; agent reads this
├── project-context.md    ← stack, goals, constraints
├── decisions.md          ← architectural decisions log
├── team.md               ← stakeholders, contacts
└── domain-knowledge.md   ← business rules, glossary

Semantische Suche und Einbettungen – SQLite, sqlite-vec und der JS-Fallback

OpenClaw indiziert Ihre Speicherdateien mithilfe von SQLite mit der Erweiterung sqlite-vec für die Vektorähnlichkeitssuche. Wenn Sie oder der Agent eine Speichersuche durchführen, bettet er die Abfrage ein und ruft die semantisch relevantesten Blöcke ab.

Überprüfen Sie, ob Ihr Vektorspeicher fehlerfrei ist:

# Check that the memory index exists
ls memory/.index/

# Reset a corrupted index (safe to run — it rebuilds from .md files)
rm -rf memory/.index/ && OpenClaw reindex

Wenn sqlite-vec nicht verfügbar ist (häufig unter ARM Linux und einigen Windows-Konfigurationen), greift OpenClaw auf eine reine JS-Vektorerweiterung zurück. Erzwingen Sie den Fallback explizit:

{
  "memory": {
    "vectorBackend": "js"
  }
}

Segmentspezifische Gedächtnisstrategien

Solo-Entwickler – Minimaler Overhead, maximaler Rückruf

Empfohlenes Setup: memory-core Plugin, MEMORY.md + nur tägliche Notizen, kein Wiki-Tresor.

• Halten Sie MEMORY.md unter 200 Zeilen – längere Dateien verlangsamen den Sitzungsstart
• An tägliche Notizen aggressiv anhängen; Versuchen Sie nicht, sie sauber zu halten
• Überprüfen und bereinigen Sie MEMORY.md wöchentlich – veraltete Fakten beeinträchtigen die Suchqualität

Multi-Agent-Pipeline – Gemeinsamer Speicher für alle Agenten

Wenn mehrere Agenten in dasselbe Verzeichnis memory/ lesen und schreiben, benötigen Sie explizite Eigentumsregeln.

• Ein Agent ist für die Schreibvorgänge in jeder Datei verantwortlich – Gleichzeitige Schreibvorgänge in dieselbe Datei .md führen zu Konflikten
• Verwenden Sie Unterverzeichnisse pro Agent: memory/agent-a/, memory/agent-b/, mit einem gemeinsamen memory/shared/MEMORY.md
• Verwenden Sie Memory-Wiki für den gemeinsamen Tresor – seine Digest-Kompilierung verarbeitet die Aktualität über mehrere Autoren hinweg besser als Rohdateien

Autonome Aufgaben mit langer Laufzeit – stundenlange Ausführung überleben

Für Agenten, die Aufgaben ausführen, gemessen in Stunden:

• Speicherschreibvorgänge an Prüfpunkten erzwingen – Weisen Sie den Agenten nach jeder größeren Aufgabenphase an, seinen aktuellen Status an die heutige Tagesnotiz anzuhängen
• Verdichtungsresistenten Kontext vorladen – Fügen Sie die vollständige Aufgabenspezifikation vor Beginn der Ausführung in MEMORY.md ein, nicht nur in der ersten Nachricht
• Setzen Sie explizite Fortsetzungsmarkierungen in täglichen Notizen: <!-- RESUME POINT: completed steps 1-4, next: step 5 -->, damit sich der Agent nach einem Verdichtungszyklus selbst orientieren kann

Fehlerbehebung beim OpenClaw-Speicher – Diagnostizieren Sie jedes Vergessensproblem in 2 Minuten

Gehen Sie diese Schritte der Reihe nach durch:

Häufig gestellte Fragen

Endgültiges Urteil – Das Speicher-Setup, das tatsächlich hängen bleibt

Empfohlene Basis für die meisten Benutzer: memory-core-Plugin, memory/-Verzeichnis, das vor der ersten Sitzung erstellt wurde, MEMORY.md mit Verhaltensregeln in einem klar gekennzeichneten, angehefteten Abschnitt, tägliche Notizen, die während jeder Sitzung angehängt werden.

Ihre Aktions-Checkliste:

• Erstellen Sie das Verzeichnis memory/ in Ihrem Projektstammverzeichnis
• Kopieren Sie die obige Startervorlage MEMORY.md und geben Sie Ihren Kontext ein
• Stellen Sie sicher, dass plugins.slots.memory auf "memory-core" (oder das von Ihnen gewählte Plugin) eingestellt ist.
• Fügen Sie Ihre 3–5 kritischsten Verhaltensregeln unter ## [PINNED] in MEMORY.md hinzu.
• Bestätigen Sie nach Ihrer ersten Sitzung, dass eine datierte Tagesnotiz geschrieben wurde
• Wenn die semantische Suche nicht funktioniert, führen Sie OpenClaw reindex aus, um den Vektorindex neu zu erstellen

Die Architektur ist solide, wenn man sie erst einmal verstanden hat. Die meisten Vergessensprobleme lösen sich innerhalb von 10 Minuten nach Befolgen dieser Checkliste.