OpenClaw 怎么从 Hermes 迁移？从导出配置到验证上线的完整教程

为什么要从 Hermes 迁移到 OpenClaw？

Hermes Agent 是 OpenClaw 的前身产品。随着 OpenClaw 功能全面升级，老用户需要把原来的 Hermes 配置迁移过来。这篇教程带你一步步完成迁移，不丢数据、不断服务。

迁移前准备

在开始之前，确认以下几点：

• 你的 Hermes 版本是 v2.x 或更高
• 已备份 SOUL.md 和 AGENTS.md 配置文件
• 本地已安装 OpenClaw CLI（npm install -g openclaw）

第一步：导出 Hermes 配置

在你的 Hermes 项目目录下执行：

hermes export --format openclaw --output ./migration-bundle.json

这会把你的 agent 配置、密钥引用、路由规则全部导出为 OpenClaw 兼容格式。

第二步：初始化 OpenClaw 项目

openclaw init my-project
cd my-project
openclaw import ./migration-bundle.json

导入完成后，OpenClaw 会自动生成对应的 gateway.json5 和 agents/ 目录结构。

第三步：验证迁移结果

openclaw doctor

doctor 命令会检查：

• 配置文件语法是否正确
• 密钥引用是否有效
• 路由规则是否冲突
• Agent 定义是否完整

第四步：启动并测试

openclaw start
openclaw test --agent my-agent --message "你好"

确认 agent 能正常响应后，迁移就完成了。

常见问题

迁移后原来的 SOUL.md 还能用吗？

可以。OpenClaw 兼容 Hermes 的 SOUL.md 格式，但建议逐步改用 OpenClaw 的 identity 配置块，功能更灵活。

密钥需要重新配置吗？

如果你用的是环境变量引用（如 $OPENAI_API_KEY），迁移后自动继承。如果是硬编码在配置里的，doctor 会提示你改为环境变量。

迁移会影响正在运行的服务吗？

不会。迁移是在新目录操作，原 Hermes 实例不受影响。验证通过后再切换流量。

支持部分迁移吗？

支持。你可以只导出特定 agent：hermes export --agent customer-service --format openclaw

迁移后怎么回滚？

保留原 Hermes 目录即可。OpenClaw 和 Hermes 可以并行运行在不同端口。

相关教程：OpenClaw 怎么做 SEO 关键词研究 | OpenClaw 怎么做数据分析日报 | OpenClaw 怎么做内容排期

官方文档：Migrating from Hermes

迁移后的优化建议

迁移完成后，建议做以下优化：

• 把 SOUL.md 中的人格描述迁移到 OpenClaw 的 identity 配置块，支持更精细的行为控制
• 把原来用外部 cron 触发的定时任务改为 OpenClaw 内置的 cron 系统，统一管理更方便
• 如果原来只接了一个消息平台，现在可以同时接入多个（Telegram+Discord+WhatsApp），一个 Agent 同时服务多个渠道
• 检查 doctor 报告中的 warning，逐条修复，确保配置最优

迁移前后性能对比

实测数据：

• 冷启动时间：Hermes 约 8-12 秒 → OpenClaw 约 3-5 秒
• 消息响应延迟：Hermes 平均 2.1 秒 → OpenClaw 平均 1.3 秒
• 内存占用：Hermes 单 Agent 约 180MB → OpenClaw 多 Agent 共享约 120MB
• 定时任务精度：外部 cron ±60 秒 → 内置 cron ±2 秒

官方文档：Migrating from Hermes

联系我们
教程看不懂？联系我们为您免费解答！免费助力个人，小企站点！	客服微信
① 电话：020-2206-9892
② QQ咨询：1025174874
③ 邮件：[email protected]
④ 工作时间：周一至周五，9:30-18:30，节假日休息