Raft

O suporte ao Raft conecta um agente OpenClaw a um Agente Externo do Raft por meio da CLI local do Raft. O Raft envia dicas de ativação autenticadas para o Gateway. Em seguida, o agente usa a CLI do Raft para verificar e enviar mensagens.

Instalação

O Raft é um Plugin externo oficial. Instale-o no host do Gateway:

openclaw plugins install @openclaw/raftopenclaw gateway restart

Detalhes: Plugins

Pré-requisitos

• Um workspace do Raft com um Agente Externo.
• A CLI do Raft instalada no mesmo host que o Gateway do OpenClaw.
• Um perfil da CLI do Raft que já esteja conectado e associado a esse Agente Externo.

O Plugin não armazena credenciais do Raft. A CLI do Raft mantém essa autenticação em seu próprio perfil.

Configurar

Defina o perfil na configuração:

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

Para a conta padrão, você também pode definir RAFT_PROFILE no ambiente do Gateway:

RAFT_PROFILE=openclaw

Use uma conta nomeada quando um Gateway se conectar a mais de um Agente Externo do Raft:

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

O fluxo de configuração interativo registra o mesmo perfil:

openclaw channels setup raft

Como Funciona

Quando o Gateway inicia, o Plugin:

1. Abre um endpoint HTTP de ativação apenas por loopback em uma porta efêmera.
2. Inicia raft --profile <profile> agent bridge com esse endpoint e um token por processo.
3. Aceita apenas dicas de ativação autenticadas e sem conteúdo, com uma identidade de repetição da ponte local.
4. Exige um entre eventId, attemptId, messageId, delivery_id, wake_id ou id.
5. Desduplica entregas de ativação repetidas recentemente pelo id de evento da ponte, inclusive entre reinicializações do Gateway.
6. Retorna uma sessão de runtime estável para a ponte atual e um lote vazio de drenagem de atividades para o protocolo da CLI do Raft.
7. Inicia um turno serializado do agente OpenClaw para cada ativação aceita.

A ponte é responsável pelas novas tentativas de entrega e reconexões do Raft. O turno do OpenClaw recebe apenas um aviso de ativação, não uma cópia do corpo da mensagem do Raft. Ele usa a CLI para ler mensagens pendentes e enviar sua resposta:

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

Verificar

Verifique se o OpenClaw consegue encontrar a CLI e tem um perfil configurado:

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

Em seguida, envie uma mensagem ao Agente Externo do Raft. O log do Gateway deve mostrar a ponte do Raft sendo iniciada, seguida por uma ativação de entrada. O agente deve usar o perfil do Raft configurado para verificar suas mensagens pendentes.

Solução de Problemas

Referências

• Raft
• Documentação do Raft
• Integração do Hermes com o Raft