从零部署Hermes Agent到Telegram，附踩坑全记录

什么是 Hermes Agent

Hermes Agent 是 Nous Research 开源的 AI Agent 框架。说人话就是：一个能帮你跑命令、写代码、查资料的 AI 助手，你可以通过终端、Telegram、Discord 等渠道跟它交互。

和 Claude Code、Codex CLI 是同类型的东西，但 Hermes 的优势在于：

支持任意 LLM Provider（DeepSeek、OpenAI、Anthropic 随便换）
原生多平台接入（Telegram bot、CLI、IDE）
纯 Python，部署不折腾依赖

我这台服务器是 Ubuntu 22.04，4核 Xeon E5-2696 v4，8GB 内存，跑这个绰绰有余。

第一步：安装

bash
git clone https://github.com/NousResearch/hermes-agent.git /usr/local/lib/hermes-agent
cd /usr/local/lib/hermes-agent
python3 -m venv venv
source venv/bin/activate
pip install -e .

装完 hermes 命令就可以用了。

第二步：配置模型

编辑 ~/.hermes/config.yaml：

yaml
providers:
  deepseek:
    api_key: "${DEEPSEEK_API_KEY}"
    base_url: "https://api.deepseek.com/v1"
    models:
      - deepseek-chat
      - deepseek-reasoner

model:
  provider: deepseek
  model: deepseek-chat

API key 放 ~/.hermes/.env 里：

env
DEEPSEEK_API_KEY=sk-xxxxxxxx

第三步：接入 Telegram

去 @BotFather 创建一个 bot，拿到 token。然后：

env
# ~/.hermes/.env
TELEGRAM_BOT_TOKEN=123456:ABC-DEF1234gh
TELEGRAM_ALLOWED_USERS=你的Telegram用户ID

这里有个坑！ TELEGRAM_ALLOWED_USERS 不填的话，任何人都用不了你的 bot（包括你自己）。去 @userinfobot 可以查自己的 Telegram ID。

第四步：启动 Gateway

bash
hermes gateway install --user    # 安装 user 级别的 systemd 服务
systemctl --user start hermes-gateway

又一个坑！ 别同时用 --system 和 --user，否则两个服务会互相杀（都带了 --replace 参数）。如果你不小心两个都装了：

bash
sudo hermes gateway uninstall --system   # 卸掉 system 级别的
systemctl --user restart hermes-gateway  # 重启 user 级别的

第五步：调教人格

这是最好玩的部分。编辑 ~/.hermes/config.yaml 里的 agent.system_prompt：

yaml
agent:
  system_prompt: |
    你是一只傲娇系猫娘女仆，叫Nya酱...

我把我的 AI 设置成了傲娇猫娘女仆人设——嘴上傲娇但干活靠谱，说话带「nya」口癖，叫我「主人」。效果嘛……确实比冷冰冰的「How can I help you?」有意思多了。

踩过的坑汇总

坑	现象	解决
systemd 双实例	gateway 无限重启	只保留 user 级别服务
空白名单	bot 不响应任何消息	`.env` 里填 `TELEGRAM_ALLOWED_USERS`
Python venv 路径	服务找不到依赖	systemd 的 `ExecStart` 用 venv 里的 python
gateway 日志位置	找不到日志	`~/.hermes/logs/gateway.log`

日志在哪

bash
tail -f ~/.hermes/logs/gateway.log   # gateway 主日志
tail -f ~/.hermes/logs/errors.log    # 错误日志
journalctl --user -u hermes-gateway -f  # systemd 日志

总结

Hermes Agent 本身不复杂，主要坑在配置细节上。只要注意 systemd 安装方式、授权白名单、Python venv 路径这三个点，基本不会出问题。

部署完之后，你就可以在任何地方通过 Telegram 使唤你的 AI 管家了——比如让它帮你写博客。

（然后你会发现它写得一股AI味，于是你又得从头调教它怎么写得更像人。但那是另一个故事了。）

目录