从 OpenClaw 迁移到 Hermes Agent：国内开发者实操指南
hermes-agentopenclawai-agenttutorialchina-guide

从 OpenClaw 迁移到 Hermes Agent：国内开发者实操指南

写在前面

TL;DR — OpenClaw 没死，但 Hermes Agent v0.14.0（2026-05-16 发布）已经从「另一个 coding agent」变成了一个有结构性优势的选项：skills 会自我改进、provider 可热插拔、官方自带 hermes claw migrate 一键迁移。如果你已经把 ofox 的 API Key 配进了 OpenClaw，把同一把 key 填进 Hermes 的 provider: custom 段落就完事，全程 10 分钟以内。下面是逐步操作和常见踩坑。

为什么这次迁移值得做

先说不需要迁的情况：你只用 OpenClaw 做单文件改写、不依赖长期记忆、对工具切换有抵触，那就继续用，它的 IDE 集成和国内网络优化目前仍是最熟的。

需要迁的话，理由集中在这几点：

跨会话的长期记忆。OpenClaw 每次新对话基本从零开始，要你手动喂 context；Hermes Agent 在本地维护一个 user/project profile，第二次跑同类任务时不用再解释一遍。

可复用 skill 的自动沉淀。你在 Hermes 里手动跑过一遍「跑测试 → 看失败 → 改实现 → 再跑测试」，下次它会把这套流程命名存起来，类似任务自动调起。OpenClaw 想做这件事得自己写 prompt 模板。

Pluggable provider 加自动 fallback。v0.14.0 把 provider 体系做成插件式：主用 Claude Opus 4.7，限流时自动切 GPT-5.4，再不行 Gemini 3.1 Pro 兜底；OpenClaw 的多模型切换还停在手动改配置。

数据上 OpenClaw 在国内搜索量仍是 Hermes 的近 3 倍（3548 vs 1257，2026-05 GSC 中文区数据），但 v0.13 之后 Hermes 的曲线翻得很快。半年内大概率拉平，现在迁是吃早期 ROI 的窗口。

OpenClaw vs Hermes Agent：差异速查

维度OpenClawHermes Agent v0.14.0
安装多种渠道，平台不一一条 curl 装好（macOS/Linux/WSL2/Termux）
Provider 体系单 provider 配置，切模型需改文件model + fallback_providers 多层兜底
Skillsprompt 模板，手动维护通过 hermes curator 自动沉淀，跨会话复用
长期记忆会话级~/.hermes/memories/ 跨会话持久化
OpenAI 兼容 API 接入支持，需指定 base_url支持，provider: custom 段
跨工具迁移无官方工具内置 hermes claw migrate 一键导入
国内网络优化自带加速逻辑走 ofox 这类国内 API 网关
配置文件项目级 / 工具级~/.hermes/config.yaml 单文件
适合谁习惯 IDE 工作流的开发者多机切换、跨项目复用 skill 的开发者

短判断：如果你 90% 时间只在一个 IDE 里改一个项目的代码，OpenClaw 够用；如果你在多台机器之间切，或者经常切项目、切语言、切模型，Hermes 的复用能力会越用越香。

迁移实操

下面这套步骤在一台干净的 macOS 上测过，Linux/WSL 流程一致，Windows 原生终端建议先装 WSL2 再跑。

Step 1：备份 OpenClaw 当前配置

不是为了回滚——是为了万一官方迁移工具漏了什么，手里还有原始材料可查。

# 把 OpenClaw 的配置目录整体打包
tar -czf ~/openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/

如果你用的是 IDE 插件形态的 OpenClaw，去插件设置页把 system prompt 和自定义规则导出成纯文本即可。

Step 2：安装 Hermes Agent

官方推荐用 curl 一键脚本，自动处理 uv、Python 3.11、Node.js、ripgrep 等依赖：

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

# 验证版本
hermes --version

支持 macOS / Linux / WSL2 / Termux；Windows 原生用 PowerShell 脚本（早期 beta），建议优先 WSL2。

首次跑 hermes setup 会启动配置向导，创建 ~/.hermes/config.yaml 和 ~/.hermes/.env。

Step 3：用官方迁移命令把 OpenClaw 搬过来

v0.14.0 自带 hermes claw migrate，会自动检测 ~/.openclaw/，把 persona、skills、memories、模型选择搬到 Hermes 对应目录。先 dry-run 看一眼会动什么：

hermes claw migrate --dry-run

确认无误后正式跑，要不要带走 API key 看个人偏好：

# 不带 secrets，干净迁移
hermes claw migrate --preset full

# 把 OPENROUTER_API_KEY / OPENAI_API_KEY / ANTHROPIC_API_KEY 等也带过去
hermes claw migrate --preset full --migrate-secrets --yes

迁完原始文件会归档到 ~/.hermes/migration/openclaw/<timestamp>/archive/，跑 hermes claw cleanup 可以重命名遗留的 OpenClaw 目录。

如果 OpenClaw 装在非默认路径，加 --source /path/to/your/openclaw 显式指定。

Step 4：配置 ofox 作为 custom provider

OpenClaw 那边的 ofox 配置不会自动转过来——Hermes 的 provider 体系结构不同。打开 ~/.hermes/config.yaml，把 model: 段改成：

model:
  provider: custom
  model: anthropic/claude-opus-4.7
  base_url: https://api.ofox.ai/v1
  api_key: ${OFOX_API_KEY}

fallback_providers:
  - provider: custom
    model: openai/gpt-5.4
    base_url: https://api.ofox.ai/v1
    key_env: OFOX_API_KEY
  - provider: custom
    model: google/gemini-3.1-pro-preview
    base_url: https://api.ofox.ai/v1
    key_env: OFOX_API_KEY

