从 OpenClaw 到 Hermes：一条命令完成智能体无缝迁移

 

前言

 

最近，Nous Research 开源的 Hermes Agent 凭借其“自我进化”能力迅速走红，在 GitHub 上已收获 4.7 万+ Star。很多之前使用 OpenClaw 的朋友都在问：如何将现有配置、记忆和技能平滑迁移到 Hermes？

 

好消息是：Hermes 官方提供了完善的迁移工具，整个过程可以做到 “一条命令，无缝过渡”。本文将手把手教你完成迁移，并解决你可能遇到的常见问题。

 

一、迁移前必读

 

1.1 迁移会保留哪些内容？

 

· AI 人格设定（SOUL.md）

· 核心记忆（MEMORY.md / USER.md）

· 自定义技能（skills 目录）

· 各类 API 密钥（OpenAI、Anthropic 等）

· 基础配置文件

 

1.2 不会迁移的内容

 

· OpenClaw 的历史会话日志（但可以手动挑选关键对话转为技能）

· 部分插件或非标准扩展

 

1.3 强烈建议：先备份

 

```bash

cp -r ~/.openclaw ~/.openclaw.backup

```

 

二、方式一：一键自动迁移（推荐）

 

2.1 安装 Hermes Agent

 

```bash

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

source ~/.bashrc # 如果使用 zsh 则改为 source ~/.zshrc

```

 

2.2 运行设置，自动检测导入

 

```bash

hermes setup

```

 

安装程序会自动检测到 ~/.openclaw 目录，并询问：

 

```

Detected existing OpenClaw configuration at ~/.openclaw. Import it? [Y/n]:

```

 

输入 Y，等待迁移完成。

 

2.3 验证迁移结果

 

```bash

hermes doctor # 检查健康状态

hermes chat -q "Hello, introduce yourself" # 简单对话测试

```

 

三、方式二：手动精细迁移

 

如果你需要更精细的控制（比如只迁移数据，不迁移密钥），可以使用 hermes claw migrate 命令。

 

3.1 预览将要迁移的内容

 

```bash

hermes claw migrate --dry-run

```

 

输出示例：

 

```

[DRY RUN] Would copy: /home/user/.openclaw/SOUL.md -> /home/user/.hermes/SOUL.md

[DRY RUN] Would copy: /home/user/.openclaw/MEMORY.md -> /home/user/.hermes/MEMORY.md

...

```

 

3.2 执行迁移

 

```bash

hermes claw migrate

```

 

根据提示确认即可。

 

3.3 常用参数说明

 

参数 作用

--preset user-data 仅迁移用户数据，不包含 API 密钥

--overwrite 若目标文件已存在，强制覆盖

--source /path/to/.openclaw 指定 OpenClaw 配置目录（非默认路径时使用）

--preset full --overwrite 完整迁移（含密钥）并覆盖冲突文件

 

示例：

 

```bash

hermes claw migrate --preset full --overwrite

```

 

四、迁移后的可选调整

 

4.1 检查记忆文件字符限制

 

Hermes 对 USER.md 和 MEMORY.md 有更严格的长度限制（默认各 4096 字符）。如果你的记忆文件较长，可以：

 

· 拆分到多个文件，或

· 编辑 ~/.hermes/config.yaml 中的 memory.max_chars 参数

 

4.2 重新填入失效的 API 密钥

 

如果迁移时跳过了密钥，或密钥已过期，可以手动配置：

 

```bash

hermes config set openai.api_key "sk-xxx"

hermes config set anthropic.api_key "sk-ant-xxx"

```

 

4.3 将历史会话转为技能

 

Hermes 支持从 Markdown 文档中自动学习技能。你可以把 OpenClaw 中重要的历史对话摘录出来，保存为 .md 文件放到 ~/.hermes/knowledge/ 目录，Hermes 会在后台自动处理。

 

五、共存方案：OpenClaw 和 Hermes 同时运行

 

如果你还不确定是否完全切换，可以让两者在同一台机器上和平共处。

 

5.1 原理

 

OpenClaw 和 Hermes 使用不同的配置目录：

 

· OpenClaw：~/.openclaw

· Hermes：~/.hermes

 

它们可以同时安装，互不干扰。

 

5.2 桥接工具：HermesClaw

 

社区提供了 HermesClaw 桥接插件，让你在微信 / Telegram / Discord 等平台上通过命令切换：

 

```

/hermes # 调用 Hermes 回复

/openclaw # 调用 OpenClaw 回复

```

 

这样你可以对比两者的表现，逐步过渡。

 

六、常见问题与解决

 

Q1：迁移后 Hermes 表现怪异，回答不连贯？

 

· 检查 ~/.hermes/MEMORY.md 是否因字符超限被截断。可以先用 hermes reset --memory 重置记忆，再重新导入关键内容。

 

Q2：迁移后原来的自定义技能不生效？

 

· Hermes 的技能目录结构与 OpenClaw 略有不同。将 ~/.openclaw/skills/ 下的文件复制到 ~/.hermes/skills/ 后，运行 hermes skills rebuild 重建索引。

 

Q3：迁移失败，提示权限错误？

 

· 确保 ~/.openclaw 及其文件拥有正确的读写权限：

  ```bash

  chmod -R 755 ~/.openclaw

  ```

 

Q4：想回退到 OpenClaw？

 

· 直接删除或重命名 ~/.hermes 目录即可。你的 OpenClaw 配置从未被修改，始终完好。

 

七、总结

 

从 OpenClaw 迁移到 Hermes Agent 的过程被设计得极为平滑——绝大多数用户只需执行 hermes setup 并回答 Y，即可在 1 分钟内完成所有数据和配置的迁移。Hermes 带来的“自我进化”能力和三层记忆系统，值得你尝试。

 

如果你在迁移过程中遇到任何问题，欢迎在评论区留言，我会尽力解答。