Plugin de Relais d'Agent OpenClaw Corrige la Livraison Telegram dans les Configurations Multi-Agents

Un développeur a publié openclaw-agent-relay, un plugin qui résout le problème où sessions_send dans les configurations multi-agents ne parvient pas à délivrer les réponses aux utilisateurs de Telegram.

Le problème avec sessions_send

Lors de l'utilisation de sessions_send pour transmettre des messages entre agents, la réponse de l'agent cible va vers channel=webchat (un canal interne) au lieu d'atteindre l'utilisateur sur Telegram. Cela se produit parce que sessions_send préserve la session et l'historique des conversations mais ne gère pas correctement la livraison. Le problème est documenté dans le ticket fermé #13374 marqué comme NOT_PLANNED. De plus, il peut corrompre le contexte de livraison de la session, le faisant passer de telegram à webchat de manière permanente (référencé dans #44153 et #31671).

Solutions de contournement existantes et leurs limites

Les développeurs ont essayé deux approches principales :

• Utilisation explicite de l'outil message : L'agent cible appelle message avec channel : "telegram" et des to/threadId explicites, puis retourne ANNOUNCE_SKIP. Ceci est documenté dans #47971 et #28603. Les problèmes incluent la nécessité d'intégrer des instructions de livraison dans chaque payload de sessions_send et les agents oublient d'utiliser la solution de contournement, surtout dans les sessions plus longues.
• S'appuyer sur l'étape d'annonce : Utiliser timeout=0 pour obtenir une étape d'annonce où l'agent peut écrire une réponse destinée à l'utilisateur. Cependant, les modèles ont tendance à retourner ANNOUNCE_SKIP au lieu d'écrire du contenu (#43295). La livraison d'annonce a aussi des problèmes : elle perd le threadId pour les sujets Telegram (#47971, #45878), échoue silencieusement avec les configurations multi-canaux (#47524), et le texte ANNOUNCE_SKIP peut fuiter vers les utilisateurs (#45084).

La solution : openclaw-agent-relay

Le plugin contourne à la fois sessions_send et l'annonce. Il utilise le même RPC WebSocket de la passerelle que les sous-agents utilisent en interne (callGateway({ method: "agent" })) pour déclencher un tour d'agent dans la session existante avec deliver : true. L'agent répond normalement sans instructions spéciales, ANNOUNCE_SKIP, ou solutions de contournement d'outil de message, et la réponse va directement vers Telegram.

Comment l'utiliser

Deux méthodes sont disponibles :

• Outil wake_agent : Tout agent peut l'appeler pour réveiller un autre agent dans sa session :
  wake_agent({ sessionKey: "agent:my-agent:telegram:direct:123456", message: "Hey, remind the client about the contract" })
• HTTP POST /notify : Pour les tâches cron, scripts, ou déclencheurs externes :
  

  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"}'

Installation

Installez avec : openclaw plugins install openclaw-agent-relay

Le développeur note que la mise en œuvre de l'authentification RPC de la passerelle a impliqué de travailler avec l'identité de l'appareil Ed25519, des protocoles de défi-réponse et des particularités de protocole non documentées.