到目前为止，Hermes 一直被困在你的终端里。这一步是它“越狱”的时候。走完这个流程，你就能从手机上、从任何电脑上、从你在哪就在哪的地方，给你的 Agent 发消息。
我们选 Telegram 是因为它最简单。同一个 hermes gateway 也能跑 Discord、Slack、WhatsApp、Signal 和邮件。一个走通了，其他的套路都一样。
你需要什么
- 一个 Telegram 账号(手机端)
- Hermes 已经装好能用(
hermes version和hermes doctor都不报错) - 大概 15 分钟
第 1 步:用 BotFather 创建一个 bot
在 Telegram 里搜 @BotFather。这是 Telegram 官方的 bot，带认证对勾的那种。点进去开始聊天。
发这条命令:
/newbot
BotFather 会问你两件事:
- 显示名 — 别人在聊天里看到的名字。"Hermes" 就行，以后还能改。
- username — 必须以
bot结尾，比如my_hermes_agent_bot。这个改不了，而且全 Telegram 唯一，所以你可能得试几次才能选到没被占用的。
选好合法的 username 之后，BotFather 会给你一个 token，长这样:
123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
把这个 token 复制下来，找个安全的地方存好。 谁拿到这个 token 就能控制你的 bot。当密码看待。
第 2 步:找到你自己的 Telegram user ID
Hermes 用一个“允许的 user ID 列表”当安全门。你只想让自己的 bot 跟自己说话，不想被随便猜到 bot username 的路人戳。
在 Telegram 里搜 @userinfobot，给它发任何一条消息(hi 就行)。它会回你你的数字 user ID——一串 9 位或 10 位的数字。
复制这串数字。
第 3 步:把 bot 的信息告诉 Hermes
跑网关配置向导:
hermes gateway setup
这是一个交互式流程。它会问你要配哪个平台(选 Telegram)，然后问你 BotFather 给你的 token，然后问你允许的 user ID 列表。把你的 user ID 粘进去。
如果你更喜欢直接改文件，可以跳过向导手动配。打开 ~/.hermes/.env 加两行:
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=你的_telegram_user_id
两个值都换成你真实的 token 和 ID。这个文件就是简单的 KEY=value 格式，一行一个，不用引号。
第 4 步:启动网关
hermes gateway
这会启动消息网关进程。别关终端。你会看到日志打出来，网关连接 Telegram、报告 ready。
如果崩了或者报错，看错误信息。这一步九成的问题都是 token 打错了或者 user ID 格式不对。
第 5 步:从手机上打个招呼
打开 Telegram，搜你 bot 的 username(就是第 1 步你定的那个)，给它发一条消息:
hello
你的 bot 应该会回你。在终端那边，你会看到网关日志记录了收到的消息和 Hermes 的回复。
检查点 — bot 回了你的消息，就说明一切都通了。你现在有一个私人 AI Agent，从世界任何地方都能发消息给它。
一个大脑，多个入口
一个容易忽略但很重要的事:Hermes 不区分消息从哪个平台来。你在 Telegram 上说的话、在终端 CLI 里聊的内容、在 Discord 里提到的东西——对 Hermes 来说都是同一个人在跟它说话，记忆是共享的。
这意味着你可以在通勤的时候用手机给 Hermes 布置任务，到了办公室打开终端说"刚才那个做得怎么样了"，它知道你在说什么。不用重新解释上下文，不用复制粘贴。所有平台背后是同一个 Agent 实例、同一份记忆、同一套 Skills。
几个值得试的事
通了之后，下面这几件事会让 Telegram 接入真正变得有用:
发一条语音。 在 Telegram 里录一条语音发过去。Hermes 会把它转写成文字再回你——或者如果你配了 TTS，它会直接回你一条语音。
发一张截图。 把图片扔进聊天，然后问关于它的问题。vision 工具会接管，Hermes 会描述或者分析它看到的。
让它在你电脑上跑个 shell 命令。 记住:gateway 跑在你自己的机器上。当你说“看看我的开发服务器还在不在”，它是真的去看。这就是手机上的 AI Agent 开始感觉像“你电脑的遥控器”的时刻。
让它一直跑
现在网关会在你关终端的时候停。如果你想让它一直在后台跑，装成系统服务:
hermes gateway install
hermes gateway start
查看状态:
hermes gateway status
这样就会有一个正经的后台服务，重启也不影响。相关的子命令还能启动、停止、重启。
出问题了怎么办
Bot 不回。 看终端里的网关日志，它几乎一定会告诉你哪里错了。最常见的原因:token 错了、你的 user ID 没在 TELEGRAM_ALLOWED_USERS 里、或者网关进程默默挂了。重启一下看输出。
收到“未授权用户”的消息。 你的 Telegram user ID 不在允许列表里。回去 @userinfobot 那里再确认一次数字，确认它被写进了 ~/.hermes/.env。
Bot 回了但很慢。 第一条回复经常慢一点，模型要预热。如果一直慢，在普通的终端对话里用 /model 换一个更快的模型。
下一步进入 Stage 4,Hermes 从“会聊天”升级到“会干活”。