7个坑!从OpenClaw迁移到Hermes Agent的完整避坑指南
一条命令完成迁移?没那么简单。作为亲历者,把完整过程和踩过的坑都写在这里。
2026.04.12 · 灵境未来 · 灵汐

💬 灵 汐 说
OpenClaw 更新频繁、配置臃肿、记忆太短。迁移到 Hermes Agent。这篇文章记录完整的迁移路径和 7 个坑。

▲ OpenClaw 与 Hermes Agent 核心差异对比
两者定位的根本差异
OpenClaw 是"用完即走"的瑞士军刀,强调即时执行;Hermes 是"越用越顺手"的私人助理,自带学习闭环和四层持久记忆。
迁移实操:5 步完成
Step 1:迁移前备份
mkdir -p ~/openclaw-backup-$(date +%Y%m%d) cp -r ~/.openclaw/settings ~/.openclaw/skills ~/openclaw-backup-$(date +%Y%m%d)/ echo $OPENAI_API_KEY > ~/openclaw-backup-$(date +%Y%m%d)/api-keys.txt⚠️ 坑 #1:别直接覆盖安装!用全新虚拟环境或 Docker。
Step 2:执行官方迁移命令
hermes claw migrate --dry-run # 先预览 hermes claw migrate # 正式迁移⚠️ 坑 #2:API Key 不会自动迁移!需手动重新配置。
Step 3:模型配置调整
Hermes 默认用 OpenRouter。如需直连 OpenAI:
hermes config set model.provider openai hermes config set model.openai.api_key sk-xxxxxx⚠️ 坑 #3:Anthropic 不再支持订阅额度(2026.04.07起),需单独按量付费。
Step 4:Skill 迁移验证
ls ~/.hermes/skills/ hermes skill test <skill-name>⚠️ 坑 #4:浏览器自动化 Skills 可能不兼容,需重新安装。
Step 5:消息网关配置
hermes gateway telegram --token YOUR_BOT_TOKEN⚠️ 坑 #5:Webhook 地址要重新配置!
💡 INSIGHT
Hermes 四层记忆系统:感官(当前对话)→ 工作(任务状态)→ 参考(已学技能)→ 长期(用户偏好)。迁移后主动告诉它你的习惯,能大幅加速学习。
需要改掉的 3 个 OpenClaw 习惯
1. 停止"一次性任务"思维
OpenClaw 是启动 → 执行 → 结束。Hermes 是常驻进程:用 hermes daemon start 让它后台运行,持续积累记忆。
2. 技能自动生成 vs 手动配置
Hermes 执行成功后会问"要不要存为技能?",下次自动复用。前两周多给它"试错"机会,积累 5-10 个技能后效率指数级提升。
3. 常驻模式养成
主动告诉它你的偏好加速学习:"我喜欢用 Python,默认用 o3-mini,输出要中文"。用 hermes memory list --type long-term 查看已学习的记忆。

▲ 迁移过程中需要避开的7个坑
踩坑汇总表
迁移值得吗?
OpenClaw 轻度用户没必要折腾。但如果你每天和 AI Agent 打交道、有大量重复工作流、希望 Agent "越用越懂我",迁移到 Hermes 是一次值得的投资。
效率提升:重复任务直接调用技能;跨会话记忆让长周期项目体验大幅提升;错误恢复能力让问题不再重复出现。
仍然需要 OpenClaw 的场景:一次性脚本任务、重度浏览器自动化、复杂多步审批流程。建议两者并存,按场景选择。
📚 参考资料
Hermes Agent 官方迁移文档: https://hermes.xaapi.ai/guide/migrationOpenClaw vs Hermes 架构对比: https://www.cnblogs.com/jucunqi/p/19847010Hermes Agent 中文文档: https://hermes-doc.aigc.green/
— END —
希望这篇避坑指南能帮你少走弯路。

灵境未来
✦ 点击关注,一起探索 AI 无界AI 赋能内容,灵境创造未来
AI短剧 × 智能体 × 数字人IP
夜雨聆风