Lossless Claw: ein Plugin für verlustfreie Speicher- und lange Kontextverwaltung für KI-Intelligenzen

Lossless Claw ist ein von Martian Engineering entwickeltes Open Source Lossless Context Management (LCM) Plugin für OpenClaw-Intelligenzen. Es basiert auf dem LCM-Forschungspapier von Voltropy und wurde entwickelt, um das Problem des historischen Speicherverlusts zu lösen, der durch den “Sliding Window”-Mechanismus verursacht wird, wenn Intelligenzen sich in langen Unterhaltungen befinden oder über Nacht Arbeitsabläufe ausführen. Das Plugin fängt Nachrichten ab, die kurz vor dem Überlaufen des Kontextfensters stehen, und speichert sie dauerhaft in einer lokalen SQLite-Datenbank; außerdem ruft es ein großes Modell auf, um den Verlauf als hierarchische Zusammenfassung in Form eines gerichteten azyklischen Graphen (DAG) zu extrahieren. In den folgenden Sitzungen kombiniert das Plugin die übergeordnete Zusammenfassung mit den jüngsten Nachrichten, so dass die Gesamtanzahl der Token immer innerhalb sicherer Grenzen gehalten wird. Darüber hinaus bietet es den Intelligenzen exklusive Retrieval-Tools, die es der KI ermöglichen, jederzeit in die Zusammenfassungsebene einzudringen, um die anfänglichen Dialogdetails genau abzurufen und zu lesen, wodurch die Intelligenzen mit einem echten Langzeitgedächtnis ausgestattet werden.

Funktionsliste

• Vollständige lokale Persistenz der NachrichtVerabschieden Sie sich vom Beschneiden von Schiebefenstern und speichern Sie jede Originalnachricht, die während einer Sitzung generiert wird, vollständig und dauerhaft im Rohtext in der lokalen SQLite-Datenbank, so dass 100% keinen Datenverlust hat.
• Automatische Generierung von hierarchischen DAG-ZusammenfassungenMit Hilfe eines benutzerkonfigurierten großen Sprachmodells werden ältere Nachrichten automatisch in Stücke zerlegt und zu Zusammenfassungen destilliert. Wenn sich die Nachrichten häufen, werden die Zusammenfassungen weiter zu einer hierarchischen Struktur aus gerichteten azyklischen Graphen (DAGs) verdichtet.
• Dynamischer Kontext Intelligente MontageAutomatisches Zusammenfügen strukturierter historischer Zusammenfassungen mit aktuellen Rohnachrichten vor jeder Runde der Dialoggenerierung, wobei ein langfristiger Gedächtnisimpuls aufrechterhalten wird, während die aktuelle Token-Obergrenze des größeren Modells strikt eingehalten wird.
• Tiefes Eindringen in die Details und Rückruf-FunktionalitätEingebautes Toolkit für die Spezialitätensuche (lcm_grep、lcm_describe、lcm_expand), so dass Intelligenzler die originellsten historischen Dialogprotokolle über zusammenfassende Links aufspüren und extrahieren können, als ob sie auf ein Archiv zugreifen würden.
• Flexible zugrunde liegende große ModellkonfigurationUnterstützung für die Optimierung von API-Aufrufkosten durch die unabhängige Zuweisung eines anderen Modells oder Anbieters an die Aufgabe “Speicherzusammenfassung” als den Hauptdialog, entweder durch Umgebungsvariablen oder Plugin-Profile.

Hilfe verwenden

🚀 Zerlegung des Kernmechanismus: Abschied von der “selektiven Amnesie” der KI”

Bevor wir uns mit der Konfiguration und der Verwendung befassen, ist es wichtig, die zugrunde liegende Funktionslogik von Lossless Claw zu verstehen. Bei der Verwendung von KI-Intelligenzen wie OpenClaw nähert sich die Anzahl der kontextbezogenen Token schnell den physikalischen Grenzen des größeren Sprachmodells, wenn der Dialog fortschreitet und sich die Aufgaben häufen. Standardmäßig verwendet das System eine “Schiebefenster”-Strategie - wenn das Fenster voll ist, werden die ältesten Nachrichten einfach abgeschnitten und dauerhaft verworfen. Dies führt dazu, dass Ihre Intelligenz, wenn sie die ganze Nacht läuft, am nächsten Morgen alles über die Systemkonfiguration oder die Kernlogik, die am Vortag diskutiert wurde, vergessen hat.

Lossless Claw behebt dieses Problem grundlegend durch die Einführung der **Lossless Context Management (LCM)** Architektur:

