将 OpenClaw 迁移到 Hermes 只需一个官方命令：hermes claw migrate。它读取 ~/.openclaw/，在写入任何内容前显示完整预览，并默认先写入还原点 zip——但它不会导入你的 cron 任务，而迁移设置悄悄开始重复付费的地方正是这一遗漏。安全顺序是备份、试运行、应用、在新会话中验证、停止旧调度器，然后清理。
首先明确所指的产品，因为此查询会与三个无关产品混淆。本页面讨论的是 Nous Research 的 Hermes Agent——CLI 和网关，最新版本为 v0.21.3（标签 v2026.9.14，发布于 2026 年 9 月 14 日）——以及 OpenClaw Foundation 的 OpenClaw，最新版本为 v2026.9.5，发布于 2026 年 9 月 19 日。2026 年 9 月 21 日重新核对元数据时，两个代码仓库都仍可访问且未归档。它不是 Hermes 4（Nous Research 的独立开放权重模型系列），不是 Meta 的 Hermes JavaScript 引擎，也不是那家奢侈品牌。如果你仍在使用 ~/.clawdbot/ 或 ~/.moltbot/，那是同一产品的早期名称；导入器会检测这两个目录以及 clawdbot.json / moltbot.json 配置文件名。
人们为什么迁移，以及谁不应迁移
价格不是原因。两个项目都是自由软件：OpenClaw 的 README称其“没有付费层、托管服务或代币”，其 LICENSE 文件明确采用 MIT，尽管 GitHub API 将仓库许可证字段报告为 NOASSERTION——请引用该文件，而不是该字段。GitHub API 将 Hermes Agent 报告为 MIT 许可证，见GitHub API。无论使用哪一个，你付费的都是模型代币，以及运行网关的主机。
| 在以下情况下迁移到 Hermes | 在以下情况下留在 OpenClaw |
|---|---|
| 你希望以记忆和技能工作流为产品核心，并愿意重新创建调度任务 | 你的频道绑定、插件和钩子是设置中真正发挥作用的部分——三者都会被归档，而不是导入 |
| 你的设置主要由角色设定、指令、记忆和技能组成，而这正是导入器处理的集合 | 你运行多代理列表或复杂的频道拓扑；这些也会被归档 |
| 你希望在使用自有密钥的同时，拥有一个由单一供应商运行的订阅选项 | 你明确需要一个完全没有商业层的 501(c)(3) 管理方 |
有一项值得保留的修正，因为旧版比较页面已经过时：反向迁移不再仅限于记忆。OpenClaw 现在记录了带完整预览的迁移——先运行 openclaw migrate hermes --dry-run，再运行 openclaw migrate apply hermes --yes——会导入模型配置、提供商和自定义端点、MCP 服务器、SOUL.md 和 AGENTS.md、记忆文件（追加）、记忆配置、带配置的技能，以及在获得同意后导入认证凭据。该文档仍称为仅记忆复制的，是其引导流程和控制界面的记忆导入：它们会将 MEMORY.md 和 USER.md 放在 memory/imports/hermes/ 下，而不触碰现有工作区记忆。因此这是双向通道，但返程有一项警告：不要让 Hermes 和 OpenClaw 共用同一个刷新授权。
哪些内容会迁移，哪些内容会被改为归档
将此表视为验收清单。右侧栏中的任何内容都需要你手动完成，并按你选择的时间安排；这不是工具失败——Hermes 会有意将其归档到 ~/.hermes/migration/openclaw/<timestamp>/archive/ 下。
| 资产 | OpenClaw 来源 | Hermes 目标 | 注意事项 |
|---|---|---|---|
| 角色设定 | workspace/SOUL.md | ~/.hermes/SOUL.md | 直接复制 |
| 工作区指令 | workspace/AGENTS.md | 目标中的 AGENTS.md | 需要 --workspace-target |
| 长期记忆 | workspace/MEMORY.md | ~/.hermes/memories/MEMORY.md | 解析为条目，合并并去重——不会逐字复制 |
| 用户资料 | workspace/USER.md | ~/.hermes/memories/USER.md | 相同的条目合并逻辑 |
| 技能 | 四个位置，包括 workspace/skills/ 和 ~/.openclaw/skills/ | ~/.hermes/skills/openclaw-imports/ | 冲突由 --skill-conflict 解决 |
| 自定义提供商 | models.providers.* | custom_providers 位于 config.yaml | 之后自动迁移到 providers: 字典——见下文 |
| Cron 任务 | cron 配置 | 仅归档 | 使用 hermes cron create 重新创建 |
| 插件、钩子和 Webhook | 插件和钩子配置 | 仅归档 | 没有自动等价项 |
| 频道绑定、多代理列表 | 频道和代理配置 | 仅归档 | 手动重建 |
| 频道凭据 | 不可转移 | 通过 Baileys 使用 QR 配对；运行 hermes whatsapp 重新配对 |
有两种映射的损失程度会被清单掩盖。agents.defaults.timeoutSeconds不会变成 Hermes 超时，而会变成 agent.max_turns，其计算结果为 timeoutSeconds / 10，并以 200 为上限。而 OpenClaw 的十值推理力度词汇会压缩为三个值：always、high 和 xhigh 都归入 high；auto、medium 和 adaptive 归入 medium；off、low、none 和 minimal 归入 low。两者都是算术转换，不是复制，因此请检查生成的值，不要假设旧调优得以保留。会话空闲计时器和每日重置计时器完全不会导入：Hermes 对话会一直持续，直到明确执行 /new 或 /reset。以上内容均来自官方的 从 OpenClaw 迁移指南，阅读日期为 2026 年 9 月 19 日。
逐个标志说明命令
| 标志 | 它的作用 |
|---|---|
--dry-run | 仅预览；显示将要迁移的内容后停止 |
--preset user-data|full | user-data不包括基础设施配置；两个预设都不会导入密钥。指南没有说明默认值——请查看预览以确认你获得了哪个值 |
--overwrite | 发生冲突时覆盖；默认情况下，只要计划中存在任何冲突，就拒绝应用 |
--migrate-secrets | 包含 API 密钥——即使使用 --preset full 也必须提供 |
--no-backup | 跳过 ~/.hermes/ 的迁移前 zip 快照 |
--source <path> | 从自定义 OpenClaw 目录读取 |
--workspace-target <path> | AGENTS.md 的放置位置 |
--skill-conflict skip|overwrite|rename | 默认使用 skip；rename 创建一个 -imported 副本 |
--yes | 预览后跳过确认提示 |
以下工作顺序遵循官方迁移后清单，没有添加额外步骤。第一，停止 OpenClaw 的计划任务：openclaw cron list，然后对任何会造成重复运行的内容执行 openclaw cron disable <job-id>（openclaw automations 是两者都适用的文档化别名）。第二，试运行。第三，应用，并让默认的还原点 zip 写入。第四，阅读迁移报告以及归档目录中的所有内容。第五——这一点常常让人中招——启动新会话；导入的技能和记忆条目不会在你已经处于其中的会话里生效，而 /skills 会确认加载了什么。第六，使用 hermes status 完成提供商认证；如果迁移了平台令牌，则重启网关；如果使用了 WhatsApp，则重新配对。只有在所有这些步骤都通过后，才运行 hermes claw cleanup；它会将遗留的 OpenClaw 目录重命名为 .pre-migration/，以便两个代理不会读取同一状态。这是独立的子命令，不是 migrate 的标志；指南没有为它记录任何专属标志。
关于顺序的注意事项是诚实而非令人安心：Hermes 文档将清理放在第 8 步，并没有说明在 OpenClaw 网关服务仍然安装时重命名其目录会发生什么。先停止 OpenClaw 调度器和网关，是根据两个项目文档都能辩护的做法；但这不是任何一个项目明确写出的顺序。
重复调度账单：完整计算
Cron 任务会被归档，而不是导入。因此自然会出现这样的失败：你在 Hermes 中重新创建四个任务，OpenClaw 网关仍然安装着，于是每个计划提示都会针对你的提供商运行两次。以下成本是代币算术，不是经过测量的任务成本，也不是账单上限。假设一次计划运行发送 25,000 个未缓存输入代币并返回 1,500 个输出代币，并且四个每两小时触发一次的任务每天产生 48 次重复运行。费率是实时的 Kunavo 目录每百万代币价格。
| 模型 | 每 1M 个令牌的输入 / 输出 | 一次重复运行 | 48 次重复运行，一天 | 相同情况，30 天 |
|---|---|---|---|---|
| Claude Haiku 4.5 | $0.70 / $3.50 | $0.0227 | $1.09 | $32.76 |
| Claude Sonnet 4.6 | $2.10 / $10.50 | $0.0683 | $3.28 | $98.28 |
| Claude Opus 5 | $3.50 / $17.50 | $0.1138 | $5.46 | $163.80 |
替换为你自己的运行规模和频率；重点是乘数，而不是这一行。如果重复工作已经在运行，Hermes 文档给出了一个单一控制手段：hermes pause是全局紧急停止——不会触发新的 cron，不会派发 kanban，也不会启动网关回合，直到 hermes resume；正在执行的工作不会被终止。用它止血，然后禁用正确的一侧。注意 OpenClaw 侧的权限边界：其自动化参考称，add/create、edit、remove和run需要 operator.admin。它没有说明 disable 是否属于该集合，因此应按需要该角色来做预算。
另外两个较隐蔽的迁移后成本来源值得说明。Hermes 的模型配置页面警告，提示缓存以服务请求的模型为键，因此在对话中途切换 /model 会使下一条消息以完整输入代币价格重新读取整个对话；其备用提供商页面对自动备用也作出相同说明，而其凭据池页面称，提供商侧缓存限定于发出请求的账户或密钥，因此轮换池也会产生一次全价读取。在 Claude Sonnet 4.6 的目录费率下，重新读取一个 200,000 代币的对话，按 $2.10 输入费率计算约为 $0.420，而按 $0.21 缓存读取费率计算约为 $0.042——同样是在所述假设下的示例性算术。Hermes 提供 model.switch_context_confirm_tokens 作为防护措施。此外，同一页面称，辅助槽位——视觉、网页摘要、压缩等——默认使用 provider: auto，且 model 为空；页面将其解释为对该任务使用主模型，因此刚迁移的设置可能会在你覆盖配置前，以旗舰费率为后台工作计费。
让迁移后的 Hermes 指向你自己的端点
Hermes 的提供商文档称，它支持任何兼容 OpenAI 的 API 端点。迁移特有的陷阱在于你导入的提供商落在哪里：OpenClaw 的 models.providers.* 条目会写入 custom_providers，只有在下一次 hermes update 配置迁移时，才会成为规范 providers: 字典中的条目。迁移后立即告诉你去 providers: 下查找的指南，会把你引向一个空键。
# What `hermes claw migrate` writes FIRST. An OpenClaw
# `models.providers.*` entry lands under `custom_providers`,
# not under `providers:` — so check here right after migrating.
custom_providers:
- name: kunavo
base_url: https://api.kunavo.com/v1
api_key: sk-your-kunavo-key
model: claude-sonnet-4-6
# The providers doc says the legacy list is auto-migrated to the
# canonical `providers:` dict on `hermes update` (config v12). The
# documented keys of that dict are `api`, `key_env`, `transport`
# and `default_model` (`base_url`/`url` are accepted aliases of `api`).
providers:
kunavo:
api: https://api.kunavo.com/v1
key_env: KUNAVO_API_KEY
transport: chat_completions
default_model: claude-sonnet-4-6关于这部分有三点说明。导入器会映射 OpenClaw 中的短格式 API 值（openai、anthropic）和带连字符的 API 值（openai-completions、anthropic-messages、google-generative-ai）。Hermes 自己的文档对传输名称存在矛盾——提供商参考文档列出 chat_completions、anthropic_messages和codex_responses，而模型配置页面写作 transport: openai_chat；请使用 chat_completions，因为这是专用提供商参考文档给出的值，并将 openai_chat 视为未经确认。自定义的兼容 OpenAI 端点在 Hermes 中不会自动获得目录规模的输出上限，因此请自行设置 context_length，或者提供一个明确的 models: 列表并附带 discover_models: false，以防对你的端点进行发现时行为异常。
为明确说明本页的限制：Kunavo 发布了多个客户端的设置参考，但 Hermes Agent 尚未在此进行运行时测试，本文未执行任何hermes claw migrate，也未测试 Hermes 的anthropic_messages传输或其模型发现能否针对 Kunavo 端点成功运行。尝试时请保留一条可用路径。按目录价格，Claude Sonnet 4.6列出的价格为每百万输入 token $2.10、每百万输出 token $10.50；Kunavo 的目录金额是计费下限而非上限，因为上游报告费用后，账单取目录成本与上游成本乘以适用加价率两者中的较高者。最低充值金额为预付余额$10——这是资金最低限额，不是任务费用或订阅费用。请参阅计费详情，准备为密钥充值时创建 Kunavo 账户。
第一天结束后进行核对。Hermes 提供hermes insights，其 CLI 参考仅将其描述为“显示 token/成本/活动分析”，且未记录任何标志，因此请读取hermes insights --help，了解你的构建实际接受什么，并将其与提供商账户实际记录的用量进行比较。如果两者不一致，请先检查是否存在重复计划任务，再检查定价错误。有关该方法的背景，请参阅AI 成本优化；有关双方的计划级概览，请参阅Hermes Agent 定价和OpenClaw 定价；如果你尚未决定迁移，请参阅Hermes 与 OpenClaw 对比。
常见问题
如何将 OpenClaw 迁移到 Hermes？
Hermes 提供专用导入器：`hermes claw migrate`。先使用 `--dry-run` 查看计划，然后不带该标志运行——它会打印完整预览，并在写入任何内容前等待确认；除非传入 `--yes` 跳过该提示。它默认读取 `~/.openclaw/`，并自动检测旧版 `~/.clawdbot/` 和 `~/.moltbot/` 目录，以及 `clawdbot.json` / `moltbot.json` 配置文件名。如果想放置 AGENTS.md，请添加 `--workspace-target <path>`；如果想复制 API 密钥，请添加 `--migrate-secrets`。之后启动新会话，运行 `hermes status`，然后才能运行 `hermes claw cleanup`。不要将其与 `hermes migrate` 混淆；后者是不相关的命令，用于重写 config.yaml 以替换已退役的模型。
hermes claw migrate 会导入我的 API 密钥吗？
只有在你主动要求时，并且只从固定的允许列表导入。Hermes 的迁移指南说明，即使使用 `--preset full`，也必须传入 `--migrate-secrets`，因为没有任何预设会静默导入密钥。支持的密钥目标包括 OPENROUTER_API_KEY、OPENAI_API_KEY、ANTHROPIC_API_KEY、DEEPSEEK_API_KEY、GEMINI_API_KEY、ZAI_API_KEY、MINIMAX_API_KEY、ELEVENLABS_API_KEY、TELEGRAM_BOT_TOKEN 和 VOICE_TOOLS_OPENAI_KEY；指南称，列表之外的密钥绝不会被复制。任何其他端点的密钥——例如你自行配置的网关——都需要手动重新输入。带有 `source: "file"` 或 `source: "exec"` 的 SecretRef 值也无法自动解析；迁移会发出警告，你需要使用 `hermes config set` 添加它们。
我的 OpenClaw cron 任务会迁移到 Hermes 吗？
不会。Hermes 的迁移指南将 cron 任务列为“已归档（没有直接的 Hermes 等价项）”：它们会写入 `~/.hermes/migration/openclaw/<timestamp>/archive/` 内的 `archive/cron-config.json`，文档建议使用 `hermes cron create` 重新创建。这是整个迁移过程中代价最高的细节，因为同一台机器上的 OpenClaw 网关仍然安装着，并且仍会触发自己的计划。在 Hermes 中重新创建之前，而不是之后，先使用 `openclaw cron disable <job-id>` 禁用 OpenClaw 侧的任务（OpenClaw 的参考文档称该命令注册为 `openclaw cron`，并提供 `openclaw automations` 作为可用于每个子命令的别名）。
我可以回滚 Hermes 迁移吗？
部分可以，因此应为这一缺口做好计划。默认情况下，迁移会在应用任何更改前，将一个还原点归档写入 `~/.hermes/backups/pre-migration-*.zip`；Hermes CLI 参考文档将 `hermes import` 记录为还原备份 zip 的命令——请先停止网关，因为归档中的每个文件都会覆盖磁盘上的对应文件。但这并不能让 `--migrate-secrets` 实现干净的逆转：它会将 API 密钥写入 `~/.hermes/.env`，而还原快照并不等于证明某个密钥从未泄露到第二个位置。请轮换任何已迁移的密钥，不要假定它已被干净地还原。将快照还原到部分迁移过的主目录并未针对本页面进行测试。
我可以从 Hermes 迁移回 OpenClaw 吗？
可以，而且这是有完整文档说明的迁移，而不是记忆文件复制。OpenClaw 文档说明，应先运行 `openclaw migrate hermes --dry-run`，再运行 `openclaw migrate apply hermes --yes`，导入默认模型选择、已配置的提供商和自定义端点、MCP 服务器、SOUL.md 和 AGENTS.md、记忆文件（追加而非替换）、记忆配置、带有每项技能配置的技能，以及在获得同意后导入认证凭据。有两项限制：导入要求全新的 OpenClaw 设置，或在审查计划后使用 `--overwrite`；OpenClaw 自己的文档还警告，不要让 Hermes 和 OpenClaw 共用同一个刷新授权——在同时运行两者前，应先重新认证其中一方。旧版比较页面所描述的仅记忆行为，现在是 OpenClaw 文档对其引导流程和控制界面记忆导入的描述：它们会将 MEMORY.md 和 USER.md 复制到 `memory/imports/hermes/` 下，并保留现有工作区记忆不变。核对日期：2026 年 9 月 19 日。
迁移到 Hermes 后，我需要 Nous Portal 订阅吗？
模型方面不需要。Hermes Agent 是采用 MIT 许可证的软件，其提供商文档称它支持任何兼容 OpenAI 的 API 端点，因此在你自己的端点上使用自己的密钥是正式支持的路径。例外是 Nous Tool Gateway——网页搜索、图像生成、语音合成和云端浏览器自动化——Hermes 文档将其描述为付费 Nous Portal 订阅者功能。其措辞是同一订阅会解锁 Tool Gateway，因此该门槛取决于订阅，而不是你配置的模型提供商；任何第三方端点都无法替代它。Hermes 文档没有给出订阅价格——它指向 portal.nousresearch.com——因此，任何你在其他地方看到的套餐数字，都应在据此预算前与 Portal 自己的套餐页面核对。
已于 2026 年 9 月 19 日核对 Hermes Agent 和 OpenClaw 的文档、CLI 参考及仓库元数据，所依据版本为 Hermes v0.21.3 (v2026.9.14) 和 OpenClaw v2026.9.5；并于 2026 年 9 月 21 日再次核对仓库元数据。本页中的每条命令、标志和路径均摘自这些官方来源；未执行迁移，也未将 Kunavo 密钥指向任一 agent，因此本文不是兼容性测试。Kunavo token 费率来自实时目录，所有美元数字均为示例性的 token 计算，而非实测成本。