Hermes Agent v0.20.5 升级指南

通过 hermes --version 可确认当前已安装版本：

Hermes Agent v0.20.5 (2026.8.19) · upstream b6bcb3e7

更新内容概览

Hermes 0.20.5 正式发布于 2026 年 8 月 19 日。它汇编了自 0.20.4 以来的所有改动。以下是用户最需要关注的部分。

Bot Mode 增强

群组聊天体验优化：

• 群组房间线程：Bot Mode 在群组中支持按主题分线，多人对话更有序。
• 折叠式会话摘要：长对话自动生成折叠摘要，减少上下文冗余。
• Blob-face 头像：Bot 显示更直观的头像样式。

keyless web tier（无密钥网页模式）

新安装用户无需任何配置，即可直接使用网页搜索服务：

• 五家免费服务商自动轮询与故障切换（ring failover）。
• 零配置即可使用 web search。

CLI 交互优化

命令行体验改进：

• /model 选择器支持模糊搜索，方便快速切换模型。
• Ctrl+P 命令调色板：快速唤起常用命令，类似 IDE 体验。
• /status 显示更丰富的运行信息。

执行纪律与稳定性

提升稳定运行能力：

• 新增运行时 stall guards：防止 agent 长时间卡住不动。
• 来自 Composica 评测的执行纪律改进：工具自愤能力增强。

更新机制

• hermes update 新增收据回执：记录每次更新的细节。
• hermes worktree list/prune：管理 git worktree 的新命令。

其他亮点

• opencode-free zero-auth provider：支持无认证接入 OpenCode 生态。
• 多题澄询（multi-question clarify）：一次可提出多个选项供用户选择。
• 桌面端性能优化：React Compiler 在双渲染器下加速渲染。
• cron 作业增强：支持持久化记忆 + 每任务自定义推理强度。

说明：完整的、精心编排的发布说明将随 v0.21.0 一并发布。v0.20.5 是一个补丁汇编版本，主要将自 v0.20.4 以来的改动做稳定打包。

如何升级

自动更新（推荐）

hermes update

该命令会执行以下步骤：

1. 备份当前状态：默认 lightweight 模式。如需完整备份，使用：

   hermes update --backup
   

2. 从 GitHub 拉取最新代码。

3. 自动回滚机制：如新代码无法编译，则自动恢复旧版本，避免终端不可用。

4. 安装新依赖。

5. 检测并提示新增配置项。

6. 重启正在运行的网关服务。

更新后验证

# 查看版本
hermes --version

# 运行健康检查
hermes doctor

# 如使用网关，查看网关状态
hermes gateway status

Termux 用户特别注意事项

1. 网络问题
   Termux 环境下 hermes update 可能会因为网络不稳定中断。可重新运行命令重试。

2. Python 环境冲突
   若之前手动配置过 Python 环境，建议先运行 hermes doctor 检查，确保 venv 正常。不要手动删除 venv，交由 hermes update 自动处理。

3. 储存权限
   如遇到 Permission denied 错误，运行 termux-setup-storage 后重试。

4. 后台网关重启失败
   Termux 中后台进程容易被系统杀死，升级后如网关未正常重启，请手动运行：

   hermes gateway restart
   

升级前提醒

• 如果修改过 ~/.hermes/config.yaml 或本地技能文件，升级时会提示是否保留本地变更。
• 升级可能引入新配置项，运行时会提示你逐一确认，建议接受默认。
• 若升级后出现异常，可通过回滚命令恢复：

cd ~/.hermes/hermes-agent
git checkout v2026.8.12  # 替换为上一个版本号
uv pip install -e ".[all]"
hermes gateway restart

远程更新

如果将 Hermes 接入了 Telegram、Discord、Slack 等消息平台，可以直接在聊天中发送以下命令远程更新：

/update

机器人会在 5 到 15 秒内重启网关，完成更新。

---

如果你觉得本文有用，请点赞，收藏，转发

你有什么问题，请留言，我来帮你解答。