## Die Erinnerungsdecke

Wenn Sie OpenClaw heute ausführen, speichert Ihr Agent Speicher in „MEMORY.md“ und datierte Dateien in einem „memory/“-Verzeichnis. Das funktioniert für die Verwendung durch einen einzelnen Agenten und eine einzelne Sitzung. In dem Moment, in dem Sie sich bei allem, was gerade läuft, auf diese Erinnerung verlassen, stoßen Sie an eine Grenze. Die Fehlermodi sind spezifisch und vorhersehbar.

**Speicherkomprimierung lässt Fakten fallen.** OpenClaw löst einen stillen Agentenzug aus, der „dauerhafte Erinnerungen“ schreibt, bevor der Kontext abgeschnitten wird. Was sich vor der Komprimierung in der Datei befand, ist unbekannt. Wenn in der komprimierten Version ein Fakt weggelassen wurde, ist er verschwunden. Es gibt kein Beobachtungsprotokoll. Kein Rollback.

**Keine Entitätsidentität über Sitzungen hinweg.** „Acme Corp“ in einer Sitzung und „ACME CORP“ ​​in der nächsten kann zur gleichen Entität aufgelöst werden oder auch nicht. Der Agent leitet jedes Mal neu aus dem Kontextfenster ab. Es gibt keine stabilen IDs. Keine Zusammenführungsregeln.

**Gleichzeitige Schreibvorgänge im beschädigten Zustand.** Wenn Sie mehrere Agenten oder Plugins ausführen, die dieselben Speicherdateien berühren, kommt es zu Datenbeschädigungen. Die eigene Dokumentation von OpenClaw bestätigt dies. Die Obergrenze für einzelne Agenten ist real und die meisten Agenten-Workflows werden nicht für immer Einzelagenten bleiben.

**Kein Audit-Trail.** Wenn der Agent eine falsche Antwort gibt, können Sie diese nicht auf eine bestimmte Beobachtung zurückführen. Sie können nicht sehen, was sich zwischen Dienstag und Donnerstag geändert hat. Sie können nicht antworten: „Was wusste mein Agent, als er diese Entscheidung traf?“

Dies sind keine Randfälle. Sie werden angezeigt, sobald der Agent sitzungsübergreifend Kontakte, Aufgaben, Transaktionen oder andere wichtige Zustände bearbeitet.

## Was das Plugin hinzufügt

