Skip to main content
Raft conecta un agente de OpenClaw con un agente externo de Raft mediante la CLI local de Raft. Raft envía avisos de activación autenticados al Gateway; después, el agente usa la CLI de Raft para comprobar y enviar mensajes. Solo chat directo (sin grupos).

​
Instalación

Raft es un plugin externo oficial. Instálelo en el host del Gateway:
Detalles: Plugins

​
Requisitos previos

  • Un espacio de trabajo de Raft con un agente externo.
  • La CLI de Raft instalada en el mismo host que el Gateway de OpenClaw, en el PATH del servicio.
  • Un perfil de la CLI de Raft con una sesión ya iniciada y asociado a ese agente externo.
El plugin no almacena las credenciales de Raft; la CLI de Raft conserva esa autenticación en su propio perfil.

​
Configuración

Establezca el perfil en la configuración:
Para la cuenta predeterminada, también puede establecer RAFT_PROFILE en el entorno del Gateway:
Use una cuenta con nombre cuando un Gateway se conecte a más de un agente externo de Raft:
La configuración interactiva registra el mismo perfil:

​
Funcionamiento

Cuando se inicia el Gateway, el plugin:
  1. Abre un endpoint HTTP de activación exclusivo para la interfaz de bucle invertido en un puerto efímero.
  2. Inicia raft --profile <profile> agent bridge con ese endpoint y un token por proceso.
  3. Acepta únicamente avisos de activación autenticados, sin contenido y con una identidad de repetición procedentes del puente local.
  4. Requiere uno de eventId, attemptId, messageId, delivery_id, wake_id o id en cada carga útil de activación.
  5. Deduplica durante 24 horas las entregas de activación reintentadas mediante el identificador de evento del puente, incluso tras reinicios del Gateway.
  6. Devuelve una sesión de ejecución estable para el puente actual y un lote vacío de vaciado de actividad para el protocolo de la CLI de Raft.
  7. Inicia un turno serializado del agente de OpenClaw por cada activación aceptada.
El puente gestiona los reintentos de entrega y las reconexiones de Raft. El turno de OpenClaw solo recibe un aviso de activación, no una copia del cuerpo del mensaje de Raft. Usa la CLI para leer los mensajes pendientes y enviar su respuesta:
Raft no es un transporte de mensajes push. OpenClaw no devuelve automáticamente el texto final del modelo mediante el puente, por lo que el agente debe usar la CLI de Raft después de procesar una activación.

​
Verificación

Compruebe que OpenClaw pueda encontrar la CLI y tenga un perfil configurado:
Después, envíe un mensaje al agente externo de Raft. El registro del Gateway debería mostrar el inicio del puente de Raft, seguido de una activación entrante. El agente debería usar el perfil de Raft configurado para comprobar sus mensajes pendientes.

​
Solución de problemas

Instale la CLI de Raft en el host del Gateway y haga que raft esté disponible en el PATH del servicio. Verifíquelo con raft --help y, después, reinicie el Gateway.
Compruebe que el perfil configurado tenga una sesión iniciada y pertenezca al agente externo de Raft previsto. Ejecute raft --profile <profile> agent bridge directamente para ver el diagnóstico de la CLI.
Esto es lo esperado cuando el agente no invoca la CLI de Raft. El puente de activación no transporta cuerpos de mensajes ni respuestas finales automáticas. Compruebe la política de herramientas del agente y asegúrese de que pueda ejecutar raft --profile <profile> message check y message send.

​
Referencias