Gateway Internals

10 Min. Lesezeit

Aktiver Speicher vs gespeicherter Speicher

Die meiste Verwirrung rund um Speicher in OpenClaw entsteht, weil alles wie derselbe Mechanismus behandelt wird. Ist es aber nicht. Manche Informationen tauchen vor der Antwort auf, manche liegen still auf der Platte, und manche erscheinen nie wieder, wenn du sie nicht sauber abgelegt hast. Sobald du Live-Recall und dauerhafte Speicherung trennst, ergibt das System plötzlich Sinn.

Viele sagen: "Der Agent sollte sich das doch merken", als wäre Speicher einfach ein großer Eimer. Genau da beginnt der Ärger.

In OpenClaw funktioniert Speicher eher wie eine Werkstatt mit Regalen, Klebezetteln und einer stillen Assistenz, die dir manchmal die richtige Karte direkt vor dem Gespräch hinlegt. Nützlich, ja. Magisch, nein.

Die offiziellen Docs zu concepts/active-memory, concepts/memory und concepts/memory-search beschreiben drei verschiedene Jobs: proaktiven Recall vor der Antwort, dauerhafte Speicherung auf der Platte und Suche, die relevante Notizen später wieder hervorholt. Wer das vermischt, diagnostiziert Speicherprobleme fast immer falsch.

Die Kurzfassung

  • aktiver Speicher = ein optionaler blockierender Speicher-Subagent, der vor der Hauptantwort relevante Erinnerung hochholen kann
  • gespeicherter Speicher = normale Markdown-Dateien wie MEMORY.md und memory/YYYY-MM-DD.md
  • memory_search = die Retrieval-Schicht, die gespeicherte Notizen später findet
  • Live-Kontext = das, was das Modell gerade jetzt sieht, und das ist nicht dasselbe wie gespeicherter Speicher

Wenn du nur eine Idee aus diesem Artikel mitnimmst, dann diese.

Was aktiver Speicher wirklich ist

Active Memory ist nicht dein komplettes Speichersystem. Es ist ein optionaler Plugin-gesteuerter Pass direkt vor der Antwort.

Bevor die eigentliche Assistenten-Antwort erzeugt wird, kann OpenClaw für geeignete Gesprächssitzungen einen begrenzten Speicher-Subagenten starten. Dieser Subagent hat genau eine Aufgabe: prüfen, ob etwas bereits Gespeichertes gerade relevant genug ist, damit die Antwort natürlicher wirkt.

Das heißt: Active Memory dreht sich um jetzt. Es ist eine Just-in-Time-Recall-Schicht. Findet sie etwas Brauchbares, injiziert OpenClaw einen versteckten untrusted Speicher-Präfix in die Modell-Eingabe. Findet sie nichts Relevantes, passiert schlicht nichts und die Hauptantwort läuft normal weiter.

Eine gute Analogie ist ein Bühnenmanager, der einem Sprecher kurz vor dem Auftritt noch eine hilfreiche Stichkarte reicht. Diese Karte kann wichtig sein. Aber sie ist nicht der Archivraum, in dem alle Skripte und Probenotizen liegen.

Was gespeicherter Speicher wirklich ist

Gespeicherter Speicher ist die dauerhafte Schicht. Er liegt auf der Platte als einfache Dateien im Workspace.

  • MEMORY.md für kompakten Langzeitspeicher, Präferenzen, Entscheidungen und stabile Fakten
  • memory/YYYY-MM-DD.md für tägliche Notizen, rohe Beobachtungen, Sitzungszusammenfassungen und Arbeitskontext
  • DREAMS.md für optionale Dreaming-Zusammenfassungen und Review-Ausgaben

Hier erwarten viele Anfänger Magie und bekommen stattdessen Buchhaltung. OpenClaw merkt sich Dinge, indem es Dateien schreibt. Kein geheimer Zweitgeist im Dachboden. Wenn etwas nicht auf der Platte steht, ist es nur aktuelles Gespräch und kann später aus dem Live-Arbeitsfenster verschwinden.

Das klingt deutlich weniger glamourös als die übliche KI-Werbung. Es ist aber viel nützlicher, weil du sofort weißt, wo du suchen musst, wenn etwas fehlt.

Warum das verschiedene Systeme sind

Gespeicherter Speicher beantwortet: "Welche Information existiert?" Active Memory beantwortet: "Soll etwas davon vor dieser Antwort sichtbar gemacht werden?"

Diese Fragen hängen zusammen, sind aber nicht dieselbe Frage.

Du kannst völlig brauchbaren gespeicherten Speicher haben und trotzdem auf einem bestimmten Turn keinen aktiven Recall sehen. Vielleicht ist die Erinnerung gerade irrelevant. Vielleicht ist das Plugin aus. Vielleicht ist die Sitzung nicht geeignet. Vielleicht war die Notiz zu vage, um gut zu ranken. Existenz garantiert keine Auslieferung.

