OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

快速开始

从 Claude 迁移

OpenClaw 通过内置的 Claude 迁移提供商导入本地 Claude 状态。该提供商会在更改状态前预览每个项目，在计划和报告中隐去密钥，并在应用前创建并验证备份。

两种导入方式

新手引导向导

向导检测到本地 Claude 状态时，会提供 Claude 选项。

bash
openclaw onboard --flow import

或者指定特定来源：

bash
openclaw onboard --import-from claude --import-source ~/.claude

CLI

使用 openclaw migrate 进行脚本化或可重复执行的迁移。完整参考请参阅 openclaw migrate。

bash
openclaw migrate claude --dry-runopenclaw migrate apply claude --yes

添加 --from <path> 可导入特定的 Claude Code 主目录或项目根目录。

导入的内容

指令和记忆
  • 项目中的 CLAUDE.md 和 .claude/CLAUDE.md 内容会复制或追加到 OpenClaw Agent 工作区的 AGENTS.md。
  • 用户的 ~/.claude/CLAUDE.md 内容会追加到工作区的 USER.md。
MCP 服务器

如果存在，系统会从项目的 .mcp.json、Claude Code 的 ~/.claude.json 和 Claude Desktop 的 claude_desktop_config.json 导入 MCP 服务器定义。

Skills 和命令
  • 包含 SKILL.md 文件的 Claude Skills 会复制到 OpenClaw 工作区的 Skills 目录。
  • .claude/commands/ 或 ~/.claude/commands/ 下的 Claude 命令 Markdown 文件会转换为带有 disable-model-invocation: true 的 OpenClaw Skills。

仅归档的内容

提供商会将以下内容复制到迁移报告中供手动审查，但不会将其加载到实时 OpenClaw 配置中：

  • Claude 钩子
  • Claude 权限和宽泛的工具允许列表
  • Claude 环境默认值
  • CLAUDE.local.md
  • .claude/rules/
  • .claude/agents/ 或 ~/.claude/agents/ 下的 Claude 子智能体
  • Claude Code 缓存、计划和项目历史目录
  • Claude Desktop 扩展和操作系统存储的凭据

OpenClaw 拒绝自动执行钩子、信任权限允许列表，或解码不透明的 OAuth 和 Desktop 凭据状态。审查归档后，请手动迁移所需内容。

来源选择

未指定 --from 时，OpenClaw 会检查默认的 Claude Code 主目录 ~/.claude、抽样的 Claude Code ~/.claude.json 状态文件，以及 macOS 上的 Claude Desktop MCP 配置。

当 --from 指向项目根目录时，OpenClaw 只会导入该项目的 Claude 文件，例如 CLAUDE.md、.claude/settings.json、.claude/commands/、.claude/skills/ 和 .mcp.json。在从项目根目录导入时，它不会读取你的全局 Claude 主目录。

推荐流程

  • 预览计划

    bash
    openclaw migrate claude --dry-run

    计划会列出所有将发生的更改，包括冲突、跳过的项目，以及从嵌套 MCP env 或 headers 字段中隐去的敏感值。

  • 应用并备份

    bash
    openclaw migrate apply claude --yes

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

  • 运行 Doctor

    bash
    openclaw doctor

    Doctor 会在导入后检查配置或状态问题。

  • 重启并验证

    bash
    openclaw gateway restartopenclaw status

    确认 Gateway 网关运行正常，并且已加载导入的指令、MCP 服务器和 Skills。

    • 冲突处理

    当计划报告冲突（目标位置已存在文件或配置值）时，应用操作会拒绝继续执行。

    对于全新安装的 OpenClaw，冲突并不常见。冲突通常出现在已有用户编辑内容的设置中重新运行导入时。

    用于自动化的 JSON 输出

    bash
    openclaw migrate claude --dry-run --jsonopenclaw migrate apply claude --json --yes

    在交互式终端之外执行 migrate apply 时必须使用 --yes；如果未指定，OpenClaw 会报错而不是应用更改，因此脚本和 CI 必须显式传入 --yes。请先使用 --dry-run --json 预览，确认计划正确后，再使用 --json --yes 应用。

    故障排查

    Claude 状态位于 ~/.claude 之外

    传入 --from /actual/path（CLI）或 --import-source /actual/path（新手引导）。

    新手引导拒绝导入到现有设置

    新手引导导入要求全新的设置。你可以重置状态并重新进行新手引导，也可以直接使用 openclaw migrate apply claude；后者支持 --overwrite 和显式备份控制。

    未导入 Claude Desktop 中的 MCP 服务器

    Claude Desktop 从特定于平台的路径读取 claude_desktop_config.json。如果 OpenClaw 未自动检测到该文件，请将 --from 指向该文件所在的目录。

    Claude 命令转换为禁用模型调用的 Skills

    这是有意设计的行为。Claude 命令由用户触发，因此 OpenClaw 会将其导入为带有 disable-model-invocation: true 的 Skills。如果你希望智能体自动调用它们，请编辑每个 Skill 的 frontmatter。

    相关内容

    Was this useful?
    On this page

    On this page