导览文档
从 OpenClaw 迁移
给已经决定要迁移的人看的执行指南,目标是用更低风险、更低戏剧性的方式完成迁移。
你现在该迁移吗?
如果你已经决定要跟随当前 Hermes 主线,并且能安排时间验证迁移结果,现在可以迁。不要因为“新栈更整洁”就选在脆弱生产周里动手。
推荐迁移流程
- 先运行
hermes claw migrate --dry-run。 - 先看它准备迁移什么。
- 确认映射合理后,再执行真正迁移。
- 迁移后验证 providers、workspace 规则和 messaging。
真正会迁移什么
- SOUL.md 等身份层文件
- Memory 和用户画像内容
- OpenClaw 各技能位置里的 skills
- Provider 和模型相关配置
- 部分 messaging 和集成配置,但迁移后仍需要单独验证
要把迁移理解为“搬运数据和配置”,而不是“自动替你把整个环境变成生产就绪”。真正的环境是否可用,还要靠你后续验证。
迁移后必须验证什么
- 运行 hermes status,确认 provider 认证是否正常
- 确认 AGENTS.md 是否该进入你真正使用的 workspace
- 把 messaging 当成单独验证步骤,而不是默认 token 复制完就算成功
- 查看那些没有直接映射到 Hermes 的归档内容
什么时候应该停下来手工检查
如果迁移报告显示冲突、provider 认证不通过,或者 messaging 还需要平台级修补,就该停下来手工检查。把这些看作正常的运维检查点,而不是整个迁移失败的信号。