Wiki AI

从 Claude 迁移

3分钟阅读

通过内置 Claude 迁移 provider 将 Claude Code 和 Claude Desktop 的本地状态导入 OpenClaw。迁移前预览所有变更，敏感信息脱敏，apply 前自动创建并验证备份。

注意：onboarding 导入要求全新 OpenClaw 安装。若已有本地状态，先重置或直接使用 openclaw migrate 加 --overwrite。

两种导入方式

方式 A：Onboarding 向导

# 检测到 Claude 状态时自动提示
openclaw onboard --flow import
 
# 指定来源路径
openclaw onboard --import-from claude --import-source ~/.claude

方式 B：CLI（可脚本化）

# 预览
openclaw migrate claude --dry-run
 
# 应用
openclaw migrate apply claude --yes

加 --from <path> 可指定特定 Claude Code home 或项目根目录。

导入内容

指令和 memory

  • 项目 CLAUDE.md 和 .claude/CLAUDE.md → 追加到 OpenClaw workspace AGENTS.md
  • 用户 ~/.claude/CLAUDE.md → 追加到 workspace USER.md

MCP servers

  • 从项目 .mcp.json、Claude Code ~/.claude.json、Claude Desktop claude_desktop_config.json 导入

Skills 和命令

  • 含 SKILL.md 的 Claude skills → 复制到 OpenClaw workspace skills 目录
  • .claude/commands/ 或 ~/.claude/commands/ 下的命令 Markdown → 转换为 disable-model-invocation: true 的 OpenClaw skills

仅归档（不自动导入）

以下内容复制到迁移报告供手动审查，不加载到 OpenClaw 配置：

  • Claude hooks
  • Claude 权限和工具白名单
  • Claude 环境默认值
  • CLAUDE.local.md、.claude/rules/
  • .claude/agents/ 或 ~/.claude/agents/ 下的子 agent
  • Claude Code 缓存、计划、项目历史目录
  • Claude Desktop 扩展和 OS 存储的凭证

推荐流程

# 1. 预览计划
openclaw migrate claude --dry-run
 
# 2. 应用（自动创建备份）
openclaw migrate apply claude --yes
 
# 3. 运行 doctor
openclaw doctor
 
# 4. 重启并验证
openclaw gateway restart
openclaw status

冲突处理

apply 遇到冲突（目标已存在文件或配置值）时拒绝继续。全新安装通常无冲突，重复导入时才会出现。

# 确认覆盖时才使用
openclaw migrate apply claude --yes --overwrite

CI/自动化

# JSON 输出，不修改状态（最安全）
openclaw migrate claude --dry-run --json
 
# JSON 输出并应用
openclaw migrate apply claude --json --yes

常见问题

  • Claude 状态不在 ~/.claude：加 --from /actual/path
  • onboarding 拒绝在已有安装上导入：直接用 openclaw migrate apply claude --overwrite
  • Claude Desktop MCP servers 未导入：加 --from 指向 claude_desktop_config.json 所在目录
  • Claude 命令变成了禁用模型调用的 skill：设计如此，编辑 skill frontmatter 中的 disable-model-invocation 可改变行为

相关链接

关系图谱

反向链接