快速开始
从 Claude 迁移
OpenClaw 通过内置的 Claude 迁移提供商导入本地 Claude 状态。该提供商会在更改状态前预览每一项，在计划和报告中遮盖密钥，并在应用前创建经过验证的备份。
两种导入方式
新手引导向导
当向导检测到本地 Claude 状态时，会提供 Claude 选项。
openclaw onboard --flow import
或者指向特定来源：
openclaw onboard --import-from claude --import-source ~/.claude
CLI
对于脚本化或可重复运行，使用 openclaw migrate。完整参考请参阅 openclaw migrate。
openclaw migrate claude --dry-run
openclaw migrate apply claude --yes
添加 --from <path> 可导入特定的 Claude Code 主目录或项目根目录。
会导入什么
说明和记忆
- 项目
CLAUDE.md和.claude/CLAUDE.md内容会被复制或追加到 OpenClaw Agent 工作区AGENTS.md。 - 用户
~/.claude/CLAUDE.md内容会被追加到工作区USER.md。
MCP 服务器
如果存在，MCP 服务器定义会从项目 .mcp.json、Claude Code ~/.claude.json 和 Claude Desktop claude_desktop_config.json 导入。
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 主目录。
推荐流程
预览计划
openclaw migrate claude --dry-run
计划会列出所有将要更改的内容，包括冲突、跳过的项目，以及从嵌套 MCP env 或 headers 字段中遮盖的敏感值。
带备份应用
openclaw migrate apply claude --yes
OpenClaw 会在应用前创建并验证备份。
运行 Doctor
openclaw doctor
Doctor 会在导入后检查配置或状态问题。
重启并验证
openclaw gateway restart
openclaw status
确认 Gateway 网关健康，并且你导入的说明、MCP 服务器和 Skills 已加载。
冲突处理
当计划报告冲突时（目标位置已存在文件或配置值），应用会拒绝继续。
对于全新的 OpenClaw 安装，冲突并不常见。通常是在你对已有用户编辑的设置重新运行导入时出现。
用于自动化的 JSON 输出
openclaw migrate claude --dry-run --json
openclaw migrate apply claude --json --yes
使用 --json 且不使用 --yes 时，apply 会打印计划且不会改变状态。这是 CI 和共享脚本最安全的模式。
故障排除
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。
相关
openclaw migrate：完整 CLI 参考、插件契约和 JSON 形状。- 迁移指南：所有迁移路径。
- 从 Hermes 迁移：另一条跨系统导入路径。
- 新手引导：向导流程和非交互式标志。
- Doctor：迁移后的健康检查。
- Agent 工作区：
AGENTS.md、USER.md和 Skills 所在的位置。