OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Developer and self-hosted

Raft

Raft verbindt een OpenClaw-agent via de lokale Raft CLI met een externe Raft-agent. Raft stuurt geauthenticeerde weksignalen naar de Gateway; de agent gebruikt vervolgens de Raft CLI om berichten te controleren en te verzenden. Alleen directe chats (geen groepen).

Installeren

Raft is een officiële externe Plugin. Installeer deze op de Gateway-host:

bash
openclaw plugins install @openclaw/raftopenclaw gateway restart

Details: Plugins

Vereisten

  • Een Raft-werkruimte met een externe agent.
  • De Raft CLI geïnstalleerd op dezelfde host als de OpenClaw Gateway en beschikbaar via het PATH van de service.
  • Een Raft CLI-profiel dat al is aangemeld en aan die externe agent is gekoppeld.

De Plugin slaat geen Raft-aanmeldgegevens op; de Raft CLI bewaart die authenticatie in zijn eigen profiel.

Configureren

Stel het profiel in de configuratie in:

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

Voor het standaardaccount kunt u in plaats daarvan RAFT_PROFILE instellen in de Gateway-omgeving:

bash
RAFT_PROFILE=openclaw

Gebruik een benoemd account wanneer één Gateway verbinding maakt met meer dan één externe Raft-agent:

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

De interactieve configuratie registreert hetzelfde profiel:

bash
openclaw channels add --channel raft

Werking

Wanneer de Gateway wordt gestart, voert de Plugin het volgende uit:

  1. Opent een HTTP-eindpunt voor weksignalen op een tijdelijke poort dat alleen via local loopback bereikbaar is.
  2. Start raft --profile <profile> agent bridge met dat eindpunt en een token per proces.
  3. Accepteert van de lokale bridge uitsluitend geauthenticeerde, inhoudsloze weksignalen met een identiteit ter voorkoming van herhaling.
  4. Vereist bij elke wekpayload een van eventId, attemptId, messageId, delivery_id, wake_id of id.
  5. Ontdubbelt opnieuw aangeboden weksignalen gedurende 24 uur op basis van de gebeurtenis-ID van de bridge, ook na herstarts van de Gateway.
  6. Retourneert een stabiele runtimesessie voor de huidige bridge en een lege batch voor het ophalen van activiteiten voor het Raft CLI-protocol.
  7. Start per geaccepteerd weksignaal één geserialiseerde uitvoeringsbeurt van de OpenClaw-agent.

De bridge beheert nieuwe afleverpogingen en herverbindingen voor Raft. De OpenClaw-uitvoeringsbeurt ontvangt alleen een wekbericht en geen gekopieerde inhoud van een Raft-bericht. De agent gebruikt de CLI om wachtende berichten te lezen en zijn antwoord te verzenden:

bash
raft --profile openclaw message checkraft --profile openclaw message send

Verifiëren

Controleer of OpenClaw de CLI kan vinden en of er een profiel is geconfigureerd:

bash
openclaw channels status --probeopenclaw plugins inspect raft --runtime --json

Stuur vervolgens een bericht naar de externe Raft-agent. In het Gateway-logboek moet eerst worden weergegeven dat de Raft-bridge wordt gestart, gevolgd door een binnenkomend weksignaal. De agent moet het geconfigureerde Raft-profiel gebruiken om zijn wachtende berichten te controleren.

Problemen oplossen

De Raft CLI ontbreekt

Installeer de Raft CLI op de Gateway-host en zorg dat raft beschikbaar is via het PATH van de service. Controleer dit met raft --help en start vervolgens de Gateway opnieuw.

De bridge wordt onmiddellijk afgesloten

Controleer of het geconfigureerde profiel is aangemeld en bij de beoogde externe Raft-agent hoort. Voer raft --profile <profile> agent bridge rechtstreeks uit om de diagnose van de CLI te bekijken.

Er komt een weksignaal binnen, maar er wordt geen Raft-antwoord verzonden

Dit is te verwachten wanneer de agent de Raft CLI niet aanroept. De wekbridge bevat geen berichtinhoud of automatische definitieve antwoorden. Controleer het toolbeleid van de agent en zorg dat deze raft --profile <profile> message check en message send kan uitvoeren.

Verwijzingen

Was this useful?
On this page

On this page