Genau das ist der wichtige Denkwechsel. OpenClaw-Speicher ist eher eine gute Bibliothek als ein telepathischer Schwarmgeist. Das Buch kann im Gebäude sein und trotzdem nicht auf deinem Schreibtisch liegen.

Wo memory_search hineinpasst

memory_search ist die Retrieval-Engine, die OpenClaw hilft, Notizen auch dann zu finden, wenn die Formulierung anders ist als im ursprünglichen Eintrag.

Laut Docs kann sie Vektorähnlichkeit und BM25-Keyword-Suche kombinieren und die Ergebnisse zusammenführen. Übersetzt heißt das: Sie kann sowohl Bedeutung als auch exakte Begriffe treffen.

  • semantische Treffer für anders formulierte Inhalte
  • Keyword-Treffer für IDs, Namen, Config-Keys und exakte Strings
  • optionale Ranking-Helfer wie Temporal Decay und MMR-Diversität

Active Memory kann solche Recall-Tools unter der Haube nutzen. Der Hauptagent kann sie auch direkt aufrufen. Aber die Suchschicht hängt trotzdem davon ab, wie gut etwas gespeichert wurde, wie sauber es indiziert ist und ob die aktuelle Einrichtung den nötigen Provider-Support hat.

Warum Recall scheitert, obwohl du schwören würdest, dass der Agent es wusste

Das ist meist der Abschnitt, den Leute nach dem ersten frustrierenden Fehlgriff brauchen.

1. Die Information wurde nie sauber hochgestuft

Wenn ein Detail nur im Gespräch geblieben ist und nie in MEMORY.md oder einer Tagesnotiz gelandet ist, gibt es später nichts Dauerhaftes mehr zum Wiederfinden. Viel vermeintlicher "Gedächtnisverlust" ist in Wahrheit "nie aufgeschrieben".

2. Die Erinnerung existiert, aber nicht im Live-Kontext

Gespeicherter Speicher und Live-Kontext sind verschiedene Schichten. Eine dauerhafte Notiz kann auf der Platte liegen, ohne im aktuellen Prompt zu landen. Das ist normal.

3. Active Memory läuft für diese Sitzung gar nicht

Die Active-Memory-Doku ist hier ziemlich klar. Das Plugin muss aktiv sein, der aktuelle Agent muss gezielt eingeschlossen sein, der Chat-Typ muss erlaubt sein und die Sitzung muss eine geeignete interaktive persistente Chat-Sitzung sein. Heartbeats, Hintergrundarbeit, One-Shot-Runs und interne Helper-Pfade sind nicht das übliche Spielfeld für Active Memory.

4. Suchqualität oder Indizierung stimmt nicht

Wenn Embeddings fehlen, veraltet sind oder schlecht konfiguriert wurden, wird semantischer Recall schwächer. Wenn die Notiz schlecht benannt oder in Rauschen vergraben wurde, leidet oft auch die exakte Suche. Retrieval-Systeme sind nützlich. Gedankenlesen sind sie nicht.

5. Die Information landete in der falschen Schicht

Stabile Präferenzen gehören in MEMORY.md. Chaotische tägliche Beobachtungen gehören in datierte Notizen. Handlungssensitive Follow-ups gehören unter Umständen eher in Commitments oder geplante Tasks statt in Langzeitspeicher. Wenn alles überall landet, wird Recall automatisch schlampiger.

Wann du Information hochstufen solltest

Wenn du besseren Recall willst, stufe nach Haltbarkeit hoch, nicht nach Panik.

In MEMORY.md, wenn es stabil ist

  • Nutzerpräferenzen, die sitzungsübergreifend zählen
  • stehende Projektentscheidungen
  • Fakten, die später wieder wichtig werden dürften
  • Regeln, die künftiges Verhalten in privaten Hauptsitzungen prägen sollen

In Tagesnotizen, wenn es roh oder zeitgebunden ist

  • Sitzungszusammenfassungen
  • frische Beobachtungen
  • temporäre Details, die später wichtig werden könnten
  • Kontext, den du später erst verdichten willst

Versuche nicht, Langzeitspeicher für jeden Job zu missbrauchen

Manche zukünftigen Aktionen sind besser in Commitments, Scheduled Tasks oder normalem Workflow-State aufgehoben. Langzeitspeicher ist für dauerhaften Kontext da, nicht dafür, jede Erinnerung wie einen Charakterzug zu behandeln.

Ein praktischer Betreiber-Workflow

Wenn Speicher verlässlich statt spooky wirken soll, hilft ein nüchterner Ablauf. Nüchtern gewinnt hier.

/active-memory status
openclaw memory status
openclaw memory search "Nutzerpräferenz oder Projektfakt"
/context detail

Diese kurze Folge beantwortet vier nützliche Fragen:

  • ist proaktiver Recall für diese Sitzung aktiv?
  • ist der Speicher-Index gesund?
  • kann die Notiz überhaupt gefunden werden?
  • fehlt im aktuellen Live-Kontext etwas, von dem du stillschweigend ausgegangen bist?

Die meisten Speicherprobleme verlieren sofort ihren Zauber, wenn du diese Ebenen trennst.

