OpenClaw 2.0 怎么安装：Hermes 记忆迁移与检查步骤

OpenClaw 2.0 重建图：安装、Control UI、记忆迁移与安全

先说结论

已经在用 Hermes 的人，更关心的不是 OpenClaw 有没有“回归”，而是试用新界面时，原来的记忆能否带过来，会不会顺手把密钥和定时任务也搬过去。OpenClaw 2.0 提供了导入入口，但只导入记忆与完整迁移是两回事。

只需要已有偏好和事实，就选记忆导入，不必搬整套配置。
完整迁移先预览；旧会话和定时任务不会自动变成可运行状态。
检查目标文件，再开新对话验证召回，不能只看“导入成功”。
验收前保留 Hermes 原始数据与备份，不急着删旧环境。

安装体验记录于首次发布时。下列命令和迁移范围于 9 月 8 日重新核对官方文档，本次更新没有再次在全新设备上实测安装。

1. 先装好 OpenClaw，确认能正常聊天

当前入门文档要求 Node.js 24.16+ 或 26.1+，推荐 Node 26。准备已有且受支持的 Claude Code、Codex 登录，或模型供应商 API Key。订阅存在不代表所有调用方式都能复用，仍要让向导实际验证。

先查运行环境：

node --version

macOS / Linux 官方安装命令：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell：

iwr -useb https://openclaw.ai/install.ps1 | iex

这两条会下载并执行代码、修改本机安装，运行前先查看官方脚本，工作电脑尤其如此。按平台选择一条，不要两条都执行。当前安装器跟随当前版本，不会锁定最初的 2.0 包；发布说明中的 2.0 对应 v2026.8.1。

当前向导提供 Quick start，复用检测到的可用账号；Custom setup 用于更多配置。找不到能实际返回结果的模型时，改走手动设置。经典分步向导仍可用：

openclaw onboard --classic

先别导入记忆，让普通聊天成功一次。如果 Quick start 把 Gateway（负责连接界面、模型和工具的服务）运行在当前终端，保持窗口打开。要改成后台服务，先 Ctrl+C，再执行：

openclaw gateway install
openclaw gateway status
openclaw dashboard

安装后台服务会修改启动配置。预期是 Gateway 正在运行，通常监听 18789 端口；网页能打开，还要能收到模型回复。只有页面加载成功、模型却登录失败，不算装好。认证按界面提示处理，不要把网关密码或令牌截进公开图片。

OpenClaw 2.0 官方发布文章

图：8 月 30 日官方公告介绍安装和浏览器界面的重建；当前命令细节以链接中的入门文档为准。

2. Hermes 记忆导入，不等于整套迁移

Hermes 迁移文档把范围分得很清楚：

路径	带过来的内容	不能据此认定什么
安装向导的记忆页、Control UI 的 Memory 导入	将 Hermes 的 `memories/MEMORY.md` 与 `memories/USER.md` 复制到 `memory/imports/hermes/`，用于检索	不代表全部配置、技能、密钥和会话已迁移
完整 Hermes 迁移	受支持的模型配置、MCP 服务、工作区文件、记忆和技能；凭据需要同意	并非所有 Hermes 专用选项都兼容
完整迁移中的仅归档项目	会话、日志、cron、数据库等保留供人工检查	不会成为已激活的 OpenClaw 聊天、定时任务或数据库

MCP 是 Agent 连接外部工具的协议。服务配置搬过来了，不等于登录、工具筛选规则和供应商特有选项都能正常工作。

只搬记忆时，在 Settings 中打开 Memory，选择 Hermes 来源，核对文件与目标 Agent 后再确认。这条路径不改已有工作区记忆；完整迁移则把两个记忆文件追加到对应的 OpenClaw 文件中。不要用其中一条路径的目标位置，去验收另一条路径。

早期安装时，向导导入记忆很方便。但这不代表全部旧对话都能搜索、所有技能都能运行。

3. 完整迁移先预览，不默认覆盖

如果记忆之外还需要配置和技能，先运行：

openclaw migrate hermes --dry-run

这一步只生成计划，不改状态。程序会识别 HERMES_HOME 与当前 Hermes profile，再使用平台默认位置。核对来源路径、目标 Agent、冲突、跳过项和敏感项。识别错了就按文档用 --from 指定实际来源，不要往错误目录反复导入。

第一次迁移建议不带凭据，并保留终端里的确认过程：

openclaw migrate apply hermes --no-auth-credentials

批准计划后才会写入。已有 OpenClaw 状态时，独立 CLI 会创建并验证迁移前备份；但它不能代替 Hermes 源数据的单独备份。备份、归档可能含私人数据，即使屏幕报告隐藏了密钥，也不能公开上传。

首次安装还支持 openclaw onboard --flow import，先暂存并验证新配置，再启用。它要求全新状态。已经完成安装的人，不要为了看到这个页面重置现有环境，改用独立迁移预览或仅记忆导入。

