skills.rest
spyqs
spyqsCOMMUNITY
Explore all skills by this author →
GitHub

add-telegram-swarm

Routes subagent messages through send-only Telegram bots renamed per sender role.

Updated Mar 15, 2026
Search Tags:#mcp#agent swarm#telegram#docker sandbox#bot pool#ipc routing#role-based messaging
One-click install
npx skills add https://github.com/spyqs/nanoclaw-email-imap --skill add-telegram-swarm-spyqs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-telegram-swarm
Source: https://github.com/spyqs/nanoclaw-email-imap/tree/main/.claude/skills/add-telegram-swarm
Command: npx skills add https://github.com/spyqs/nanoclaw-email-imap --skill add-telegram-swarm-spyqs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It enables multi-agent “swarm/teams” conversations in Telegram by making each subagent speak from a distinct bot identity, so users can clearly tell who is responding.

Core Features & Use Cases

  • Telegram agent teams via bot pool: Uses multiple pool bots that are send-only and dynamically renamed to match agent roles.
  • Stable role-to-bot assignment: Keeps a consistent sender role to a specific bot within each Telegram group/session.
  • MCP message routing with sender identity: Extends send_message with an optional sender field and routes messages through the correct pool bot.
  • Operational prerequisites guidance: Guides you to set up pool bots in @BotFather and disable Group Privacy so messages can be delivered to groups.
  • Team prompt instructions for short, non-markdown group updates: Updates group CLAUDE.md to enforce formatting and consistent sender naming for reliable identity display.

Quick Start

Run /add-telegram first, then run /add-telegram-swarm after you create 3-5 Telegram bots in @BotFather and set TELEGRAM_BOT_POOL in your environment to their tokens.

Frequently Asked Questions about add-telegram-swarm

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make multiple agents in a Telegram group chat appear as distinct identities?▼

To make multiple agents in a Telegram group chat appear as distinct identities, you route subagent messages through a pool of send-only bots renamed per sender role. This assigns a stable, visually distinct bot identity to each agent within the group.

How do I set up a Telegram bot pool for agent swarm messaging?▼

To set up a Telegram bot pool for agent swarm messaging, create 3-5 bots in @BotFather, disable Group Privacy, and set their tokens in the TELEGRAM_BOT_POOL environment variable. You must then run /add-telegram before applying the swarm configuration.

Does agent swarm messaging in Telegram require changes to my MCP tools?▼

Yes, agent swarm messaging in Telegram requires MCP/IPC tool changes so the send_message function accepts an optional sender field. The host then routes messages to sendPoolMessage using a stable group-scoped mapping.

Why do my Telegram pool bots fail to deliver messages in group channels?▼

Telegram pool bots fail to deliver messages in group channels when Group Privacy is enabled. You must disable Group Privacy in @BotFather for each pool bot so they can properly send messages to existing Telegram group channels.

Can I use a single Telegram bot for my multi-agent team workflow?▼

A single Telegram bot cannot display visually distinct identities for a multi-agent team workflow. You need a pool of send-only bots with stable role-to-bot assignment to ensure users can clearly tell which subagent is responding in the group.

What formatting constraints apply to agent swarm messages in Telegram?▼

Agent swarm messages in Telegram require short, non-markdown formatting enforced through group CLAUDE.md instructions. This ensures consistent sender naming and reliable identity display for team updates within the channel.

Related Skills

Explore More Software Engineering Skills→
stevengonsalvezstevengonsalvez

add-telegram-swarm

Run Telegram subagents as distinct bot identities within a group.

Community
Advanced
sbussosbusso
189

add-telegram-swarm

Provision per-agent Telegram pool bots with per-group sender mapping and IPC routing.

Community
Advanced
Runchuan-BURunchuan-BU
401

add-telegram-swarm

Route subagent messages through distinct Telegram bot identities in group chats.

Community
Advanced
E01NE01N

add-telegram-swarm

Route Telegram messages to pool bots with per-agent identities.

Community
Advanced