乐于分享
好东西不私藏
当前位置：夜雨聆风 > 技术教程 > 软件教程 > OpenClaw → Hermes 迁移完整指南

OpenClaw → Hermes 迁移完整指南

当前时间： 2026-07-06 15:57:15 更新时间： 2026-07-06 分类：软件教程 评论(0)

OpenClaw → Hermes 迁移完整指南

有读者问我：“我在 OpenClaw 上跑了一些流程，听说 Hermes 的自学习能力更强，要不要迁过去？”

我的答案是——可以迁，而且官方提供了完整的迁移工具，10 分钟左右就能搞定。

下面是我实际迁移的完整记录，照着走一遍就行。

一、先确认能不能迁

迁移之前，先确认三件事：

  • OpenClaw 的目录还在不在——默认在 ~/.openclaw，如果你改过路径，记一下在哪
  • Hermes 已经装好了——迁移目标建议是相对干净的 Hermes 环境。如果你已经在 Hermes 里有了配置，迁移工具会自动处理冲突（用 --overwrite 覆盖或用 --skill-conflict rename 重命名），所以不用紧张
  • 想清楚要迁什么——我最关心的是模型配置、记忆文件、Skills 和 API Key，这些都能迁

满足以上条件，就可以开始了。

二、先预览再执行

Hermes 的迁移工具默认先预览，不直接改动任何东西，比较放心。

第一步：预览迁移内容

hermes claw migrate --source ~/.openclaw --dry-run

--source 指定 OpenClaw 目录（默认就是 ~/.openclaw，没改过的话可以省略）。

--dry-run 让它只预览，不改动任何东西。

执行后会列出所有将被导入的内容，检查一下是不是你想要的。

第二步：正式执行迁移

确认没问题后，正式跑：

hermes claw migrate --source ~/.openclaw --yes

如果你也想把 API Key 一并迁过来，需要加上 --migrate-secrets：

hermes claw migrate --source ~/.openclaw --migrate-secrets --yes

我一开始忘了加这个参数，跑完发现密钥没过来，又重跑了一遍。建议直接加上。

三、到底迁了什么东西过来？

我跑完之后检查了一下，迁移工具做了这些事：

✅ 能迁的

内容
说明
模型配置
OpenClaw 里配的模型提供商和默认模型
MCP 服务器
mcp_servers 中的定义
工作区文件
SOUL.md、AGENTS.md 等
记忆文件
MEMORY.md、USER.md 会追加到 Hermes 的对应文件中（不是覆盖）
Skills
从四个位置扫描：workspace/skills/、~/.openclaw/skills/、~/.agents/skills/、workspace/.agents/skills/，全部迁到 ~/.hermes/skills/openclaw-imports/
API 密钥
加 --migrate-secrets 才会迁。支持的包括 DEEPSEEK_API_KEY、OPENAI_API_KEY、ANTHROPIC_API_KEY、GEMINI_API_KEY 等

❌ 不自动迁的

这些东西不会自动加载到 Hermes，但会保存到 ~/.hermes/migration/openclaw/<timestamp>/archive/ 目录里供人工审查：

  • 插件（plugins/）
  • 历史会话（sessions/）
  • 日志（logs/）
  • 定时任务（cron/）
  • 状态数据库（state.db）
  • 某些旧版配置文件（IDENTITY.md、TOOLS.md、HEARTBEAT.md、BOOTSTRAP.md 等）

原因很简单：Hermes 的会话格式和文件组织方式和 OpenClaw 不完全一样，直接导入可能出问题。 有需要的话，手动迁移就行。

四、迁移完别急着用，先验证

迁移命令跑完后，我做了这几步验证：

1. 检查迁移报告 Hermes 会在终端打印迁移报告，里面会显示有多少内容已迁移、多少被跳过、多少冲突。扫一眼确认没有异常。

2. 验证模型是否正常

hermes chat -q "你现在用的什么模型？"

如果返回的是你在 OpenClaw 里配的模型（比如我的是 DeepSeek），说明迁移成功了。

3. 验证记忆和 Skills

# 检查记忆是否被追加
cat ~/.hermes/memories/MEMORY.md

# 检查 skills 是否到位
ls ~/.hermes/skills/openclaw-imports/

4. 验证 API 密钥

hermes status

检查 provider 的认证状态，确认没有报错。

5. 如果迁移了消息平台 token，重启 gateway

systemctl --user restart hermes-gateway

如果消息平台是 WhatsApp，注意 WhatsApp 使用的是二维码配对（Baileys），不支持 token 迁移，需要单独执行 hermes whatsapp 重新配对。

五、几个常见问题

Q：提示 conflict（冲突）怎么办？ 原因：Hermes 目录下已经存在同名文件或配置。 解决：

# 覆盖已存在的文件
hermes claw migrate --overwrite --yes

# 或者让冲突的 skill 自动重命名
hermes claw migrate --skill-conflict rename --yes

Q：API 密钥没有迁过来？ 原因：默认不迁，需要显式加参数。 解决：

hermes claw migrate --migrate-secrets --yes

如果密钥存在于 ~/.openclaw/.env 或配置文件的 env 子对象中，会被正常读取。但如果密钥使用了 source: "file" 或 source: "exec" 的 SecretRef 格式，则无法自动解析，需要手动添加。

Q：迁移后 skills 没出现？ 导入的 skills 在 ~/.hermes/skills/openclaw-imports/ 目录下。开启新会话后会生效，或者在对话中运行 /skills 验证是否已加载。

Q：迁移后 Hermes 启动异常？ 运行诊断工具检查：

hermes doctor

Q：跑完迁移想恢复备份？ 默认情况下迁移前会在 ~/.hermes/backups/pre-migration-*.zip 自动创建备份，可以通过 hermes import 恢复。

六、最终的结论

我迁完了，用了一段时间，说句实在话：

  • OpenClaw 的优势是生态成熟——2.8 万个 Skill，25+ 消息平台，拿来就能用
  • Hermes 的优势是自学习闭环——会记住你的偏好，自动沉淀经验，越用越懂你

如果你只是想试试 Hermes，建议直接在另一台机器上全新安装体验，别折腾迁移。迁移是有成本的，不是每个人都值得迁。

但如果你已经确定想换，迁移工具能把你的配置、记忆、Skill 一次性带过来，不用从零开始。先用 --dry-run 预览一下，确认没问题再正式跑。

明天预告：迁移完成之后，你最需要的是一份 Hermes CLI 常用命令速查手册——日常操作一分钟就能找到命令，不用每次都翻文档。

明天见。