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

为什么要从 Hermes 迁移到 OpenClaw?

Hermes 迁移到 OpenClaw 文档页面

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

迁移前准备

在开始之前,确认以下几点:

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

第一步:导出 Hermes 配置

OpenClaw 迁移步骤详解

在你的 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 能正常响应后,迁移就完成了。

common problems

迁移后原来的 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


Contact Us
Can't read the tutorial? Contact us for a free answer! Free help for personal, small business sites!
Customer Service
Customer Service
Tel: 020-2206-9892
QQ咨询:1025174874
(iii) E-mail: [email protected]
Working hours: Monday to Friday, 9:30-18:30, holidays off
© Reprint statement
This article was written by Harry
THE END
If you like it, support it.
kudos11 share (joys, benefits, privileges etc) with others