OpenClaw

Zielgruppe und konkrete Schnittstelle

Dieser Leitfaden verbindet OpenClaw-Agenten mit dem persistenten XMemo-Speicher. OpenClaw arbeitet über eine Zwei-Schichten-Architektur: Das native OpenClaw-Speicher-Plugin auf ClawHub bietet die Laufzeit-Tool-Bindung, während der Begleit-Skill proaktive Recall-Führung und Sitzungs-Checkpoints bereitstellt.

Voraussetzungen

Stellen Sie vor dem Verbinden sicher, dass die folgenden Laufzeitabhängigkeiten und Tools vorhanden sind:

• OpenClaw-Agent-Laufzeit installiert und betriebsbereit.
• ClawHub-Paketzugriff aktiviert.
• Gültiges XMemo-Konto unter https://xmemo.dev.
• Node.js-Laufzeitversion 22.22.0 oder höher bei der Installation des Begleit-Skills.

Empfohlener Pfad: Natives Plugin plus Begleit-Skill

Der empfohlene Pfad installiert das native OpenClaw-Speicher-Plugin von ClawHub und den Begleit-Skill direkt über die OpenClaw-Paketverwaltung:

openclaw plugins install clawhub:@xmemo/openclaw-memory
openclaw skills install @xmemo/xmemo

Autorisierungs- und Anmeldeinformationsoptionen

Konfigurieren Sie Anmeldeinformationen über Umgebungsvariablen oder interaktives Geräte-Login. Verwenden Sie niemals ein einfaches Login, ohne zuvor Ihren Speicherpfad für Anmeldeinformationen gewählt zu haben:

• Umgebungsanmeldeinformation (empfohlen): Setzen Sie XMEMO_KEY in der Shell oder der Dienstumgebung, die OpenClaw startet.
• Interaktives Login: Wenn Sie den Begleit-Skill verwenden, führen Sie login mit --allow-plaintext nur aus, wenn secret-store XMEMO_KEY nicht verfügbar ist (beachten Sie, dass --allow-plaintext die Anmeldeinformation unverschlüsselt auf diesem Computer speichert).
• Anmeldeinformationen überprüfen: Führen Sie openclaw plugins list aus, um die Plugin-Aktivierung zu bestätigen, und überprüfen Sie den Authentifizierungsstatus mit dem Begleit-Skill.

Alternativer Pfad: Headless-Service-Runner

Übergeben Sie für headless OpenClaw-Runner oder automatisierte CI-Pipelines XMEMO_KEY ohne interaktive Eingabeaufforderungen direkt über Umgebungsvariablen an das Plugin.

export XMEMO_KEY='<your-xmemo-token>'
openclaw run --plugin @xmemo/openclaw-memory

Verbindungsprüfung (schreibgeschützt)

Überprüfen Sie die Konnektivität immer mit einer schreibgeschützten Anfrage, bevor Sie Daten schreiben. Diese Prüfung ändert den Speicherzustand nicht.

• Prüfung: Starten Sie eine OpenClaw-Testsitzung und stellen Sie eine aktive Recall-Abfrage nach vorhandenem Projektkontext.
• Erfolgssignal: OpenClaw gibt strukturierte Speicherergebnisse mit gültigen Reference- und Location-Feldern aus dem autorisierten Arbeitsbereich zurück.

Erste nützliche Aufgabe: Synthetischer Speicherlebenszyklus

Überprüfen Sie Speicherpersistenz, zustandslose Sitzungsübergänge, quellenbezogenen Recall und Korrektur:

• 1. Synthetische Tatsache speichern: Speichern Sie eine Projektkonvention ("Demo project timestamps use UTC.") unter "projects/demo-onboarding/conventions".
• 2. Zustandsloser Übergang: Beenden Sie die aktuelle OpenClaw-Konversation und starten Sie eine neue Sitzung.
• 3. Recall mit Quellenzuordnung: Fragen Sie "demo project timestamp format" ab. Bestätigen Sie die zurückgegebenen Reference und Location.
• 4. Speicher korrigieren: Aktualisieren Sie die gespeicherte Konvention mit ISO 8601-Formatierung.
• 5. Optionale Bereinigung: Führen Sie ein Soft-Delete für die Demo-Konvention durch, sobald die Onboarding-Verifizierung abgeschlossen ist.

Funktionen und Speicher-Workflows

OpenClaw-Workflows gruppieren Aktionen nach Ergebnis über Agentensitzungen hinweg:

• Proaktiver aktiver Recall: Fügt relevante langlebige Speicher vor der Planung automatisch in den aktiven Kontext ein.
• Sitzungskontinuität: Speichert und stellt Neustart-Snapshots wieder her, verfolgt Entscheidungen und verwaltet TODOs über Übergaben hinweg.
• Resilienzschicht: Kurzlebiger Recall-Cache und temporärer Schreib-Postausgang bewältigen kurze Netzwerkunterbrechungen.

Einschränkungen und Grenzen

Betriebliche Einschränkungen für die OpenClaw-Integration:

• Arbeitsbereichsisolation: Jeder Vorgang ist strikt auf den Arbeitsbereich des authentifizierten Benutzers beschränkt.
• ClawHub-Verfügbarkeit: Ungetestete Drittanbieter-Registries oder inoffizielle Forks des Plugins sind als ungetestet gekennzeichnet.
• Ledger-Umfang: Monatliche Ledger-Zusammenfassungen und Finanzprüfungstools erfordern dedizierte kommerzielle Bereiche.

Wiederherstellung, Aktualisierung und Entfernung

Fehlerbehebungs- und Wartungsverfahren für OpenClaw:

• Wiederherstellung (Plugin nicht geladen): Führen Sie openclaw plugins list aus und prüfen Sie die OpenClaw-Protokolle auf Initialisierungsfehler.
• Wiederherstellung (Authentifizierung abgelaufen): Exportieren Sie erneut ein gültiges XMEMO_KEY oder authentifizieren Sie sich erneut über den Begleit-Skill.
• Aktualisierung: Informationen zum Aktualisieren installierter Plugins und Skills finden Sie in der Plugin-Verwaltungsdokumentation von OpenClaw.
• Entfernung: Informationen zum Entfernen oder Deaktivieren installierter Plugins und Skills finden Sie in der Plugin-Verwaltungsdokumentation von OpenClaw.