Plugin de Relé do Agente OpenClaw Corrige Entrega no Telegram em Configurações Multiagente

Um desenvolvedor lançou o openclaw-agent-relay, um plugin que resolve o problema em que sessions_send em configurações multiagente falha ao entregar respostas aos usuários do Telegram.

O Problema com sessions_send

Ao usar sessions_send para passar mensagens entre agentes, a resposta do agente de destino vai para channel=webchat (um canal interno) em vez de chegar ao usuário no Telegram. Isso acontece porque sessions_send preserva o histórico da sessão e da conversa, mas não lida adequadamente com a entrega. O problema está documentado no ticket fechado #13374 marcado como NOT_PLANNED. Além disso, pode corromper o contexto de entrega da sessão, alterando-o permanentemente de telegram para webchat (referenciado em #44153 e #31671).

Soluções Alternativas Existentes e Suas Limitações

Os desenvolvedores tentaram duas abordagens principais:

• Uso explícito da ferramenta de mensagem: O agente de destino chama message com channel: "telegram" e to/threadId explícitos, então retorna ANNOUNCE_SKIP. Isso está documentado em #47971 e #28603. Os problemas incluem a necessidade de incorporar instruções de entrega em cada payload de sessions_send e os agentes esquecerem de usar a solução alternativa, especialmente em sessões mais longas.
• Depender da etapa de anúncio: Usando timeout=0 para obter uma etapa de anúncio onde o agente pode escrever uma resposta voltada ao usuário. No entanto, os modelos tendem a retornar ANNOUNCE_SKIP em vez de escrever conteúdo (#43295). A entrega de anúncios também tem problemas: perde threadId para tópicos do Telegram (#47971, #45878), falha silenciosamente com configurações multi-canal (#47524), e o texto ANNOUNCE_SKIP pode vazar para os usuários (#45084).

A Solução: openclaw-agent-relay

O plugin ignora tanto sessions_send quanto anúncios completamente. Ele usa o mesmo gateway WebSocket RPC que os subagentes usam internamente (callGateway({ method: "agent" })) para acionar uma rodada do agente na sessão existente com deliver: true. O agente responde normalmente sem instruções especiais, ANNOUNCE_SKIP ou soluções alternativas de ferramentas de mensagem, e a resposta vai diretamente para o Telegram.

Como Usar

Dois métodos estão disponíveis:

• Ferramenta wake_agent: Qualquer agente pode chamá-la para acordar outro agente em sua sessão:
  wake_agent({ sessionKey: "agent:my-agent:telegram:direct:123456", message: "Hey, remind the client about the contract" })
• HTTP POST /notify: Para trabalhos cron, scripts ou gatilhos externos:
  

  curl -X POST http://127.0.0.1:18790/notify \
  -H "Authorization: Bearer your-secret-token" \
  -H "Content-Type: application/json" \
  -d '{"sessionKey":"agent:my-agent:telegram:direct:123456", "message":"Reminder: client asked for the contract"}'

Instalação

Instale com: openclaw plugins install openclaw-agent-relay

O desenvolvedor observa que implementar a autenticação do gateway RPC envolveu trabalhar com identidade do dispositivo Ed25519, protocolos de desafio-resposta e peculiaridades de protocolo não documentadas.