Developer and self-hosted
Raft
Raft-Unterstützung verbindet einen OpenClaw-Agenten über die lokale Raft-CLI mit einem externen Raft-Agenten. Raft sendet authentifizierte Wake-Hinweise an das Gateway. Der Agent verwendet dann die Raft-CLI, um Nachrichten zu prüfen und zu senden.
Installation
Raft ist ein offizielles externes Plugin. Installieren Sie es auf dem Gateway-Host:
openclaw plugins install @openclaw/raftopenclaw gateway restartDetails: Plugins
Voraussetzungen
- Ein Raft-Arbeitsbereich mit einem externen Agenten.
- Die Raft-CLI ist auf demselben Host wie das OpenClaw Gateway installiert.
- Ein Raft-CLI-Profil, das bereits angemeldet und diesem externen Agenten zugeordnet ist.
Das Plugin speichert keine Raft-Anmeldedaten. Die Raft-CLI bewahrt diese Authentifizierung in ihrem eigenen Profil auf.
Konfigurieren
Legen Sie das Profil in der Konfiguration fest:
{ channels: { raft: { enabled: true, profile: "openclaw", }, },}Für das Standardkonto können Sie stattdessen RAFT_PROFILE in der Gateway-Umgebung festlegen:
RAFT_PROFILE=openclawVerwenden Sie ein benanntes Konto, wenn ein Gateway eine Verbindung zu mehr als einem externen Raft-Agenten herstellt:
{ channels: { raft: { accounts: { support: { profile: "support-agent", }, engineering: { profile: "engineering-agent", }, }, }, },}Der interaktive Einrichtungsablauf speichert dasselbe Profil:
openclaw channels setup raftFunktionsweise
Wenn das Gateway startet, führt das Plugin Folgendes aus:
- Es öffnet einen nur über local loopback erreichbaren HTTP-Wake-Endpunkt auf einem kurzlebigen Port.
- Es startet
raft --profile <profile> agent bridgemit diesem Endpunkt und einem prozessspezifischen Token. - Es akzeptiert nur authentifizierte, inhaltsfreie Wake-Hinweise mit einer Replay-Identität von der lokalen Bridge.
- Es erfordert eines von
eventId,attemptId,messageId,delivery_id,wake_idoderid. - Es dedupliziert kürzlich wiederholte Wake-Zustellungen anhand der Bridge-Ereignis-ID, auch über Gateway-Neustarts hinweg.
- Es gibt eine stabile Runtime-Sitzung für die aktuelle Bridge und einen leeren Activity-Drain-Batch für das Raft-CLI-Protokoll zurück.
- Es startet für jeden akzeptierten Wake einen serialisierten OpenClaw-Agentendurchlauf.
Die Bridge ist für Raft-Zustellwiederholungen und erneute Verbindungen zuständig. Der OpenClaw-Durchlauf erhält nur eine Wake-Benachrichtigung, keinen kopierten Raft-Nachrichtentext. Er verwendet die CLI, um ausstehende Nachrichten zu lesen und seine Antwort zu senden:
raft --profile openclaw message checkraft --profile openclaw message sendÜberprüfen
Prüfen Sie, ob OpenClaw die CLI finden kann und ein Profil konfiguriert ist:
openclaw channels status --probeopenclaw plugins inspect raft --runtime --jsonSenden Sie anschließend eine Nachricht an den externen Raft-Agenten. Das Gateway-Protokoll sollte zeigen, dass die Raft-Bridge startet, gefolgt von einem eingehenden Wake. Der Agent sollte das konfigurierte Raft-Profil verwenden, um seine ausstehenden Nachrichten zu prüfen.
Problembehebung
Raft CLI is missing
Installieren Sie die Raft-CLI auf dem Gateway-Host und machen Sie raft im PATH des Dienstes verfügbar. Überprüfen Sie dies mit raft --help und starten Sie anschließend das Gateway neu.
The bridge exits immediately
Überprüfen Sie, ob 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.
A wake arrives but no Raft response is sent
Dies wird erwartet, wenn der Agent die Raft-CLI nicht aufruft. Die Wake-Bridge überträgt keine Nachrichtentexte oder automatischen finalen Antworten. Prüfen Sie die Tool-Richtlinie des Agenten und stellen Sie sicher, dass er raft --profile <profile> message check und message send ausführen kann.
