Telegram Managed Bots

一、它是什么

Telegram Managed Bots 是 Telegram 在 Bot API 9.6（2026 年 4 月 3 日）引入的新功能。核心概念：

一个"管理器 Bot"（Manager Bot）可以代用户创建并管理子 Bot。

通俗讲：以前创建 Bot 需要手动找 @BotFather → /newbot → 复制 token → 粘贴到配置文件。现在，用户只需点一个链接、确认一下，Bot 就自动创建好了，管理器 Bot 自动拿到 token 并接管。

二、它的作用

传统创建流程（已淘汰）

1. 打开 @BotFather
2. 发送 /newbot
3. 起名字、设 username
4. 手动复制 token
5. 粘贴到应用配置中

Managed Bot 流程（新）

1. 用户点击一个深链接（如 https://t.me/newbot/ManagerBot/MyAIBot?name=My+AI）
2. Telegram 弹出一个预填好的创建窗口
3. 用户点"确认"
4. 管理器 Bot 自动收到 ManagedBotUpdated 更新
5. 管理器 Bot 调用 getManagedBotToken(user_id) 拿到完整 token
6. 管理器 Bot 现在完全控制这个子 Bot

关键 API

三、它能给你带来什么帮助

1. 零摩擦的 Bot 创建体验

• 不再需要跟 @BotFather 交互、复制粘贴 token
• 用户点链接 → 确认 → 完成，三步搞定

2. 批量 Bot 管理

• 一个管理器 Bot 可以创建和管理无数个子 Bot
• 每个用户的 Bot 独立隔离，管理器统一管控

3. 适合的场景

• SaaS 产品：让用户一键创建自己的 AI 助手 Bot
• 团队工具：为每个团队成员自动分配专用 Bot
• AI Agent 平台：像 Hermes Agent 正在做的，把 hermes setup 简化为"扫码 → 确认 → 完成"
• 游戏/生产力工具分发：用户点击链接即可拥有自己的专属 Bot

4. 安全与所有权

• 子 Bot 在 Telegram 侧归属于用户（不是管理器 Bot 的）
• 管理器 Bot 持有 token，拥有完全控制权
• 用户可以在 Telegram 设置中随时断开连接

四、如何使用

第一步：启用 Bot Management Mode

1. 用 @BotFather 创建一个 Bot（或选一个已有的）
2. 打开 BotFather 的 MiniApp（https://t.me/Botfather?startapp）
3. 进入你的 Bot 设置，开启 “Bot Management Mode”
4. 此时你的 Bot 的 can_manage_bots 字段变为 true

第二步：生成创建链接

格式：

https://t.me/newbot/{manager_bot_username}/{new_username}?name={new_name}

示例：

https://t.me/newbot/HermesSetupBot/my_personal_bot?name=My+Personal+Agent

• manager_bot_username：你的管理器 Bot 用户名
• new_username：建议的子 Bot 用户名（用户可修改）
• name：建议的显示名称（用户可修改）

第三步：接收更新 & 获取 Token

用户确认创建后，你的管理器 Bot 会收到 managed_bot 更新（ManagedBotUpdated 对象），包含：

• 新 Bot 的基本信息
• 创建者的 User 信息

然后调用：

getManagedBotToken(user_id)
→ 返回子 Bot 的完整 API token（字符串）

第四步：控制子 Bot

拿到 token 后，通过标准 Bot API 完全控制子 Bot：

• 收发消息
• 修改头像（setMyProfilePhoto）
• 设置命令（setMyCommands）
• 配置所有标准 Bot 功能

可选：Token 轮换

replaceManagedBotToken(user_id)
→ 生成新 token，旧 token 失效

五、限制与注意事项

六、与 Hermes Agent 的关系

Hermes 已经规划了集成 Managed Bots 的方案（Issue #10591）：

• 目标：把 hermes setup 的 Telegram 配置步骤从"去 @BotFather 创建 Bot → 复制 token → 粘贴到 .env"简化为 “扫 QR 码 → 点确认 → 完成”
• 架构：CLI 生成 nonce → 打印 QR 码（含 deep link） → 用户 Telegram 确认 → 管理器 Bot 拿到 token → 回传给 CLI → 自动写入配置

这个功能如果落地，Hermes 安装体验会丝滑很多。

七、总结

Managed Bots 是 Telegram 官方提供的"Bot 工厂"能力，让一个 Bot 可以批量、自动化地为其他用户创建和管理 Bot，彻底消除了手动创建 Bot 的摩擦。

参考链接

• Telegram Bot Features - Managed Bots
• Telegram Bot API Changelog
• Connected Business Bots
• Hermes Issue #10591