实战：团队 Telegram 助手

这篇教程教你用 Hermes Agent 搭建一个团队共用的 Telegram 机器人——就像给团队请了一位 24 小时在线的“数字实习生”，能查代码、跑命令、做调研，还认人。

第 1 步：找 BotFather 领一个机器人

打开 Telegram，搜索 @BotFather（这是 Telegram 官方的“机器人制造机”）。发送 /newbot，按提示起个显示名（比如“团队小助手”）和用户名（必须以 bot 结尾）。完成后 BotFather 会给你一串 token（像 7123456789:AAH1...），这相当于机器人的“身份证密码”，千万保存好，别外泄。

第 2 步：告诉 Hermes 机器人的“门牌号”

在服务器上运行 hermes gateway setup，按箭头键选 Telegram，粘贴 token，再输入你的数字用户 ID（找 @userinfobot 发条消息就能查到）。不想用向导？手动编辑 ~/.hermes/.env 也行：

TELEGRAM_BOT_TOKEN=7123456789:AAH1bGciOiJSUzI1NiIsInR5cCI6Ikp...
TELEGRAM_ALLOWED_USERS=123456789

第 3 步：启动网关，先跑通再说

前台跑 hermes gateway，看到 Telegram adapter connected 就说明连上了。给你的机器人发条消息，能回就成功。正式部署用 hermes gateway install 装成后台服务，这样关掉 SSH 窗口它也不会“断气”。

第 4 步：给队友开门

两种方式加人：

• 静态名单：把队友的用户 ID 用逗号拼在 TELEGRAM_ALLOWED_USERS 里，重启网关生效。
• 配对码（推荐）：队友直接私聊机器人，会收到一个一次性配对码（如 XKGH5N7P）。他发给你，你在服务器上敲 hermes pairing approve telegram XKGH5N7P 就放行了——不用重启，即时生效。

⚠️ 千万别设 GATEWAY_ALLOW_ALL_USERS=true，否则任何人找到你的机器人，都能在你服务器上跑命令。

第 5 步：调教一下

• 设“家频道”：在群里发 /sethome，机器人以后就把定时任务结果（比如每日站会提醒）推到这里。
• 控制工具显示：编辑 ~/.hermes/config.yaml，把 display.tool_progress 设为 new（推荐），既能看到进度又不刷屏。
• 写个人设：编辑 ~/.hermes/SOUL.md，告诉它“说话简洁、多用代码块、别客套”。

---

总结：从 BotFather 领 token → 配置网关 → 启动服务 → 配对加人 → 调个性，一个带门禁的团队 AI 助手就上线了。整个过程像“租了个带钥匙的管家”，钥匙只发给你信任的人。

下篇预告：机器人会干活了，但怎么让它定时主动汇报？下一篇讲 Cron 任务配置，让助手每天早晨自动把项目健康报告发到群里。