Skip to main content
OpenClaw imports local Claude state through the bundled Claude migration provider. The provider previews every item before changing state and redacts secrets in plans and reports. Standalone openclaw migrate creates a verified backup; the fresh onboarding path stages the import and publishes it only after verification succeeds.
入职导入需要全新的 OpenClaw 设置。如果你已经有本地 OpenClaw 状态，请先重置 config、credentials、sessions 和 workspace，或者在查看计划后直接使用带有 --overwrite 的 openclaw migrate。

​
两种导入方式

当向导检测到本地 Claude 状态时，会提供 Claude 选项。
或者指定特定来源：

​
会导入哪些内容

  • 项目 CLAUDE.md 和 .claude/CLAUDE.md 的内容会被复制或追加到 OpenClaw agent workspace 的 AGENTS.md 中。
  • 用户 ~/.claude/CLAUDE.md 的内容会追加到 workspace 的 USER.md 中。
当存在时，会从项目 .mcp.json、Claude Code ~/.claude.json 和 Claude Desktop claude_desktop_config.json 中导入 MCP 服务器定义。
  • 带有 SKILL.md 文件的 Claude skills 会被复制到 OpenClaw workspace 的 skills 目录中。
  • .claude/commands/ 或 ~/.claude/commands/ 下的 Claude 命令 Markdown 文件会被转换为 OpenClaw skills，并设置 disable-model-invocation: true。

​
仅归档的内容

提供程序会将这些内容复制到迁移报告中供人工审查，但不会将它们加载到实时 OpenClaw config 中：
  • Claude hooks
  • Claude permissions 和宽泛的工具 allowlists
  • Claude environment defaults
  • CLAUDE.local.md
  • .claude/rules/
  • .claude/agents/ 或 ~/.claude/agents/ 下的 Claude subagents
  • Claude Code caches、plans 和 project history directories
  • Claude Desktop extensions 和 OS 存储的 credentials
OpenClaw 拒绝自动执行 hooks、信任 permission allowlists，或解码不透明的 OAuth 和 Desktop credential state。请在审查归档后，手动迁移你需要的内容。

​
来源选择

如果没有 --from，OpenClaw 会检查默认的 Claude Code home：~/.claude、采样到的 Claude Code ~/.claude.json 状态文件，以及 macOS 上的 Claude Desktop MCP config。 当 --from 指向项目根目录时，OpenClaw 只导入该项目的 Claude 文件，例如 CLAUDE.md、.claude/settings.json、.claude/commands/、.claude/skills/ 和 .mcp.json。在项目根目录导入期间，它不会读取你的全局 Claude home。

​
推荐流程

1

预览计划

计划会列出所有将要变更的内容，包括冲突、跳过的项目，以及从嵌套 MCP env 或 headers 字段中脱敏后的敏感值。
2

应用并备份

OpenClaw 会在应用前创建并验证备份。
3

运行 doctor

Doctor 会在导入后检查 config 或 state 问题。
4

重启并验证

确认 gateway 运行正常，并且你导入的指令、MCP 服务器和技能都已加载。

​
冲突处理

当计划报告冲突时，apply 会拒绝继续（即某个文件或 config 值已存在于目标位置）。
仅当明确要替换现有目标时，才重新运行并使用 --overwrite。提供程序仍可能会在 migration report 目录中为被覆盖的文件写入逐项备份。
对于全新的 OpenClaw 安装，冲突并不常见。它们通常出现在你在已经有用户编辑的设置上重新运行导入时。

​
用于自动化的 JSON 输出

--yes 是 migrate apply 在非交互式终端中所必需的；如果没有它，OpenClaw 不会执行应用，而是报错，因此脚本和 CI 必须显式传入 --yes。先使用 --dry-run --json 进行预览，然后在计划看起来正确时，再使用 --json --yes 进行应用。

​
故障排除

传入 --from /actual/path（CLI）或 --import-source /actual/path（onboarding）。
入职导入需要全新设置。你可以重置状态后重新进行 onboarding，或者直接使用 openclaw migrate apply claude，它支持 --overwrite 和显式的备份控制。
Claude Desktop 会从平台相关路径读取 claude_desktop_config.json。如果 OpenClaw 没有自动检测到，请将 --from 指向该文件所在目录。
这是设计如此。Claude 命令由用户触发，因此 OpenClaw 会将它们作为带有 disable-model-invocation: true 的 skills 导入。如果你希望 agent 自动调用它们，请编辑每个 skill 的 frontmatter。

​
相关内容