迁移专区

从 OpenClaw 迁移到 Hermes:一条命令搬走全部配置和记忆

Hermes Agent 官方支持从 OpenClaw、Claude Code、Codex CLI、Cursor 一键导入。本文讲清迁移会带走什么、具体怎么操作、迁移后要检查哪些地方。

如果你已经在用 OpenClaw(龙虾),想试试 Hermes Agent,最痛苦的不是安装,而是重新配置一遍:指令、规则、白名单、MCP 服务器、技能、记忆……光想想就头大。

好消息是:Hermes 官方内置了迁移命令,一条命令就能把这些全搬过来。

一、迁移能带走什么

官方 hermes import-agent 支持从以下来源导入:

来源默认目录
OpenClaw~/.openclaw
Claude Code~/.claude
OpenAI Codex CLI~/.codex
Cursor~/.cursor

导入的内容包括:

  • ✅ 指令与规则(instructions / rules)
  • ✅ 工具白名单(allowlists)
  • ✅ MCP 服务器配置
  • ✅ 技能(skills)
  • ✅ 记忆(memories)

不会带走:原来的聊天记录数据库(两边格式不同),以及平台侧的 Bot Token(需要重新绑定)。

二、迁移前准备

  1. 备份 OpenClaw 配置
cp -r ~/.openclaw ~/.openclaw.backup-$(date +%Y%m%d)

Windows 原生用户对应目录是 %USERPROFILE%\.openclaw。

  1. 确认 Hermes 已安装并能运行
hermes --version
  1. 停掉 OpenClaw 的 gateway(避免两边同时抢同一个 Bot Token)

三、执行迁移

hermes import-agent

命令会以交互方式让你选择来源(OpenClaw / Claude Code / Codex / Cursor),确认后开始导入。

💡 建议第一次先导入到新的 profile,确认没问题再切主配置:

hermes profile create migrated

四、迁移后必查的 5 项

检查项怎么查说明
模型配置hermes model原来的 provider 可能需要重新填 Key
技能列表hermes skills list确认技能都进来了
MCP 服务器hermes mcp list检查连接状态
记忆看 MEMORY.md / USER.md确认内容完整
平台绑定hermes gateway setupTelegram/微信等需要重新授权

五、两边都想用?试试 HermesClaw

如果你还没准备好完全切换,社区有个项目 HermesClaw,可以让 Hermes Agent 和 OpenClaw 跑在同一个微信账号上,按需路由。

适合:

  • 想对比两边效果
  • 一部分任务用 Hermes,一部分留在 OpenClaw
  • 逐步迁移,降低风险

项目地址:https://github.com/AaronWong1999/hermesclaw

六、迁移常见问题

Q:迁移后 OpenClaw 还能用吗? 能。导入是复制,不会删除原目录。但建议不要两个 gateway 同时绑定同一个 Bot。

Q:技能不兼容怎么办? Hermes 的技能遵循 agentskills.io 开放标准,大部分通用技能可以直接用。专有格式的技能需要手动调整。

Q:记忆会不会串? 不会。导入的是快照,之后两边各自演化。

Q:能反向迁回 OpenClaw 吗? 官方没提供反向命令,但 Hermes 的配置是明文 YAML/Markdown,手动搬回去并不难。

七、小结

步骤命令
备份cp -r ~/.openclaw ~/.openclaw.backup
导入hermes import-agent
检查hermes model / skills list / mcp list
绑定平台hermes gateway setup

整个流程熟练的话 10 分钟以内能完成。

官方迁移文档:https://hermes-agent.nousresearch.com/docs/user-guide/import-from-other-agents