从 OpenClaw 到 Hermes:单指令自动完成角色迁移

执行 hermes claw migrate 后角色未完全适配?本文提供一个单指令自动化方案,补全官方迁移命令的覆盖盲区。

执行 hermes claw migrate 后,你的配置文件和技能已迁移到 Hermes,但 Agent 的认知可能仍停留在 OpenClaw 时代。它可能仍自称 “Aris”,尝试访问 ~/.openclaw/ 目录,使用已不存在的工具。

解决方案:发送一条指令,让 Agent 自动检查并修复自身的身份认同和工作逻辑。

角色说明

在继续之前,需要明确两个身份:

身份 所属框架 说明
Aris OpenClaw 原 OpenClaw 生态中的 AI 助手名称,在你的历史配置中使用
Helix Hermes 迁移到 Hermes 后的新身份,需要 Agent 自我认知为此

当 Agent 说 “我是 Aris” 时,它仍在用 OpenClaw 的身份认同运行。你需要让它更新为 “我是 Helix”。

问题背景

官方迁移命令的局限

hermes claw migrate 处理数据层面

  • 复制配置文件到 ~/.hermes/
  • 迁移技能到 ~/.hermes/skills/openclaw-imports/
  • 转移记忆文件

但它不修改文件内容。如果 SOUL.md 写着 “我是 Aris”,迁移后 Agent 仍这样认为。

典型症状

迁移后如果 Agent 出现以下行为,说明需要角色适配:

症状 说明
自称 “Aris” 身份认同未更新
访问 ~/.openclaw/ 路径认知错误
调用 memory_search 使用 OpenClaw 特有工具
提到 “OpenClaw 提供上下文” 框架认知错误

单指令自动化方案

你不需要手动编辑文件。发送以下指令给 Agent,它会自动完成全部检查和修复:

Agent 将自动执行上述检查,直接修改文件,并向你报告变更摘要。

技术细节(供参考)

如果你想了解 Agent 具体会检查什么,以下是技术细节:

身份声明位置

文件 路径 用途
SOUL.md ~/.hermes/SOUL.md 全局身份和性格定义
MEMORY.md ~/.hermes/memories/MEMORY.md Agent 的个人笔记(限制 2,200 字符)
USER.md ~/.hermes/memories/USER.md 用户画像(限制 1,375 字符)

关键差异对比

维度 OpenClaw (Aris) Hermes (Helix)
身份 “我是 Aris” “我是 Helix”
框架 OpenClaw Hermes Agent (Nous Research)
主目录 ~/.openclaw/ ~/.hermes/
记忆存储 .jsonl 文件 SQLite + FTS5
技能查询 memory_search skills_list + skill_view
记忆限制 无明确限制 2,200 / 1,375 字符

实际变更示例

SOUL.md 变更:

MEMORY.md 变更:

验证结果

Agent 完成自检后,会输出类似以下的报告:

手动验证(可选)

如果你想手动确认迁移结果:

参考文档

基于 Hermes Agent v0.7.0 实际迁移经验整理。