有冲突就停下来比较源文件与目标文件，不要习惯性加 --overwrite，它明确允许替换现有内容。若应用中途出现新冲突，其他独立项目仍可能已导入；需要逐项看报告，不能只看最后一行成败。

4. 导入后怎么确认真的可用

完整迁移后，官方建议依次检查：

openclaw doctor
openclaw gateway restart
openclaw status

Doctor 可能应用尚未完成的配置迁移，restart 会中断服务，先保存正在做的事。不要为消除警告随手追加修复、重置或覆盖参数。

随后分项验收：

查文件。 打开目标记忆文件，与来源中的几条已知内容对比。仅记忆导入应查 memory/imports/hermes/，不要期待主工作区文件被替换。
查召回。 在同一个目标 Agent 的新私密对话中，询问原记忆里一条独特、非敏感的事实，不要在问题中给答案。
查归属。 官方召回受同一 Agent、私密对话等条件限制；共享聊天不能替代这个检查。
查完整迁移的附加项。 单独核对模型设置和所选技能。MCP 有不支持项先处理，只试无害的读取任务，再考虑外部写入。
查凭据和任务。 上面的命令刻意跳过凭据，登录未带过来属于预期；归档的 cron 和 sessions 不等于定时任务已开启、聊天已恢复。

例如原记忆里已有“每周计划会在周四 15:00”，新对话问“我的每周计划会是什么时间？”，再核对返回的来源（如有）。这是建议的验收示例，不是本文实测结果。答对也可能是猜测，要结合文件检查与 Memory 页的索引状态一起看。

OpenClaw 2.0 官方发布说明

图：发布说明把 v2026.8.1 标记为 OpenClaw 2.0。具体导入范围与检查条件见链接中的 Memory 和 Hermes 迁移文档。

5. 召回失败时，怎样保留退路

找不到记忆，先依次检查：源 profile 是否选错、目标 Agent 是否选错、索引是否完成、该文件是否在支持范围内。不要直接再次覆盖导入，那可能替换已经编辑好的目标文件，却没修复召回问题。

试用期间保留 Hermes 原始数据、OpenClaw 迁移前备份及逐项报告。决定暂时不用新环境，就回到仍可工作的 Hermes，并停用新启用的 OpenClaw 自动化和消息连接，避免两边执行同一外部任务。OpenClaw 备份恢复是另一项操作，按官方备份恢复说明处理，不要猜目录直接覆盖。

如果之后明确选择导入 OAuth 登录凭据，官方还特别提醒：两个工具不要共用同一 refresh grant（刷新登录状态的授权）。并行使用前，给其中一个重新登录。原文件没删，不等于凭据可以不受影响地两边共用。

重建后的体验：上手更快，检查仍不能省

早期在全新设备安装时，向导发现了已有 Codex 资源，Control UI 变成中间对话、侧边栏会话，Hermes 记忆导入也很方便。不顺手的地方包括较小的新会话按钮，以及当时需输入 /approve 的创建 Agent 流程。这是早期界面的体验，不保证当前每个版本仍完全一样。

8 月 30 日官方博客称，这次更新由 933 位贡献者、超过 1.6 万个 PR 完成，结束了近 7 周的发布间隔。共享会话、内置记忆、更明确的审批和自动化历史，确实让这次更新不只是换皮，但这些都不代表 Hermes 可以整套无差别搬家。

OpenClaw Foundation 官方公告页面

图：基金会公告说明项目的独立治理背景，不是某次 Hermes 导入成功的证据。

首次设置不再堆满选项，但排查网关、审查导入内容和管理凭据，仍需要动手能力。更广的架构差异另见 DeepSeek Harness、OpenClaw 与 Hermes 对比。

结语

迁移成功不是一个绿色提示，而是文件进了正确的 Agent、记忆能被查到、凭据经过主动选择、外部任务没有意外启动。只需要记忆就先搬记忆；这些检查通过前，保留旧 Hermes 环境。

FAQ

Hermes 全部聊天能一键搬过来吗？

仅记忆导入不能，它只复制两个受支持的记忆文件。完整迁移中的会话和数据库属于归档检查范围，不会自动成为等价的 OpenClaw 聊天历史。

为什么 API Key 没有导入？

本文命令刻意使用 --no-auth-credentials。凭据导入需要另行决定，检测到密钥不等于同意复制，还要核对官方支持的键名范围。

安装向导不让我导入，要重置吗？

不要仅为打开这个页面重置工作环境。首次安装导入要求全新状态；已有环境可先预览独立迁移，或只导入记忆，再逐项处理冲突。

试完 OpenClaw，还能继续用 Hermes 吗？

保留源数据并检查旧环境仍能工作。避免两边自动化发送重复消息；如果主动共享过 OAuth 刷新授权，并行使用前给其中一个重新登录。

证据与来源

来源核查：2026 年 9 月 8 日。安装体验记录于首次发布时；本轮未执行新的安装、凭据导入或数据迁移。