OpenClaw → Hermes 迁移指南

官方 migrate 命令,一条带走人设、记忆、技能和 Key

更新:2026-10-09 · 信息源:Hermes 官方文档与 GitHub 仓库(hermes claw migrate 章节)

为什么迁移

OpenClaw 社区 2026 年起逐步向多分支演进,Hermes 官方专门做了迁移工具:一条命令把你的人设(SOUL.md)、记忆(MEMORY.md/USER.md)、自建技能、常用命令白名单、消息平台配置、API Key 甚至 TTS 音频全部搬进 Hermes,还能从 ~/.openclaw 自动检测。等于换引擎不换脑子。

方式一:安装时自动检测

装 Hermes 后跑 hermes setup,向导检测到 ~/.openclaw 会主动提议迁移,回车确认即可。

方式二:手动迁移命令

hermes claw migrate # 交互式全量迁移
hermes claw migrate --dry-run # 先预览会搬什么(推荐先跑这个)
hermes claw migrate --preset user-data # 只搬用户数据,不带密钥
hermes claw migrate --overwrite # 有冲突时覆盖

搬什么 / 不搬什么

✅ 搬:SOUL.md 人设、MEMORY.md 与 USER.md 记忆、用户自建技能(进 ~/.hermes/skills/openclaw-imports/)、命令白名单、消息平台配置、允许的 API Key(Telegram/OpenRouter/OpenAI/Anthropic/ElevenLabs 等)、TTS 音频资产、AGENTS.md 工作区指令。
⚠️ 注意:OpenClaw 的 ClawHub 技能生态不能直接照搬——技能格式不同,部分技能需要按 Hermes 规范小改;官方也有 openclaw-migration 技能可以做交互式引导迁移。

迁移后验证清单

① hermes doctor 体检无红字;② 终端问一个旧记忆相关的问题,看它能不能从迁移来的记忆里答上来;③ 接一个原来的消息平台发条消息,确认网关通;④ 抽查一个迁移过来的技能还能正常触发。