如何在 Telegram 上部署 Hermes Agent

为什么 Telegram 是运行 Hermes 的最佳界面

大多数 AI 工具都活在浏览器标签页里。你打开页面、输入问题、读完回复、关掉标签页，上下文随之消失。

Telegram 彻底改变了这一切。当 Hermes 作为 Telegram 机器人运行时，你可以用手机、任何设备、在任何时间与智能体交互，无需打开浏览器，也无需记住任何 URL。消息像普通对话一样送达，智能体在完整的持久化记忆下给出回复。

这就是"全天候 AI 智能体"的实际含义——不是你偶尔想起来才去查看的后台进程，而是你通讯录里一个随时待命、记得一切的联系人。

真正的 Telegram 部署需要什么

把 Hermes 接入 Telegram 不是一条命令就能搞定的事。一套完整的部署有五个独立环节：

1. 在 BotFather 中创建机器人

打开 Telegram，搜索 @BotFather。发送 /newbot，选择显示名称和以 bot 结尾的用户名，复制它返回的 API 密钥。该密钥格式类似 7123456789:ABCDef...，请保存完整字符串。

2. 选择模型服务商

Hermes 需要一个大语言模型来生成回复。OpenRouter 是最简便的选择——一个 API 密钥即可访问 Claude、GPT-4、Llama 等多种模型，无需分别管理不同账号。详细配置方式可参考 OpenRouter 配置指南。

3. 配置运行时

在 config.yaml 中，将服务商密钥、模型选择和 Telegram 设置串联起来：

provider: openrouter
model: anthropic/claude-3-5-sonnet
openrouter_api_key: sk-or-your-key-here
telegram_bot_token: 7123456789:ABCDef...
telegram_allowed_users: "YOUR_NUMERIC_USER_ID"

telegram_allowed_users 字段至关重要。Hermes 只会响应列在此处的 Telegram 用户 ID（数字形式）。你可以在 Telegram 中向 @userinfobot 查询自己的数字 ID，该字段不接受用户名。

4. 启动消息网关

hermes gateway start --detach

网关作为后台进程运行，通过长轮询 Telegram API 将消息路由至 Hermes 运行时。没有网关，机器人可以收到消息，但永远不会回复。

5. 保持持续运行

这是大多数自部署项目最终卡住的地方。只要进程在运行，机器人就能正常工作；进程一旦停止，机器人也就停了。在运行 WSL2 的笔记本上，终端关闭进程就会终止；在廉价 VPS 上，容器回收时进程可能被杀死。真正的生产部署意味着一台持续运行的服务器，并配备进程管理方案（systemd、带重启策略的 Docker，或托管服务）。

最常见的故障模式

机器人无声无息：机器人已在 Telegram 注册，但发消息后没有任何回复。原因要么是网关未运行（执行 hermes gateway status 检查），要么是你的用户 ID 不在 telegram_allowed_users 中。

日志中出现 Unauthorized 错误：机器人令牌已被吊销或填写有误。通过 BotFather 重新生成（/mybots → 选择机器人 → API Token → Revoke），然后更新配置文件。

运行一次后停止响应：Hermes 进程崩溃或网关断开连接。在沉默发生之前检查日志中的错误信息。模型 API 错误（频率限制、额度耗尽）可能导致会话直接退出而非自动恢复。

本地正常，部署后失效：最常见的原因是服务器配置与本地配置不一致，尤其是令牌或允许用户列表。请直接检查服务器端的 config.yaml，而不是本地那份。

Telegram 故障排查指南对以上每种情况都有完整的修复步骤说明。

没人算进去的时间成本

安装命令本身只需五分钟，真正耗时的是运维路径。

当 Hermes 成功在 Telegram 上运行时，它确实非常好用。问题在于从"我想要这个"到"它稳定运行"之间的漫长过程：

搭建 VPS 或服务器环境
安全存储各类凭证
调试网关首次停止响应的问题
处理系统更新后的进程重启
监控在线状态，及时发现机器人沉默

单独来看，每一步都不难。合在一起，它们代表着持续的运维责任。如果你的目标是使用 Hermes 而不是维护它背后的基础设施，这正是最大的摩擦点。

托管方案：Hermify

Hermify 正是专为解决 Telegram 部署问题而设计的。你不再需要自己搭建服务器环境，流程变为：

注册账号并选择套餐
在引导表单中填入 Telegram 机器人令牌和允许的用户 ID
添加模型服务商的 API 密钥（或选择含模型访问额度的套餐）
点击部署

运行时会在持久化服务器上自动完成配置，网关自动启动，机器人在 Telegram 中立即上线。控制台展示运行时状态，支持更新凭证，并允许你在无需 SSH 访问的情况下触发重启。

当自托管的机器人沉默时，你需要调试网关；当 Hermify 上的机器人沉默时，你只需查看状态卡并从控制台重启。

这就是实际差异所在——不是 Telegram 部署能不能实现（显然可以），而是上线之后，谁来负责保持它的健康运行。

自托管与托管服务怎么选

两条路都走得通，选择取决于你愿意承担什么：

选择自托管，如果：你熟悉 Linux 服务器管理，已经在运维同类基础设施，并且希望完全掌控环境、存储和配置。

选择托管服务，如果：你希望 Hermes 在 Telegram 上稳定可用，不想管理服务器，主要目的是使用智能体而非维护它周边的技术栈。

托管 vs 自托管对比对这一决策有更深入的探讨，包括成本拆解和首次部署后的运维预期。