1. Abfangen und Ablegen von DatenEs fängt alte Nachrichten ab, bevor sie verworfen werden, und schreibt sie 100% intakt in die SQLite-Datenbank des lokalen Computers.
2. Konstruktion des Memory MappingLeiser Aufruf des angegebenen Modells im Hintergrund, um alte Nachrichten in Zusammenfassungen zu verpacken und zu destillieren und die Zusammenfassungen in einer gerichteten azyklischen Graphenstruktur (DAG) zu stapeln.
3. SpeicherdurchdringungDa die Zusammenfassung der ursprünglichen Nachricht in der Datenbank zugeordnet ist, kann die KI, wenn sie ein Detail abrufen muss, die eingebauten Werkzeuge verwenden, um der Spur zu folgen und die ursprünglichen Daten zurück in das aktuelle Aktivierungsfenster zu “ziehen”.

🛠️ Installationsprozess: Zugriff auf verlustfreien Speicher von Grund auf neu

1. die Bestätigung des präoperativen Umfelds
Stellen Sie vor der Installation des Plugins sicher, dass Ihr lokaler Arbeitsplatzrechner oder Cloud-Server die folgenden grundlegenden Umgebungsanforderungen erfüllt:

• Installiert und stabil OpenClawund die aktuelle Version muss das Plugin Context Engine Support unterstützen.
• Node.js ist auf dem System installiert und muss auf dem Stand der Version 22 oder mehr。
• Mindestens ein verfügbares zugrunde liegendes Large Language Model (LLM-Provider) wurde erfolgreich im OpenClaw-System konfiguriert, das anschließend als Rechenmaschine für die Erstellung von Zusammenfassungen verwendet wird.

2. routinemäßige Installationen in Produktionsumgebungen
Wir empfehlen die Verwendung des offiziellen Plugin-Installationsprogramms, das mit OpenClaw geliefert wird, um die Integration mit einem Klick zu ermöglichen. Öffnen Sie Ihr Terminal oder Befehlszeilentool und geben Sie den folgenden Befehl ein:

openclaw plugins install @martian-engineering/lossless-claw

Hinweis: Wenn Sie OpenClaw gerade lokal ausführen, indem Sie den OpenClaw-Quellcode klonen (Local Checkout), verwenden Sie den pnpm-Paketmanager, um den entsprechenden Befehl auszuführen:

pnpm openclaw plugins install @martian-engineering/lossless-claw

3. lokale Debugging-Installation für Entwickler (optional)
Wenn Sie beabsichtigen, den Quellcode von Lossless Claw weiterzuentwickeln oder ihn für eine bestimmte Umgebung anzupassen, können Sie Ihre lokale Kopie des Codes in OpenClaw einbinden, was eine Aktualisierung des Codes in Echtzeit ermöglicht:

openclaw plugins install --link /path/to/lossless-claw

⚙️ Umgebungskonfiguration: Anpassen der Speicherkomprimierungs-Engine

Die Flexibilität von Lossless Claw besteht darin, dass Sie ein Modell nur für die Aufgabe “Zusammenfassungserstellung” festlegen können. Da die Komprimierungsspeicher im Hintergrund eine Menge Token verbrauchen, können Sie das leistungsstärkste und teuerste Modell für die Hauptaufgabe verwenden (z. B. GPT-4o oder Claude 3.5 Sonnet) und ein kostengünstigeres Modell für die Komprimierungsaufgabe konfigurieren (z. B. Gemini 1.5 Flash).

Fallback-Modell und Anpassungsprioritäten
Für die Aufgabe "Verdichtungsspeicher" (Compaction) sucht das Plug-in nach Modellkonfigurationsparametern in der folgenden strengen Prioritätsreihenfolge:

1. Umgebungsvariable(höchste Priorität, empfohlene Konfiguration):LCM_SUMMARY_MODEL / LCM_SUMMARY_PROVIDER。
2. Plugin-ProfileDas OpenClaw-Plugin JSON-Konfigurationsobjekt in der Datei summaryModel / summaryProvider Felder.
3. OpenClaw Global StandardmodellWenn nicht ausdrücklich angegeben, greift das Plugin automatisch auf das vom OpenClaw-System konfigurierte Standardmodell der Speicherkompression zurück.
4. Legacy-Einzelaufrufparameter (Legacy-Hinweise)。

Konfigurationsbeispiel: Einfügen von Umgebungsvariablen
Am Beispiel der Linux/macOS-Umgebung können Sie die folgenden Umgebungsvariablen in das Terminal einfügen, bevor Sie den OpenClaw-Front-End- oder Back-End-Dienst starten, damit die Zusammenfassungsaufgabe in das angegebene effiziente Modell eingebunden wird:

