阿里云、腾讯云的一键部署教程全部在同一个地方结束：进入 WebUI，截个图，文章完。
但如果你照着做完，会发现问题才刚开始——运行的不是最新版本，模型没选对在大量消耗费用，QQ 和微信还没接通，Agent 说自己会记住你但下次对话什么都忘了。
这篇从那个截图之后开始写。
第一步：确认你跑的是哪个版本
一键部署的镜像通常落后官方 1-3 个大版本。登录服务器，运行：
hermes --version
对照 官方发布页，看版本是否一致。
截至 2026 年 4 月底，官方最新版是 v0.11.0（2026-04-23 发布），包含 TUI 完全重写、QQBot 支持、AWS Bedrock 原生接入。如果你的镜像还是 v0.9.x，继续看第二步。
第二步：一条命令升级到最新版
hermes update
这条命令会自动完成四件事：
- 从 GitHub main 分支拉取最新代码
- 安装新增的依赖包
- 检测新版本新增的配置项，交互式提示你填写
- 如果 Gateway 服务正在运行，自动重启
升级完成后验证：
hermes --version # 确认版本号变了
hermes doctor # 检查配置和依赖是否正常
如果你用了腾讯云/阿里云的专属镜像方案，镜像版本由云厂商维护，
hermes update可能不适用。这时候需要 SSH 登录服务器，手动执行以下命令：cd /path/to/hermes-agent git pull origin main git submodule update --init --recursive uv pip install -e ".[all]" hermes config check && hermes config migrate hermes gateway restart不确定安装路径？运行
which hermes或find / -name "hermes-agent" -type d 2>/dev/null。
第三步：选一个不会让你破产的模型
这是一键部署教程最不诚实的地方——它们推荐你用云厂商自己的模型（阿里云推百炼、腾讯云推混元），但这些不一定是最适合你的。
国内用户实际可用的模型方案对比：
| 方案 | 月费估算（个人日常使用） | 直连 | 特点 |
|---|---|---|---|
| DeepSeek V4（推荐） | ¥15-30 | ✅ | 价格最低，缓存命中后成本再降 90%，长上下文能力强 |
| MiniMax M2.7 Token Plan | $10/月（固定） | ✅ | 费用可预测，适合使用规律的用户 |
| 阿里云百炼 Qwen3 | 按用量，¥20-60 | ✅ | 中文理解好，接入最简单（阿里云镜像预配置） |
| Kimi K2.5（月之暗面） | 极低，约¥5-15 | ✅ | 日常任务性价比高 |
| Claude Sonnet 4.x | 高，$30-100+ | ❌需代理 | 复杂推理能力强，日常用太贵 |
DeepSeek V4 的配置方法（推荐先从这里开始）：
hermes model
运行后进入交互式选择菜单：
- Provider 选
deepseek - 输入 DeepSeek 开放平台 的 API Key
- 模型选
deepseek-chat（即 V4）
或者直接编辑配置文件（~/.hermes/config.yaml）：
model:
provider: deepseek
model: deepseek-chat
api_key: sk-your-deepseek-key-here
MiniMax 的配置方法：
hermes model
# Provider 选 "MiniMax China (mainland China endpoint)"
# 输入 Token Plan API Key（和普通 API Key 不同，注意区分）
# 模型选 MiniMax-M2.7
第四步：接通消息平台
一键部署后，大多数人只能在 WebUI 里对话。把 Hermes 接入你真正每天用的平台才算真正用起来了。
接 QQ（v0.11.0 新增原生支持）
v0.11.0 加入了 QQ 官方 API v2 支持，不再需要非官方协议：
hermes gateway setup
# 选择 QQBot
# 按提示扫码授权 QQ 账号
# 选择接入群聊或私聊
配置完成后启动网关：
hermes gateway start
QQ 官方 API 需要在 QQ 开放平台 注册应用，获取 App ID 和 App Secret。接入步骤在官方文档里有完整说明，本站后续会专文覆盖。
接 Telegram（最稳定，推荐测试用）
- 在 Telegram 里找 @BotFather，
/newbot创建一个 Bot，获取 Token - 运行
hermes gateway setup，选 Telegram，粘贴 Token hermes gateway start启动
启动后往你的 Bot 发一条消息，如果有回复说明配置成功。
接微信
微信个人版需要通过 ClawBot 插件或企业微信 API 接入，配置较复杂，后续会单独写文章。
第五步：验证记忆功能是否真的在工作
Hermes 的核心卖点之一是「跨会话记忆」——但一键部署后很多人发现 Agent 每次都「失忆」，这通常是存储路径没配对。
检查方法：
hermes status
# 查看 Memory: enabled/disabled 的状态
ls ~/.hermes/memories/
# 看这个目录是否存在且有内容
如果 memories 目录是空的或不存在，说明记忆还没启用。运行：
hermes setup
# 选择重新配置，找到 Memory 设置项，确认开启
测试是否生效：
- 开一个对话，告诉 Hermes 「记住，我叫张三，是前端开发者」
- 结束这次对话（
exit或关闭 WebUI） - 重新开一个新对话，问「我是做什么的」
- 如果它记得，说明记忆正常工作
第六步：让 Agent 24 小时在线
默认情况下，关掉 SSH 连接后 Hermes 就停了。要让它持续运行：
Linux 服务器（systemd）：
hermes gateway install # 安装为 systemd 服务
systemctl enable hermes # 设置开机自启
systemctl start hermes # 立即启动
验证：
systemctl status hermes # 查看运行状态
journalctl -u hermes -f # 实时查看日志
临时保活（不建议生产用）：
nohup hermes gateway start &
常见报错快速排查
| 报错 / 现象 | 原因 | 解决方法 |
|---|---|---|
API key not set 或模型不响应 | API Key 没配置 | 运行 hermes model 重新配置 |
| 更新后提示配置缺失 | 新版本增加了新配置项 | hermes config check 后 hermes config migrate |
hermes: command not found | PATH 没更新 | source ~/.bashrc 或重新登录 SSH |
| WebUI 能用但 Telegram 不回复 | Gateway 没启动 | hermes gateway start |
| Gateway 启动后几秒就断 | 端口冲突或权限问题 | hermes doctor 查看具体报错 |
| 记忆不工作 | memories 目录权限或路径问题 | 检查 ~/.hermes/memories/ 是否可写 |
| 两台服务器同时运行导致消息丢失 | 同一 Bot Token 不能有两个 Gateway | 先停旧服务器再启新服务器 |
完成后的自检清单
-
hermes --version显示最新版本 -
hermes doctor无报错 - 模型已配置，
hermes命令能正常对话 - 至少一个消息平台的 Gateway 正常运行
- 记忆功能已验证（说一件事，关掉再开，还记得）
- Gateway 已设置为 systemd 服务，开机自启
走完这个清单，你的 Hermes Agent 才算真正配置完毕，而不是停留在云厂商教程里的那个截图上。
相关阅读