如何无损把“龙虾资产”注入“战马引擎”？

大家好！在前面的课程中，我们学习了 Hermes 的基础知识。很多同学在社群里问我：

“尹老师，我的 OpenClaw（龙虾）里已经跑了几个月的业务，沉淀了大量的记忆资产和定制技能（Skills），怎么才能无缝过渡到 Hermes，而不需要重头再来？”

今天这一讲，我们进入纯粹的工程实战与架构运维。直接给你提供无损迁移与热升级路线图。

一、 丝滑升级：Hermes 的两路升级与“热重启”机制

进入 2026 年，Hermes 的生态演进极快。它的更新机制针对生产环境做了极度苛刻的工程优化。根据我们最初的安装方式，升级分为两条路径：

Pip / UV 模式（标签版本跟踪）

如果你使用的是标准 PyPI 发布版，Hermes 提供了极简的命令。它不会盲目拉取 main 分支的每一次 commit，而是严格跟踪主次版本标签：

Bash

hermes update --check    # 仅预览：查询 PyPI 是否有更新版本，不改动任何文件
hermes update            # 执行升级，等同于 uv pip install --upgrade hermes-agent

Git 源码模式（前沿特性驱动）

如果你在生产环境中采用的是 Git 仓库克隆模式，运行 hermes update 时，底层会原子化地顺序触发以下 5 步自动化黑魔法：

[运行 hermes update]
       │
       ▼
1. 配对数据快照 (Snapshot)  ──► 备份 ~/.hermes/pairing/、飞书评论规则等运行时文件
       │
       ▼
2. Git Pull & Submodule    ──► 从 main 分支拉取最新代码，同步更新子模块
       │
       ▼
3. 依赖项原子安装           ──► 自动运行 uv pip install -e ".[all]"
       │
       ▼
4. 配置交互迁移 (Migrate)   ──► 自动检测新增配置项，提示交互式补全
       │
       ▼
5. Gateway 自动热重启       ──► Linux(systemd) / macOS(launchd) 映射 PID，立即使新代码生效

提示：对于生产环境的高价值 Profile，升级前必须强制追加 --backup 参数（即 hermes update --backup），对 HERMES_HOME 下的所有配置、认证、会话、技能进行完整备份。你也可以在 config.yaml 中将 updates.pre_update_backup 设为 true。