Hermes Agent 版本升级迁移：安全升级完整步骤-China AI Hub

维护咨询大模型部署问题解决技能定制大模型训练

站长交流微信: aixbwz

Hermes Agent 官方在持续更新，新版本带来了新功能和修复。本文介绍如何安全地升级 Hermes Agent，以及升级时需要注意的事项。

升级前必读

升级前查看版本更新日志
重要项目升级前先备份配置文件
大版本升级（如 1.x → 2.x）建议先在测试环境验证
升级后记得验证核心功能是否正常

查看当前版本

# 查看当前版本
hermes --version

# 查看最新版本
hermes check-update

# 查看详细版本信息
hermes doctor

升级方法

方法一：官方脚本（推荐）

# 自动升级到最新版本
hermes upgrade

方法二：手动升级

# 1. 进入安装目录
cd ~/hermes-agent

# 2. 拉取最新代码
git pull

# 3. 更新依赖
pip install -e . --upgrade

# 4. 验证版本
hermes --version

方法三：Docker 升级

# 拉取最新镜像
docker pull nousresearch/hermes-agent:latest

# 停止旧容器
docker stop hermes

# 用新镜像启动（数据卷映射不变）
docker run -d \
  --name hermes \
  -v ~/.hermes:/root/.hermes \
  nousresearch/hermes-agent:latest

升级后验证

# 完整检查
hermes doctor

# 测试核心功能
hermes "你好，测试一下是否正常"

验证清单

✓ 版本号是否更新
✓ API 连接是否正常
✓ 配置文件是否兼容
✓ Skill 是否正常加载
✓ Gateway 是否正常运行（如使用）

配置文件迁移

升级后如果遇到配置文件格式不兼容，按提示修改或重新生成：

# 备份当前配置
cp ~/.hermes/config.yaml ~/.hermes/config.yaml.bak

# 生成新格式配置
hermes setup

# 对比差异
diff ~/.hermes/config.yaml.bak ~/.hermes/config.yaml

配置项变更处理

# 如果提示配置项已废弃，删除旧项：
# 旧版：
old_setting: value  # 这是已废弃的设置

# 新版：
# 直接删除这行，或改为新版格式

Skill 兼容性

# 升级后检查 Skill 状态
/hermes skills list

# 如果有 Skill 加载失败，查看原因
/hermes skills doctor

回滚方法

# 方法一：用 git 回滚
cd ~/hermes-agent
git checkout v1.x.x  # 回滚到指定版本
pip install -e . --force-reinstall

# 方法二：Docker 回滚
docker pull nousresearch/hermes-agent:v1.x.x
docker stop hermes
docker run -d --name hermes ... nousresearch/hermes-agent:v1.x.x