CLI migrate 命令

openclaw migrate 通过插件提供的迁移 provider，从其他 agent 系统导入状态。内置支持 Claude、Codex CLI、Hermes；第三方插件可注册额外 provider。

常用命令

openclaw migrate list                          # 列出已安装的迁移 providers
openclaw migrate claude --dry-run              # 预览 Claude 迁移计划
openclaw migrate hermes --dry-run              # 预览 Hermes 迁移计划
openclaw migrate codex --dry-run               # 预览 Codex 迁移计划
openclaw migrate apply hermes --yes            # 执行 Hermes 迁移
openclaw migrate apply hermes --include-secrets --yes  # 含凭据迁移
openclaw migrate apply claude --yes
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace

安全模型

预览优先：apply 前展示完整 plan，含冲突、跳过项、敏感项（secret 值已脱敏）
自动备份：apply 前创建并验证备份；无本地状态时跳过；--no-backup --force 可强制跳过
冲突处理：有冲突时拒绝继续，需加 --overwrite 确认覆盖
Secrets 默认不导入：需显式传 --include-secrets

Claude provider

检测 ~/.claude 下的 Claude Code 状态，--from <path> 可指定其他路径。

导入内容：

CLAUDE.md、.claude/CLAUDE.md → OpenClaw agent workspace
~/.claude/CLAUDE.md → workspace USER.md
MCP server 定义（.mcp.json、~/.claude.json、claude_desktop_config.json）
包含 SKILL.md 的 skill 目录
Claude command Markdown 文件 → OpenClaw skills（仅手动调用）

Hermes provider

检测 ~/.hermes，--from <path> 可指定其他路径。

导入内容：模型配置、provider 配置、MCP servers、SOUL.md/AGENTS.md、memory 文件、skills。

支持的 .env key：OPENAI_API_KEY、ANTHROPIC_API_KEY、OPENROUTER_API_KEY、GOOGLE_API_KEY 等。

Codex provider

检测 ~/.codex（或 $CODEX_HOME），导入 skills 和 source-installed curated 插件。

openclaw migrate codex --dry-run --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes --plugin google-calendar
openclaw migrate codex --verify-plugin-apps --dry-run  # 强制验证插件可访问性

插件合约

迁移 provider 由插件实现，在 openclaw.plugin.json 中声明：

{ "contracts": { "migrationProviders": ["hermes"] } }

Provider 实现 detect、plan、apply 三个方法；core 负责 CLI 编排、备份策略、冲突 preflight。

Wiki AI

目录