Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw 通过内置的 Claude 迁移提供商导入本地 Claude 状态。该提供商会在更改状态前预览每一项，在计划和报告中遮盖密钥，并在应用前创建经过验证的备份。
新手引导导入需要全新的 OpenClaw 设置。如果你已经有本地 OpenClaw 状态，请先重置配置、凭证、会话和工作区，或者在查看计划后直接使用带 --overwrite 的 openclaw migrate。

​
两种导入方式

当向导检测到本地 Claude 状态时，会提供 Claude 选项。
openclaw onboard --flow import
或者指向特定来源：
openclaw onboard --import-from claude --import-source ~/.claude

​
会导入什么

  • 项目 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 导入。
  • 带有 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 主目录。

​
推荐流程

1

预览计划

openclaw migrate claude --dry-run
计划会列出所有将要更改的内容，包括冲突、跳过的项目，以及从嵌套 MCP env 或 headers 字段中遮盖的敏感值。
2

带备份应用

openclaw migrate apply claude --yes
OpenClaw 会在应用前创建并验证备份。
3

运行 Doctor

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

重启并验证

openclaw gateway restart
openclaw status
确认 Gateway 网关健康，并且你导入的说明、MCP 服务器和 Skills 已加载。

​
冲突处理

当计划报告冲突时（目标位置已存在文件或配置值），应用会拒绝继续。
只有在有意替换现有目标时，才使用 --overwrite 重新运行。提供商仍可能在迁移报告目录中为被覆盖的文件写入项目级备份。
对于全新的 OpenClaw 安装，冲突并不常见。通常是在你对已有用户编辑的设置重新运行导入时出现。

​
用于自动化的 JSON 输出

openclaw migrate claude --dry-run --json
openclaw migrate apply claude --json --yes
使用 --json 且不使用 --yes 时，apply 会打印计划且不会改变状态。这是 CI 和共享脚本最安全的模式。

​
故障排除

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

​
相关