# OpenClaw

Verbinden Sie OpenClaw über sein natives Speicher-Plugin auf ClawHub mit optionaler Begleit-Skill-Führung für proaktiven Recall.

- Canonical: https://docs.xmemo.dev/de/docs/connect/openclaw
- Locale: de-DE
- Content-Locale: de-DE
- Canonical-Content-Digest: c1ce97e0231b187bac1701fceb894f880bb49f8d6d6dc391398e5decdaf4ff3f
- Edition-Digest: efd463deca16c86c7a8b717c5cbb063fd0e7df22e8a4bd80be2588a83a24d5d1
- Source-Revision: sha256:8f465eb1d6ca0b120934289273aff9d3c032c43de12f628d3bf82b19ef4657b5

## 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:

```bash
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.

```bash
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.

## OpenClaw

Direct client: configure in ~/.openclaw/openclaw.json with XMEMO_KEY in the environment. Run npx @xmemo/client mcp add openclaw to install automatically.

```
{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "openclaw",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}
```