Gesunde Gewohnheiten, damit Speicher besser funktioniert

MEMORY.md kompakt halten

Die Docs erwähnen, dass OpenClaw bei einer zu großen MEMORY.md die Datei auf der Platte behält, aber nur eine gekürzte Version in den Modellkontext injiziert. Das ist eine fiese Quelle für falsches Sicherheitsgefühl. Die Notiz existiert, aber nicht jeder Turn sieht alles davon.

Verdichten statt kippen

Nutze Tagesnotizen als unordentliche Werkbank. Hebe nur die dauerhafte Zusammenfassung in den Langzeitspeicher. Das ist im Grunde kaizen für Speicherhygiene: kleine kontinuierliche Pflege schlägt die eine große Rettungsaktion später.

Notizen so schreiben, dass Retrieval eine Chance hat

Vage Notizen sind Recall-Gift. Kurze, konkrete Einträge mit klaren Namen, Präferenzen, Entscheidungen und Begriffen geben semantischer wie exakter Suche etwas Brauchbares zum Greifen.

Active Memory als Anreicherung sehen, nicht als Beweis

Wenn ein Detail wirklich wichtig ist, prüfe es. Proaktiver Recall verbessert Kontinuität, bleibt aber ein begrenzter Helfer und keine eidesstattliche Erklärung.

Das Denkmodell, das dich sane hält

Nimm dieses Bild:

  • gespeicherter Speicher ist das Archiv
  • memory_search ist der Bibliothekar
  • aktiver Speicher ist die Assistenz, die dir vor dem Meeting wahrscheinlich eine nützliche Akte auf den Tisch legt
  • Live-Kontext ist der Schreibtisch selbst

Wenn das Archiv chaotisch ist, kämpft der Bibliothekar. Wenn die Assistenz frei hat, wird nichts vorab bereitgelegt. Wenn der Schreibtisch überladen ist, bleibt selbst gute Information nicht sichtbar. Genau darum dreht sich das ganze Spiel.

Der praktische Gewinn für Betreiber

Sobald du aktiven Speicher von gespeichertem Speicher trennst, wirken Speicherbugs deutlich weniger persönlich.

Du hörst auf zu sagen: "Das Modell hat es vergessen" und stellst bessere Fragen: Wurde die Information gespeichert? Wurde sie in der richtigen Schicht gespeichert? War die Suche gesund? War Active Memory hier überhaupt aktiv? War der Live-Kontext schon zu voll?

Das ist die bessere Arbeitshaltung. Weniger Aberglaube, mehr Systemdenken und deutlich weniger dramatische Monologe darüber, wie die KI dich verraten hat.

Need help from people who already use this stuff?

Willst du, dass deine OpenClaw-Agenten sich an die richtigen Dinge erinnern, ohne den Speicher zur Gerümpelschublade zu machen?

Komm in My AI Agent Profit Lab, wenn du Hilfe bei Speichergewohnheiten, Retrieval-Workflows und Kontext-Aufräumen willst, die im echten Betrieb standhalten.

FAQ

Was ist der Unterschied zwischen aktivem Speicher und gespeichertem Speicher in OpenClaw?

Aktiver Speicher ist ein optionaler Recall-Pass vor der eigentlichen Antwort, der relevante Erinnerungen vorab hochholen kann. Gespeicherter Speicher ist Information auf der Platte, etwa in MEMORY.md und memory/YYYY-MM-DD.md, die später geladen oder durchsucht werden kann.

Durchsucht OpenClaw Speicher immer automatisch?

Nein. Die grundlegenden Speicher-Tools sind da, aber Active Memory ist optional und läuft nur in geeigneten persistenten Gesprächssitzungen, wenn das Plugin aktiv ist und der aktuelle Agent gezielt eingeschlossen wurde. Sonst hängt Recall davon ab, ob der Hauptagent bei Bedarf selbst sucht oder lädt.

Warum kann Speicher-Recall scheitern, obwohl die Information existiert?

Weil die Information vielleicht nicht im Live-Prompt liegt, Active Memory deaktiviert ist, der Sitzungstyp nicht geeignet ist, der Suchindex veraltet ist oder die Notiz in der falschen Schicht gespeichert wurde. Gute Speicherstruktur verbessert Recall, macht ihn aber nicht magisch.

Wann gehört etwas in MEMORY.md statt in tägliche Notizen?

Nutze MEMORY.md für dauerhafte Fakten, stabile Präferenzen und stehende Entscheidungen, die über private Hauptsitzungen hinweg verfügbar sein sollen. Nutze tägliche Notizen für rohe Beobachtungen, aktuelle Kontexte und Arbeitsdetails, die später verdichtet werden können.

Ist Active Memory für Automationen und Hintergrundjobs sinnvoll?

Meist nicht. Die offiziellen Docs positionieren es als Gesprächs-Anreicherung für interaktive persistente Chats, nicht als allgemeine versteckte Recall-Schicht für Background Worker, Headless-Runs oder Einmal-Automationen.