base_url 一旦设置，Hermes 会绕过 provider 默认端点直接调它；${OFOX_API_KEY} 走环境变量替换。

把 API Key 写进 ~/.hermes/.env（按官方约定，secrets 放 .env 不放 yaml）：

echo 'OFOX_API_KEY=sk-ofox-...' >> ~/.hermes/.env

API Key 在 ofox 控制台「API Keys」页生成。模型 ID 必须用带 provider 前缀的完整写法（如 anthropic/claude-opus-4.7，注意是点不是横线），以 ofox 模型广场 当前上架版本为准。

不想手改 YAML 也行，跑 hermes model 进交互式选择器，选「custom endpoint」按提示填 base_url 和 key 即可。

Step 5：验证调用

hermes chat 默认进交互模式，做 smoke test 用 -q 跑一次性 prompt：

hermes chat -q "用一句话解释 token 是什么"

如果返回正常回复就接通了。出 401 检查 OFOX_API_KEY 是否正确写入 .env；出连接超时确认 base_url 末尾有没有写错（必须是 /v1，不要带 /chat/completions，Hermes 自己拼）。

Step 6：让 skills 在使用中自动长出来

不要花一整天手写 skills——直接跑一个真实任务：

hermes chat
# 然后在交互界面里输入：
# 把 src/utils 下所有 JavaScript 文件转成 TypeScript，保留原有注释

Hermes 的 curator 后台进程会观察会话、把可复用的工作流沉淀成 skill 到 ~/.hermes/skills/。跑 hermes curator status 看当下抓到了什么，hermes skills list 看已落库的 skill。

跑过 5-10 个真实任务后，常用工作流会自然攒下来，比手动写 prompt 模板高效得多。

常踩的坑

「Model not found」：八成是模型 ID 拼错或 ofox 没上架这个版本。注意 ofox 的 ID 用点不用横线，而且要带 provider 前缀（anthropic/claude-opus-4.7 而不是 claude-opus-4-7）。先 curl https://api.ofox.ai/v1/models -H "Authorization: Bearer $OFOX_API_KEY" 看一眼可用列表，再回去改配置。

fallback 没生效：fallback_providers 默认在 429（限流）、5xx 重试耗尽后触发，401/403/404 会立即切。触发条件由 Hermes 内置，YAML 里无法自定义；如果完全不切，先 hermes config view 确认 fallback_providers 段落格式正确，每个条目都同时有 provider 和 model。

skills 没自动落库：skill 是 curator 后台进程在维护，跑 hermes curator status 看它有没有在跑；如果暂停了用 hermes curator run 拉起。落库目录是 ~/.hermes/skills/，可以直接 ls 检查。

国内 curl 安装脚本超时：脚本会去 GitHub 拉资源，挂个 GitHub 代理或先把 raw URL 内容下到本地再执行；依赖装好后 hermes update 也能拉最新代码。

hermes claw migrate 提示找不到源：默认查 ~/.openclaw/、~/.clawdbot/、~/.moltbot/，自己装在别的路径就加 --source /path/to/your/openclaw。

报错谱系上和 OpenClaw 重叠的部分（429、context length 超限、tool call 格式错），处理思路一致，可以直接参考 AI API 报错排查指南。

该留在 OpenClaw 的三种情况

不是所有人都该迁，先对照下面三条：

  1. 你只在一个 IDE 里工作，且 OpenClaw 的插件覆盖了你所有需求——Hermes Agent 是 CLI-first 的设计，IDE 集成目前还没 OpenClaw 成熟。
  2. 你的团队 SOP 已经把 OpenClaw 的 prompt 体系沉淀完了——切到 Hermes 等于把团队规范重写一遍，迁移成本超过收益。
  3. 你的任务以「单次、独立、不重复」为主——Hermes 的核心价值是 skill 复用和长期记忆，这两个都用不上的话留在 OpenClaw 反而更轻量。

如果你属于这三类，参考 OpenClaw 初始化配置完全指南 和 OpenClaw 2026 模型推荐 把现有配置优化好就够了。

双跑过渡：不必一夜切换

直接砍掉 OpenClaw 不是好策略。推荐两周的双跑期：

  • 第 1 周：新任务一律用 Hermes Agent，老任务继续用 OpenClaw，让 Hermes 自己长 skill
  • 第 2 周：观察 Hermes 攒下的 skill 是否覆盖了你 80% 的日常需求；如果是，把 OpenClaw 降为「IDE 内补刀」用途
  • 第 3 周起：根据实际使用决定是否完全切掉

迁移到一半发现不合适也没事，OpenClaw 的配置还在备份里，回滚成本几乎为零。

收尾

OpenClaw 不会一夜消失，它仍然是稳定的国产 coding agent。但 Hermes Agent v0.14.0 已经把 skills 自演化、provider 热插拔、跨会话记忆这套组合做出了不同形态的产品体验。对国内开发者来说，门槛就是「装包 + 改一段 YAML + 注入 ofox API Key」，配上 ofox 后任意主流模型都能调。

下一步建议：用 Claude Opus 4.7 完全指南 把主用模型调对，再翻一下 OpenRouter 替代方案 看自己该走哪条 API 路径。

最后一句：OpenClaw 的配置备份留着，不急着删。

相关文章

OpenClaw 初始化配置完全指南：从安装到第一次对话（2026）

OpenClaw 多智能体协作配置完全指南：从单兵作战到 AI 团队（2026）

豆包 Seedream 5.0 Lite 图像生成 API 国内接入指南：会"思考"和"联网"的字节图模型（2026）

← 返回文章列表