本页内容
本页内容
维护
从 Hermes 迁移
捆绑的 Hermes 迁移提供程序遵循 HERMES_HOME 和活动 Hermes 配置文件,回退到 macOS/Linux 上的 ~/.hermes 或 Windows 上的 %LOCALAPPDATA%\hermes。它会在应用之前预览每项更改,并编辑计划和报告中的秘密。独立openclaw migrate写入经过验证的备份;新的入门路径会暂存配置、凭据和文件,并仅在导入的推理验证后才发布它们。显式的 --from 路径总是获胜。
两种导入方式
设置向导
检测活动的 Hermes home/profile,并在应用前显示预览。
或者指定特定来源:
CLI
使用 openclaw migrate 进行脚本化或可重复运行。完整参考请参见 openclaw migrate。
添加 --from <path> 以覆盖 Hermes home/profile 的自动发现。
导入什么
模型配置
- 默认模型选择Hermes
config.yaml。带有--agent <id>的,进口模型属于该智能体;共享默认值,其他代理保留其模型。 - 来自
model、providers和custom_providers的配置模型提供程序和自定义端点,包括 Hermes 传输别名、camelCase 提供程序字段以及带有每个模型元数据的模型列表。
MCP 服务器
来自 mcp_servers 或 mcp.servers 的 MCP 服务器定义,包括禁用状态、超时、并行工具支持、OAuth 范围、兼容的 TLS 字段和 native/resource/prompt 工具策略。文字环境变量和标头需要凭证导入同意。仅 Hermes 的生命周期、采样、诱导、预检、保活、CA-bundle、受密码保护的客户端密钥和预注册的 OAuth- 客户端设置将成为手动审核项,而不是无效的 OpenClaw 配置。
空的 tools.include 会禁用本机工具,同时保留资源和提示实用程序设置。 OpenClaw工具过滤器支持精确名称和*; Hermes ? 和支架图案需要人工审核。不支持的包含模式将被忽略,并且具有不支持的排除模式的服务器将被导入禁用,直到您替换其过滤器并启用它。
工作区文件
SOUL.md和AGENTS.md被复制到 OpenClaw 代理工作区中。memories/MEMORY.md和memories/USER.md将 append 到匹配的 OpenClaw 内存文件中,而不是覆盖它们。- 仅内存表面的行为不同:载入内存页面和 Control UI 内存导入页面将这两个文件复制到
memory/imports/hermes/下以进行索引调用,并保持现有工作区内存不变。
内存配置
OpenClaw 文件记忆的默认记忆配置。像 Honcho 这样的外部记忆提供器会被记录为归档或需人工审查的项目,以便你有意地迁移它们。
技能
递归地发现 skills/ 中活动目录下的 SKILL.md 文件的技能,将其平铺到 OpenClaw 工作区技能目录中,并与其支持文件一起复制。保留 skills.config 中的每个技能配置值和 skills.disabled 中的全局禁用状态。对于 --skill,仅导入所选技能的配置和禁用状态。仅导入 _org/.active_org 选择的组织镜像。
身份验证凭据
交互式 openclaw migrate 会在导入 auth credentials 前询问,默认选中“是”。接受的导入包括当前 Hermes OpenAI Codex OAuth 条目、OpenCode OpenAI OAuth 和 GitHub Copilot 条目,以及支持的 Hermes .env 键。非交互式导入请使用 --include-secrets,跳过凭据请使用 --no-auth-credentials,或使用 onboarding 的 --import-secrets 标志。导入 Hermes OAuth 后,不要让 Hermes 和 OpenClaw 继续使用同一个 refresh grant;在同时运行两者之前,请先让其中一侧重新认证。
仅存档的内容
提供程序将这些内容复制到迁移报告目录中以供手动审核,但 not 是否将它们加载到实时 OpenClaw 配置或凭据中:
plugins/sessions/logs/cron/mcp-tokens/plans/、workspace/、skins/和kanban/pairing/和platforms/商店,加上网关 routing/process 状态state.db、hermes_state.db、projects.db、response_store.db、memory_store.db、verification_evidence.db、kanban.db和retaindb_queue.db
OpenClaw 会拒绝自动执行或信任这些状态,因为不同系统之间的格式和信任假设可能会发生变化。请在查看归档后手动移动你需要的内容。
推荐流程
预览计划
该计划会列出所有将要更改的内容,包括冲突、被跳过的项目以及敏感项目。输出中嵌套的类似密钥的键会被隐藏。
申请并备份
OpenClaw 会在应用前创建并验证备份。这个非交互式示例只导入非机密状态。可在不使用 --yes 的情况下运行,以便交互式回答凭据提示;或者添加 --include-secrets,在无人值守运行中包含受支持的凭据。
跑医生
Doctor 会重新应用任何待处理的配置迁移,并检查导入过程中引入的问题。
重启并验证
确认 gateway 运行正常,并且你导入的模型、记忆和技能已加载。
冲突处理
当计划报告冲突时(目标中已存在文件或配置值),Apply 拒绝继续。
在全新安装中,冲突并不常见。它们通常出现在你针对一个已经有用户修改的设置重新运行导入时。
如果在应用过程中出现冲突(例如,配置文件上出现意外竞争),则该项目将报告为冲突,而独立文件、技能、凭据、存档和配置条目将继续。解决冲突的项目并重新运行导入;重复相同的内存导入不会创建重复项。
密钥
交互式 openclaw migrate 会询问是否导入检测到的认证凭据,默认选择“是”。
- 接受导入当前的 Hermes OpenAI Codex OAuth 条目、OpenCode OpenAI OAuth 和 GitHub Copilot 条目,以及 受支持的
.env键。 - 使用
--no-auth-credentials,或在提示时回答 no,只导入非秘密状态。 - 使用
--include-secrets可在无人值守的--yes运行中导入凭据。 - 使用 onboarding wizard 的
--import-secrets标志从 wizard 导入凭据。
用于自动化的 JSON 输出
openclaw migrate hermes --json 不带 --yes 打印计划而不应用它。非交互式 migrate apply 需要 --yes。部分应用失败会返回完整的 JSON 报告并退出,代码为 1。
故障排查
申请因冲突而被拒绝
检查计划输出。每个冲突都会标识源路径和现有目标。根据每个项目决定是跳过、编辑目标,还是使用 --overwrite 重新运行。
Hermes 住在 ~/.hermes 外面
通过 --from /actual/path (CLI) 或 --import-source /actual/path(入门引导)。
入门引导拒绝导入现有设置
入门导入需要全新的设置。你可以选择重置状态后重新引导,或者直接使用 openclaw migrate apply hermes,它支持 --overwrite 和显式备份控制。
API 密钥未导入
交互式 openclaw migrate 只有在你接受凭据提示时才会导入 API 密钥。非交互式 --yes 运行需要 --include-secrets;入门导入需要 --import-secrets。仅会识别受支持的 .env 键——其他 .env 变量会被忽略。
相关内容
openclaw migrate:完整的 CLI 参考、插件合约和 JSON 形状。- Onboarding:向导流程和非交互式标志。
- 迁移:在机器之间迁移 OpenClaw 安装。
- Doctor:迁移后的健康检查。
- Agent 工作区:
SOUL.md、AGENTS.md和 memory 文件所在的位置。