---
read_when:
    - Sie möchten OpenClaw mit einem Raft-Arbeitsbereich verbinden
    - Sie konfigurieren einen externen Raft-Agenten
    - Sie debuggen die Raft-Wakeup-Zustellung
sidebarTitle: Raft
summary: Unterstützung für externe Raft-Agenten über die Aufweck-Bridge der Raft-CLI
title: Raft
x-i18n:
    generated_at: "2026-07-26T18:20:01Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 454d92d764a4ec3b0ec52467cba254dcad795870e04d1d32d4cf65d8b451a0de
    source_path: channels/raft.md
    workflow: 16
---

Raft verbindet einen OpenClaw-Agenten über die lokale Raft-CLI mit einem externen Raft-Agenten. Raft sendet authentifizierte Aktivierungshinweise an das Gateway; der Agent verwendet anschließend die Raft-CLI, um Nachrichten abzurufen und zu senden. Nur direkte Chats (keine Gruppen).

## Installation

Raft ist ein offizielles externes Plugin. Installieren Sie es auf dem Gateway-Host:

```bash
openclaw plugins install @openclaw/raft
openclaw gateway restart
```

Details: [Plugins](/de/tools/plugin)

## Voraussetzungen

- Ein Raft-Arbeitsbereich mit einem externen Agenten.
- Die Raft-CLI muss auf demselben Host wie das OpenClaw-Gateway im `PATH` des Dienstes installiert sein.
- Ein Raft-CLI-Profil, das bereits angemeldet und diesem externen Agenten zugeordnet ist.

Das Plugin speichert keine Raft-Anmeldedaten; die Raft-CLI verwaltet diese Authentifizierung in ihrem eigenen Profil.

## Konfiguration

Legen Sie das Profil in der Konfiguration fest:

```json5
{
  channels: {
    raft: {
      enabled: true,
      profile: "openclaw",
    },
  },
}
```

Für das Standardkonto können Sie stattdessen `RAFT_PROFILE` in der Gateway-Umgebung festlegen:

```bash
RAFT_PROFILE=openclaw
```

Verwenden Sie benannte Konten, wenn ein Gateway eine Verbindung zu mehreren externen Raft-Agenten herstellt:

```json5
{
  channels: {
    raft: {
      accounts: {
        support: {
          profile: "support-agent",
        },
        engineering: {
          profile: "engineering-agent",
        },
      },
    },
  },
}
```

Bei der interaktiven Einrichtung wird dasselbe Profil gespeichert:

```bash
openclaw channels add --channel raft
```

## Funktionsweise

Beim Start des Gateways führt das Plugin folgende Schritte aus:

1. Es öffnet einen ausschließlich über die Loopback-Schnittstelle erreichbaren HTTP-Aktivierungsendpunkt an einem ephemeren Port.
2. Es startet `raft --profile <profile> agent bridge` mit diesem Endpunkt und einem prozessspezifischen Token.
3. Es akzeptiert ausschließlich authentifizierte, inhaltsfreie Aktivierungshinweise mit einer Replay-Identität von der lokalen Bridge.
4. Es verlangt für jede Aktivierungsnutzlast entweder `eventId`, `attemptId`, `messageId`, `delivery_id`, `wake_id` oder `id`.
5. Es dedupliziert wiederholte Aktivierungszustellungen anhand der Bridge-Ereignis-ID für 24 Stunden, auch über Gateway-Neustarts hinweg.
6. Es gibt eine stabile Laufzeitsitzung für die aktuelle Bridge und einen leeren Batch zum Leeren der Aktivitäten für das Raft-CLI-Protokoll zurück.
7. Es startet pro akzeptierter Aktivierung genau einen serialisierten Durchlauf des OpenClaw-Agenten.

Die Bridge verwaltet Wiederholungsversuche und erneute Verbindungen für die Raft-Zustellung. Der OpenClaw-Durchlauf erhält lediglich eine Aktivierungsbenachrichtigung und keine Kopie des Raft-Nachrichteninhalts. Er verwendet die CLI, um ausstehende Nachrichten zu lesen und seine Antwort zu senden:

```bash
raft --profile openclaw message check
raft --profile openclaw message send
```

<Note>
Raft ist kein Push-Nachrichtentransport. OpenClaw sendet den endgültigen Text des Modells nicht automatisch über die Bridge zurück. Daher muss der Agent nach der Verarbeitung einer Aktivierung die Raft-CLI verwenden.
</Note>

## Überprüfung

Prüfen Sie, ob OpenClaw die CLI finden kann und ein Profil konfiguriert ist:

```bash
openclaw channels status --probe
openclaw plugins inspect raft --runtime --json
```

Senden Sie anschließend eine Nachricht an den externen Raft-Agenten. Im Gateway-Protokoll sollten zuerst der Start der Raft-Bridge und danach eine eingehende Aktivierung erscheinen. Der Agent sollte das konfigurierte Raft-Profil verwenden, um seine ausstehenden Nachrichten abzurufen.

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Die Raft-CLI fehlt">
    Installieren Sie die Raft-CLI auf dem Gateway-Host und stellen Sie `raft` im `PATH` des Dienstes bereit. Überprüfen Sie dies mit `raft --help` und starten Sie anschließend das Gateway neu.
  </Accordion>
  <Accordion title="Die Bridge wird sofort beendet">
    Vergewissern Sie sich, dass das konfigurierte Profil angemeldet ist und zum vorgesehenen externen Raft-Agenten gehört. Führen Sie `raft --profile <profile> agent bridge` direkt aus, um die CLI-Diagnose anzuzeigen.
  </Accordion>
  <Accordion title="Eine Aktivierung geht ein, aber es wird keine Raft-Antwort gesendet">
    Dieses Verhalten ist zu erwarten, wenn der Agent die Raft-CLI nicht aufruft. Die Aktivierungs-Bridge überträgt weder Nachrichteninhalte noch automatische endgültige Antworten. Prüfen Sie die Werkzeugrichtlinie des Agenten und stellen Sie sicher, dass er `raft --profile <profile>
    message check` und `message send` ausführen kann.
  </Accordion>
</AccordionGroup>

## Referenzen

- [Raft](https://raft.build/)
- [Raft-Dokumentation](https://docs.raft.build/welcome/)
- [Hermes-Raft-Integration](https://hermes-agent.nousresearch.com/docs/user-guide/messaging/raft)