Raft

La prise en charge de Raft connecte un agent OpenClaw à un Agent externe Raft via la CLI Raft locale. Raft envoie des indices de réveil authentifiés au Gateway. L’agent utilise ensuite la CLI Raft pour vérifier et envoyer des messages.

Installation

Raft est un Plugin externe officiel. Installez-le sur l’hôte du Gateway :

openclaw plugins install @openclaw/raftopenclaw gateway restart

Détails : Plugins

Prérequis

• Un espace de travail Raft avec un Agent externe.
• La CLI Raft installée sur le même hôte que le Gateway OpenClaw.
• Un profil CLI Raft déjà connecté et associé à cet Agent externe.

Le Plugin ne stocke pas les identifiants Raft. La CLI Raft conserve cette authentification dans son propre profil.

Configuration

Définissez le profil dans la configuration :

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

Pour le compte par défaut, vous pouvez plutôt définir RAFT_PROFILE dans l’environnement du Gateway :

RAFT_PROFILE=openclaw

Utilisez un compte nommé lorsqu’un Gateway se connecte à plusieurs Agents externes Raft :

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

Le flux de configuration interactif enregistre le même profil :

openclaw channels setup raft

Fonctionnement

Au démarrage du Gateway, le Plugin :

1. Ouvre un point de terminaison HTTP de réveil limité au loopback sur un port éphémère.
2. Lance raft --profile <profile> agent bridge avec ce point de terminaison et un jeton propre au processus.
3. Accepte uniquement les indices de réveil authentifiés, sans contenu, avec une identité de relecture provenant du pont local.
4. Exige l’un des champs eventId, attemptId, messageId, delivery_id, wake_id ou id.
5. Déduplique les livraisons de réveil réessayées récemment selon l’identifiant d’événement du pont, y compris entre les redémarrages du Gateway.
6. Renvoie une session d’exécution stable pour le pont actuel et un lot de vidage d’activité vide pour le protocole CLI Raft.
7. Lance un tour d’agent OpenClaw sérialisé pour chaque réveil accepté.

Le pont gère les nouvelles tentatives de livraison Raft et les reconnexions. Le tour OpenClaw reçoit uniquement un avis de réveil, pas une copie du corps du message Raft. Il utilise la CLI pour lire les messages en attente et envoyer sa réponse :

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

Vérification

Vérifiez qu’OpenClaw peut trouver la CLI et dispose d’un profil configuré :

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

Envoyez ensuite un message à l’Agent externe Raft. Le journal du Gateway doit afficher le démarrage du pont Raft, suivi d’un réveil entrant. L’agent doit utiliser le profil Raft configuré pour vérifier ses messages en attente.

Dépannage

Références

• Raft
• Documentation Raft
• Intégration Hermes Raft