add-telegram-swarm

Multi-agent teams post as distinct named bot identities by assigning separate Telegram bot pool tokens to subagents. This provides visible agent separation and role-based messaging coordination within a single Telegram group.

Setting up multi-agent Telegram messaging requires an existing Telegram channel, multiple pool bot tokens with Group Privacy disabled, and TELEGRAM_BOT_POOL configured in your environment. Host IPC routing and Telegram module changes are also necessary to initialize send-only pool APIs.

When the Telegram bot pool is unavailable, the system falls back to using the main bot identity for messaging. This ensures continuous multi-agent coordination even if a specific pool bot token becomes unresponsive during group workflows.

Disabling Group Privacy on your pool bot tokens is required to enable agent swarm messaging. This allows the distinct subagent bots to properly read and send role-based messages within the Telegram group environment.

You can use this approach for a researcher and coder multi-agent team where each teammate posts short, role-branded updates directly in the Telegram group. Each agent's messages appear from a uniquely named bot for clear visual separation.