export LCM_SUMMARY_PROVIDER="google"
export LCM_SUMMARY_MODEL="gemini-1.5-flash"
openclaw start

🧠 Intelligente körperspezifische Abrufwerkzeuge: Wie kann man einen zyklusübergreifenden Abruf ermöglichen?

Sobald das Plugin installiert und aktiviert ist, müssen Sie als menschlicher Benutzer keine umständlichen Tastendruckoperationen auf der Benutzeroberfläche mehr durchführen, und Lossless Claw verwaltet die zugrunde liegenden Daten automatisch nach dem Prinzip der “sinnlosen Operation”. Die wichtigste Neuerung besteht jedoch darin, dass die Bibliothek der OpenClaw-Intelligenz automatisch mit drei extrem leistungsfähigen Werkzeugen für den Gedächtnisabruf ausgestattet wird. Um die Leistung des intelligenten Körpers zu verbessern, können Sie ihn in der anfänglichen Eingabeaufforderung des Projekts auffordern, diese Werkzeuge proaktiv aufzurufen, wenn er auf unsichere historische Informationen stößt:

• Globale Fuzzy-Suche (lcm_grep）：
  Wenn eine Intelligenz einen bestimmten Konfigurationsparameter, ein besprochenes Fehlerprotokoll oder einen Codeschnipsel abrufen muss, kann sie dieses Tool aufrufen, um eine präzise oder regelmäßige Suche in allen historischen Rohmeldungen in der SQLite-Datenbank durchzuführen.
• Ein kurzer Blick auf die Kurzdarstellung (lcm_describe）：
  Wenn die Intelligenz den Makrofortschritt des Projekts in den letzten Tagen verstehen muss, kann sie mit diesem Tool auf die DAG-Zusammenfassungstopologie der aktuellen Sitzung zugreifen. Dadurch kann die KI den hochdimensionalen Kernimpuls schnell lesen, ohne riesige Mengen an Token zu verbrauchen, um den ganzen Unsinn zu lesen.
• Detaillierte Penetrationserweiterung (lcm_expand）：
  Dies ist das entscheidende Merkmal der verlustfreien Wiederherstellung. Wenn sich ein intelligenter Körper in der lcm_describe Wenn Sie in der Gliederung der Netzwerkarchitektur einen Knoten “Mittwoch: Sicherheitsgruppenrichtlinien, die die Netzwerkarchitektur bestimmen” sehen und Sie diese Richtliniencodes gerade benötigen, ruft der Smart Body einfach die lcm_expand und geben Sie die System-ID dieses Zusammenfassungsknotens ein. Der Lossless Claw extrahiert sofort die ursprüngliche Dialogmitschrift aus der Datenbank für den Tag Mittwoch und fügt sie nahtlos wortwörtlich in den aktuellen Arbeitsspeicher der Intelligenz ein.

⚠️ Leitfaden zur Verhinderung von Fallstricken für Fortgeschrittene: Session Revival und Lifecycle Management

Viele unerfahrene Benutzer beschweren sich nach der Installation des Plugins: “Warum hat mein intelligenter Körper immer noch eine Amnesie? nachdem sie das Plugin installiert haben. Beachten Sie, dass es sich dabei oft nicht um eine Fehlfunktion des Plugins handelt, sondern um einen Auslöser von OpenClaw selbst Richtlinie zum Zurücksetzen von Sitzungen (SRP)。

Lossless Claw ist für die “verlustfreie Komprimierung und Bewahrung” des Kontexts in einer einzigen, langen Sitzung zuständig, aber es ist selbstnicht zuständigEntstörung und Blockierung der globalen Timeout-Interrupt-Regel von OpenClaw. Wenn Ihr System so eingestellt ist, dass die Sitzung automatisch gelöscht und nach einer kurzen Leerlaufzeit neu gestartet wird, wird die an die Sitzung angehängte Memory Map ebenfalls blockiert, und die neue Sitzung beginnt trotzdem bei Null.

Die ultimative Lösung：
Ändern Sie die Kernkonfigurationsdatei von OpenClaw, um die Parameter für den Lebenszyklus der Sitzungen anzupassen:

1. Suchen Sie die Einstellung Reset-Modus und stellen Sie den session.reset.mode Der Wert von "idle"(d. h. auf der Grundlage von Leerlaufzeitberechnungen wird die Sitzung nie unterbrochen, solange sie läuft).
2. erhebliche Steigerung session.reset.idleMinutes Der Wert des Parameters. Dies ist ein ganzzahliger Parameter, der in Minuten gemessen wird. Wenn Sie möchten, dass die Intelligenz über Tage oder sogar Zyklen hinweg kontinuierliche Nachverfolgungsaufgaben durchführt, setzen Sie ihn auf eine ausreichend große Zahl (z. B. setzen Sie ihn auf 10080(Dies bedeutet, dass das System einen stillen Leerlauf von bis zu einer ganzen Woche zulässt, ohne die Verbindung zu unterbrechen).

Wenn Sie die obige Anleitung befolgt haben, um Ihre Umgebung und Konfiguration einzurichten, wird sich Ihr OpenClaw vollständig in einen leistungsstarken digitalen persönlichen Assistenten verwandeln, der keine Angst vor dem Token-Limit hat und wirklich nichts vergisst.

Anwendungsszenario

1. Automatisierte Arbeitsabläufe über Nacht
   Wenn intelligente Stellen nachts unabhängig voneinander massive Protokollanalysen, Aufgabenverteilung und Fortschrittsverfolgung durchführen sollen, sind die Dialogrunden extrem hoch. Das Plugin verhindert, dass Intelligenzen aufgrund voller Fenster am nächsten Morgen Vorbefehle verlieren, und stellt sicher, dass die Aufgabenlogik kohärent ist, ohne zu kollabieren.
2. Langfristige komplexe Projekte und Code-Management
   Bei der Entwicklung von Software, die sich über mehrere Wochen erstreckt, muss sich die KI an Architekturentwürfe, Datenbanktabellenstrukturen und API-Spezifikationen erinnern, die zu einem frühen Zeitpunkt festgelegt wurden. Das Plugin ermöglicht es der KI, während der späteren Programmierung jederzeit auf die architektonischen Spezifikationen zurückzugreifen, indem sie eine vollständige Scheibe des historischen Entwurfs fallen lässt und eine Zusammenfassung erstellt.
3. Kontinuierliche Kundenbetreuung und Kontaktpflege
   Bei der Verwendung von OpenClaw für die Nachverfolgung von Kundenanfragen sind historische Kommunikationsdetails, die spezifischen Ansprüche des Kunden und die gemachten Versprechen äußerst wichtig. Das Plugin ermöglicht es der KI, die ursprünglichen Kommunikationsdetails mit einem bestimmten Kunden über Tausende von Dialogaufzeichnungen hinweg genau zu verfolgen.

QA

1. F: Wird nach der Verwendung von Lossless Claw die Speicherung von Verlaufsdatensätzen an einen externen Server weitergegeben?
   A: Überhaupt nicht. Alle historischen Chats werden permanent und zwangsweise als Klartext-Rohdaten in einer SQLite-Datenbank auf dem lokalen Computer (oder Server) gespeichert, auf dem das Plugin läuft. Abgesehen von den von Ihnen konfigurierten Anfragen zur Erstellung von Zusammenfassungen, die an LLM gesendet werden, werden keine vollständigen Konversationsdaten an eine Drittanbieter-Wolke übertragen, wodurch der Datenschutz und die Sicherheit in hohem Maße gewährleistet sind.
2. F: Wie kommt es, dass ich das Plugin installiert habe und mein SmartBody am nächsten Tag immer noch keinen Speicher hat?
   A: Das liegt in der Regel daran, dass der Standard-Reset-Mechanismus von OpenClaw für den Leerlauf von Sitzungen ausgelöst wird. Lossless Claw kümmert sich um die Speicherverdichtung, ändert aber nicht die native Sitzungslängenbegrenzung. Sie müssen in die OpenClaw-Konfiguration gehen und diesession.reset.modeeingestellt auf"idle"und deutlich erhöhtsession.reset.idleMinutesDer Wert der Zeit in Minuten.
3. F: Ist die Ausführung des Mechanismus zur Erstellung von Zusammenfassungen mit einem zusätzlichen API-Verbrauch verbunden?
   A: Das wird es. Da das Plugin ein umfangreiches Sprachmodell aufrufen muss, um die gesammelten alten Nachrichten in einen gerichteten azyklischen Graphen (DAG) umzuwandeln und zu verfeinern, fallen bei diesem Prozess zwangsläufig Token-Gebühren an. Es wird empfohlen, ein separates kostengünstiges Modell (z.B. Gemini 1.5 Flash oder Claude 3 Haiku) für die Zusammenfassungsaufgabe über eine Umgebungsvariable zu konfigurieren, um die Betriebskosten zu reduzieren.