你之前一直在跑 OpenClaw 的话,Hermes Agent 是它的继任者。项目血统是一脉的,维护者也是同一拨人,只是改了名又重新设计了一遍。Hermes 的安装器是认得出这件事的——v0.14.0 自带一条一等公民的 hermes claw migrate 命令,一把把你已有的 OpenClaw 状态全搬过来,支持 dry-run,也有现成的 preset。
这篇是实操指南:会迁什么、有哪些 flag、以及"先 dry-run 一遍"那条不会翻车的流程。
1. 装 Hermes Agent
Hermes 的安装向导会自动识别 ~/.openclaw,在开始配置之前先问你要不要迁。最快的一条路:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setup
向导发现你的 OpenClaw 主目录之后会问你要不要迁。说 yes 就行——但要是你想先确切看到它要迁哪些东西,先退出向导,直接跑 migrate 命令。
2. 用 --dry-run 预览一遍
这一步永远先跑。它会把迁移器准备要导入的东西全列一遍,但不写盘:
hermes claw migrate --dry-run
输出按类别分组——SOUL.md、memories、skills、白名单、聊天平台配置、API key、TTS 资源。读一遍。如果看着有不对的(一个你不想迁过来的旧 API key、一份你已经不想再用的人格文件),跳过对应那一段——用 preset 来跳。
3. 挑一个 preset
默认带两个 preset:
- •
full(默认)——什么都迁,包括 secret - •
user-data——除了 API key 别的都迁;secret 你自己手动重填
要换台机器、想跟旧 secret 干干净净分家?用 user-data:
hermes claw migrate --preset user-data
同一台机器升级、想保持连续性?
hermes claw migrate
4. 具体迁什么
照 README 那份对照表:
| OpenClaw | Hermes 这边的目的地 |
|---|---|
SOUL.md(人格) | 原样导入 |
MEMORY.md 和 USER.md 里的条目 | 进 Hermes memory |
| 你自己写的 skill | 复制到 ~/.hermes/skills/openclaw-imports/ |
| 命令白名单(审批模式) | 导入 |
| 聊天配置(平台配置、放行用户、工作目录) | 导入 |
| API key(Telegram、OpenRouter、OpenAI、Anthropic、ElevenLabs) | preset full 下导入 |
| TTS 资源(工作区音频文件) | 导入 |
工作区 AGENTS.md | 用 --workspace-target 导入 |
agentskills.io 上来的 skill 不会自动重装——Hermes 的假设是你会重新去 hub 上挑一遍,通过 hermes skills 装你真想要的。这是故意的:OpenClaw → Hermes 这次改名顺带把 skills hub 也重做了一遍(v0.14.0 把 huggingface/skills 提到了信任默认源),重新挑一遍比一锅端过来干净。
5. 处理冲突
如果 Hermes 在这台机器上已经有配置了(比如你忘了 OpenClaw 还在,先跑过 hermes setup),migrate 命令默认拒绝覆盖。两条出路:
- •
--overwrite——拿 OpenClaw 的值把 Hermes 已有的设置盖掉 - •跳过冲突那一类——冲突在 secret 上的话用
--preset user-data
--overwrite 只在 --dry-run 已经确认过 OpenClaw 那边的值确实是你想要的之后才用。
6. 验一下
hermes doctor
它会跑装好之后的健康检查。memories、skills、白名单、平台配置如果有哪里不到位,doctor 会给你具体报错。改完,重跑,往下走。
备选方案:让 agent 带你走一遍
不想碰 CLI flag 的话,Hermes 自带一个 openclaw-migration skill:
hermes
> /openclaw-migration
这个 skill 会以交互的方式带你过同一套迁移流程,每一步都先 --dry-run 预览。
常见问题
OpenClaw 的数据会丢吗? 不会。迁移器是复制,不是移动。你的 ~/.openclaw 完整保留。万一出问题,删掉 ~/.hermes 就能回退,继续用 OpenClaw。
两个能一起跑吗? 短期可以。它们对 HOME 的假设有重叠,不应该让两边同时拥有同一份 memory。要长期双开,社区那个 HermesClaw 桥接专门处理同一个微信账号上 OpenClaw 和 Hermes 共存。
我的 skill 会坏吗? 你自己写的 skill 会被复制到 ~/.hermes/skills/openclaw-imports/,搬过去之后还能用。来自 agentskills.io 的 skill 是绑在 hub 上的、不是绑在你本地装的——通过 hermes skills 重新装一下。
出问题去哪求助? 先 hermes doctor。然后是 Nous Research Discord 或者 GitHub Issues——README 里都有链接。