智能摘要

Hermes Agent 是 Nous Research 推出的新一代自改进 AI Agent，它在 OpenClaw 的基础上进行了全面升级，引入了更强的记忆系统、技能自学习循环、配置结构优化以及更好的可扩展性。相比 OpenClaw，Hermes 的记忆系统支持更复杂的关联检索，技能系统允许 Agent 自主学习和改进，整体架构更加模块化。

如果你已经使用过一段时间的 OpenClaw，想要尝试使用这个新的 Agent 工具，完全没问题！Hermes 提供了快速迁移的命令，可以把之前 OpenClaw 使用的配置，包括 SOUL（人格设定）、MEMORY（记忆文件）、SKILL（技能配置）、MCP（模型上下文协议配置）、已配置的模型，以及通讯平台配置等。都快速迁移过来，无需从零开始重新配置。

注意：Hermes 目前支持 Linux、macOS 和 WSL2，暂不支持原生 Windows 系统。如果你在使用 Windows，需要通过 WSL2 来运行。

下面是完整、实操性强的迁移全流程。如果你还没有安装 Hermes Agent，可以参考这篇教程：Hermes Agent安装保姆级教程，接入国产大模型

准备工作

在开始前，请做好以下准备，避免数据丢失：

  • 关闭正在运行的 OpenClaw：务必完全停止 OpenClaw 所有服务（包括 systemd 后台服务）。如果服务仍在运行，可能导致数据损坏或服务异常 。
  • 备份 OpenClaw：将整个 ~/.openclaw/ 目录完整复制一份到安全位置，方便恢复。

执行迁移

Hermes 的迁移工具设计得非常安全：它会先显示完整预览，让你确认无误后再执行实际迁移。这避免了误操作导致的数据丢失。

预览迁移内容

先执行下面命令，携带 --dry-run 参数进行模拟运行：

hermes claw migrate --dry-run

运行后会显示将要迁移的内容清单，包括哪些文件会被复制、哪些配置会被转换。强烈建议仔细阅读输出，确认包含 SOUL.md 人格配置、MEMORY.md 记忆文件、技能配置、MCP 服务器配置、模型提供商配置等关键内容。

如果你的 OpenClaw 安装在非标准位置，可以使用 --source 参数指定：

hermes claw migrate --dry-run --source /你的/openclaw/实际路径

选择迁移模式

根据你的安全需求，有三种迁移模式可选：

  1. 标准迁移（完整迁移，包含密钥）：
hermes claw migrate

这会迁移所有配置，包括 API 密钥。适合个人设备且信任环境安全的场景。

  1. 仅迁移用户数据（不含密钥，更安全）：
hermes claw migrate --preset user-data

这会跳过所有密钥和敏感信息，迁移后需要手动重新配置 API Keys。适合多人共用设备或对安全性要求较高的场景。

  1. 显式包含密钥迁移：
hermes claw migrate --migrate-secrets

技能冲突解决

如果 Hermes 已经安装过技能，迁移过程中可能会有技能冲突，如果你不确定是否有重复或哪个版本更新，建议使用 --skill-conflict rename，这样可以在 Hermes 中对比后手动删除不需要的版本。

你也可以按需选择其他选项

选项 说明
--overwrite 冲突时覆盖现有 Hermes 文件（默认是跳过）。适合重新迁移时更新已有配置。
--skill-conflict skip 技能名称冲突时跳过，保留 Hermes 现有版本（默认行为）。
--skill-conflict overwrite 技能名称冲突时用 OpenClaw 版本覆盖 Hermes 版本。
--skill-conflict rename 技能名称冲突时自动重命名，保留两个版本供后续手动选择。

迁移后的关键操作

迁移完成后，还需要执行以下步骤确保 Hermes 正常运行：

  1. 检查配置文件

打开 ~/.hermes/config.yaml，这是 Hermes 的核心配置文件，验证以下设置是否正确从 OpenClaw 映射过来：

# 检查模型配置是否正确
model:
  provider: anthropic
  name: claude-opus-4
 
# 检查压缩设置（控制上下文窗口大小）
compression:
  enabled: true
 
# 检查人工延迟设置（模拟更自然的对话节奏）
human_delay:
  enabled: true
  1. 验证 API Keys

如果使用 --preset full 或 --migrate-secrets，密钥会被写入 ~/.hermes/.env

chmod 600 ~/.hermes/.env

然后运行以下命令确认密钥有效或补充缺失的密钥：

hermes model
# 或
hermes setup
  1. 处理导入的技能

迁移的技能默认位于 ~/.hermes/skills/openclaw-imports/ 目录下。启动 Hermes 后，用以下命令查看技能加载情况：

hermes skills list

注意：OpenClaw 的 LinSkills（zip 插件包格式）与 Hermes 原生技能格式不完全兼容。部分技能可能需要 Hermes 自动重建，或需要手动调整配置文件 。

如果发现有技能冲突或加载失败，可以重新迁移并选择不同的冲突处理策略：

hermes claw migrate --skill-conflict rename
  1. 重建记忆索引（重要！）

迁移后必须运行以下命令，让 Hermes 的向量数据库重新索引所有记忆，确保语义搜索功能正常工作：

hermes memory reindex

这个过程可能需要几分钟，取决于你的记忆文件大小。

  1. 运行诊断检查

官方推荐的验证命令，可以一次性检查配置完整性、模型连接、记忆系统等：

hermes doctor

如果输出显示所有检查项通过，说明迁移基本成功 。

验证迁移是否成功

完成以上步骤后，启动 Hermes 进行实际测试：

hermes

输入几句对话，观察回复风格、记忆引用、技能调用是否与原来的 OpenClaw 一致。

核心文件检查清单

文件/目录 验证命令 预期结果
SOUL.md cat ~/.hermes/SOUL.md 存在且内容完整，包含原有人格设定
MEMORY.md cat ~/.hermes/memories/MEMORY.md 合并了旧记忆，不同来源的记忆用 § 分隔
技能目录 hermes skills list 显示 openclaw-imports/ 下的所有技能
配置 hermes config show 显示正确的模型提供商和参数
记忆搜索 hermes memory search "测试" 返回相关的历史记忆记录
系统健康 hermes doctor 无严重错误或警告

常见问题排查

问题 可能原因 解决方案
技能不加载 缓存未刷新或格式不兼容 重启会话或运行 hermes skills reload
模型调用失败 API Key 无效或配置错误 检查 ~/.hermes/.env 中的密钥和 providers 配置
记忆缺失 向量索引未重建 运行 hermes memory reindex
配置未生效 YAML 语法错误 检查 ~/.hermes/config.yaml 缩进和格式

总结

通过这个流程，绝大多数 OpenClaw 用户都能在 10 分钟内完成迁移，并立即享受到 Hermes 的升级体验：更智能的技能自学习系统、支持复杂关联检索的记忆管理、更灵活的配置架构。

如果你遇到具体错误（如目录未找到、技能冲突、某个配置未迁移），欢迎提供报错信息，我可以帮你进一步排查。

祝迁移顺利！从 OpenClaw 到 Hermes，是让你的 AI Agent 进入下一个阶段的好机会。

本文为原创，未经授权，禁止任何媒体或个人自媒体转载
商业侵权必究，如需授权请联系340443366@qq.com
Hermes Agent