[Neotoma v0.4.3](https://github.com/markmhendrickson/neotoma/releases/tag/v0.4.3) fügt ein „openclaw.plugin.json“-Manifest, einen Einstiegspunkt und Tooldefinitionen hinzu, die sich im vierschichtigen Plugin-System von OpenClaw registrieren. Das Gateway erkennt das Plugin, validiert das Manifest, lädt die Laufzeit und stellt die Tools von Neotoma dem Agenten zur Verfügung.

Jeder oben genannte Fehlermodus erhält eine strukturelle Lösung.

**Die Komprimierung verliert nicht mehr den Status.** Beobachtungen können nur angehängt werden. Die komprimierte Zusammenfassung kann weiterhin als Kontextfenster dienen, aber die Quellbeobachtungen bleiben in Neotoma mit vollständigem Verlauf bestehen. Nichts wird stillschweigend fallen gelassen.

**Entitätsidentität ist deterministisch.** Hash-basierte kanonische IDs lösen „Acme Corp“ und „ACME CORP“ ​​nach Regel und nicht durch Rückschluss pro Sitzung in eine Entität auf. Immer der gleiche Kontakt, die gleiche ID.

**Gleichzeitige Schreibvorgänge sind sicher.** Zwei Agenten, die über dieselbe Entität schreiben, erzeugen zwei Beobachtungen in einem Nur-Anhang-Speicher, keinen Dateikonflikt. Schemaeinschränkungen validieren jeden Schreibvorgang, bevor er in den Speicher gelangt.

**Der Prüfpfad ist integriert.** Jede Beobachtung lässt sich auf ihre Quelle zurückführen. Korrekturen führen zu neuen Beobachtungen, nicht zu Überschreibungen. Sie können den Zustand jederzeit rekonstruieren.

Über die Behebung der Obergrenze hinaus bietet das Plugin Funktionen, die „MEMORY.md“ überhaupt nicht unterstützen kann:

- **Strukturierter Abruf.** „Alle mit diesem Kontakt verknüpften Aufgaben“ oder „jede Transaktion mit Anbieter X“ ist eine Abfrage, kein Datei-GREP.
- **Zeitleistenabfragen.** Entitätsübergreifende Datumsfelder erzeugen Zeitleisten. „Was letzte Woche passiert ist“ trifft auf einen zeitlichen Index zu, nicht auf eine Kontextfenstersuche.
- **Schemavalidierung.** Entitätstypen werden beim Schreiben überprüft. Ungültige Daten werden abgelehnt, bevor sie in den Speicher gelangen.

Die Agentenschleife ändert sich nicht. OpenClaw verwaltet weiterhin die Interpretation von Absichten, das Durchsuchen, das Ausfüllen von Formularen und die Ausführung von Fertigkeiten. Neotoma kümmert sich um den Staat. Das Plugin befindet sich zwischen den Schreibvorgängen des Agenten und dem persistenten Speicher.

## Die Overhead-Frage

Markdown-Dateien sind kostenlos. Die Einrichtung und Wartung kostet nichts, und die KV-Cache-Ökonomie belohnt sie aktiv.

Neotoma erhöht den Overhead. Schemavalidierung bei Schreibvorgängen. Beobachtungsspeicher. Entitätsauflösung. Ein lokaler Serverprozess. Diese sind nicht kostenlos. Der Overhead soll jedoch unsichtbar bleiben: Der Agent installiert Neotoma, konfiguriert es und schreibt darauf, ohne dass Sie ein neues Tool erlernen oder Ihre Arbeitsweise ändern müssen.

Die Frage ist, ob sich der Mehraufwand lohnt. Wenn Ihr Agent nie antworten muss: „Was wusste ich letzten Dienstag?“ oder „Welcher Eintrag hat diesen Kontaktdatensatz beschädigt“, dann nein. „MEMORY.md“ ist die richtige Architektur.

Wenn Ihr Agent den laufenden Status, Kontakte, Aufgaben, Transaktionen und Lieferantenbeziehungen verwaltet und Sie sitzungsübergreifende Konsistenz benötigen, ist der Schreibpfad-Overhead der kostengünstigste Teil des Problems. Der kostspielige Teil besteht darin, staatliche Korruption im Nachhinein zu beheben, wenn der Prüfpfad nicht vorhanden ist.

## What this does not do

Das Plugin ersetzt nicht die Agentenschleife von OpenClaw. Es ändert nichts daran, wie Fähigkeiten funktionieren. Es ist nicht erforderlich, vorhandenen „MEMORY.md“-Inhalt zu migrieren (obwohl der Import unterstützt wird).

Es löst nicht jedes Agentenspeicherproblem. Abrufqualität, schnelle Technik, Kompetenzdesign und Modellauswahl sind nach wie vor wichtig. Neotoma kümmert sich um die Zustandsebene: welche Entitäten existieren, wie sie verknüpft sind, woher sie kommen und wie sie sich verändert haben. Alles darüber bleibt gleich.

Es wird auch kein Anspruch auf Produktionsstabilität erhoben. Neotoma ist in [Entwicklerversion](/posts/neotoma-developer-release). Es ist mit bahnbrechenden Änderungen zu rechnen. Das Plugin existiert, um unter Druck zu testen, ob der strukturierte Zustand unter einer echten Agentenplattform in der Praxis funktioniert, und nicht, um heute Zuverlässigkeit zu versprechen.

## Try it, break it

Ich habe Neotoma als Speicherschicht in [meinem eigenen Agentenstack](/posts/what-my-agentic-stack-actually-does) ausgeführt. Mehrere Agenten schreiben an denselben Shop: E-Mail-Triage, Aufgabenverwaltung, Finanzen und Inhalte. Die oben beschriebenen Multi-Agenten-Zustandsprobleme sind für mich nicht hypothetisch. Sie sind das, was ich jede Woche treffe.

Das Plugin stellt dies OpenClaw-Benutzern zur Verfügung. Install it. Enable it. Führen Sie Ihren Agenten mit dem darunter liegenden strukturierten Status aus. See where it helps. Sehen Sie, wo sich der Mehraufwand nicht lohnt. Sehen Sie, wo das Design bricht.

Die Rückkopplungsschleife ist wichtiger als die Architektur. Echte Agenten, die echte Beobachtungen über eine strukturierte Ebene schreiben, entscheiden darüber, ob die Behauptungen bestehen oder scheitern.

## Evaluate and install

Der schnellste Weg herauszufinden, ob Neotoma zu Ihrem OpenClaw-Workflow passt, besteht darin, es von Ihrem Agenten bewerten zu lassen. Fügen Sie dies in Ihre OpenClaw-Sitzung ein:

```copy
Lesen Sie https://neotoma.io/evaluate. Bevor Sie antworten, sehen Sie sich alle größeren Tools, Arbeitsbereiche und Konfigurationskontexte an, auf die Sie zugreifen können, damit Sie meinen tatsächlichen Arbeitsablauf und nicht nur diesen Chat beurteilen können. Sagen Sie mir dann, ob Neotoma wirklich zu meinem Workflow passt, welche Daten zuerst gespeichert werden sollten und was ich als Nächstes tun sollte.
„

Ihr Agent liest die Seite, überprüft Ihren lokalen Kontext (Tools, Konfigurationen, Speicherdateien und Arbeitsbereich) und teilt Ihnen mit, ob die in diesem Beitrag beschriebenen Probleme auf Ihr Setup zutreffen. Wenn dies der Fall ist, werden Sie durch die Installation, die Aktivierung mit Ihren eigenen Daten und die Plugin-Konfiguration geführt. Wenn nicht, wird Ihnen das auch mitgeteilt.

Wenn Sie Neotoma bereits möchten und lieber [den Evaluierungsschritt](https://neotoma.io/evaluate) überspringen möchten, verwenden Sie die agentengestützte Installation von [neotoma.io/install](https://neotoma.io/install). Fügen Sie dies in OpenClaw ein. Ihr Agent liest die vollständige Installationssequenz auf dieser Seite, installiert sie nur bei Bedarf, führt die Aktivierung mit Ihren Daten durch und konfiguriert dann Ihr aktuelles Tool für die fortlaufende Verwendung, einschließlich der OpenClaw-Integrationsschritte auf derselben Seite:

```copy
Lesen Sie https://neotoma.io/install und führen Sie mich durch den Neotoma-Installationsablauf. Installieren Sie es, aktivieren Sie es mit meinen Daten und konfigurieren Sie mein aktuelles Tool für den robusten Dauereinsatz.
„

Wenn Sie manuelle Befehle bevorzugen: `openclaw Plugins Install Clawhub:neotoma` fügt das Plugin direkt von ClawHub hinzu. Oder installieren Sie das npm-Paket global mit „npm install -g neotoma“ und dann „neotoma init“, mit optionalem Pin zu dieser Version („npm install -g neotoma@0.4.3“). Vollständige Optionen, MCP-Konfiguration, Docker und Reset-Verhalten bleiben auf [neotoma.io/install](https://neotoma.io/install).

Repo: [github.com/markmhendrickson/neotoma](https://github.com/markmhendrickson/neotoma). Versionshinweise: [v0.4.3](https://github.com/markmhendrickson/neotoma/releases/tag/v0.4.3).

Für die tiefere architektonische Begründung hinter dem strukturierten Agentenspeicher siehe [OpenClaw und die Wahrheitsschicht](/posts/openclaw-and-the-truth-layer) und [Die Markdown-Speicherobergrenze](/posts/the-markdown-memory-ceiling).