跳轉到主要內容
OpenClaw 會透過內建的 Claude 遷移提供者匯入本機 Claude 狀態。提供者會在變更狀態前預覽每個項目，在計畫與報告中遮蔽祕密資訊，並在套用前建立經驗證的備份。
初始設定匯入需要全新的 OpenClaw 設定。如果你已經有本機 OpenClaw 狀態，請先重設設定、憑證、工作階段與工作區，或在檢閱計畫後直接使用 openclaw migrate 搭配 --overwrite。

​
兩種匯入方式

精靈偵測到本機 Claude 狀態時，會提供 Claude 選項。
openclaw onboard --flow import
或指向特定來源：
openclaw onboard --import-from claude --import-source ~/.claude

​
會匯入哪些內容

  • 專案 CLAUDE.md 與 .claude/CLAUDE.md 內容會複製或附加到 OpenClaw 代理工作區的 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 檔案會轉換成 OpenClaw Skills，並設定 disable-model-invocation: true。

​
只保留在封存中的內容

提供者會將這些內容複製到遷移報告中供手動檢閱，但不會將它們載入即時 OpenClaw 設定：
  • Claude hooks
  • Claude 權限與廣泛工具允許清單
  • Claude 環境預設值
  • CLAUDE.local.md
  • .claude/rules/
  • .claude/agents/ 或 ~/.claude/agents/ 底下的 Claude 子代理
  • Claude Code 快取、計畫與專案歷史目錄
  • Claude Desktop 擴充功能與作業系統儲存的憑證
OpenClaw 會拒絕自動執行 hooks、信任權限允許清單，或解碼不透明的 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

執行健康檢查

openclaw doctor
健康檢查會在匯入後檢查設定或狀態問題。
4

重新啟動並驗證

openclaw gateway restart
openclaw status
確認閘道狀態正常，且你匯入的指示、MCP 伺服器與 Skills 已載入。

​
衝突處理

當計畫回報衝突時（目標位置已存在檔案或設定值），套用會拒絕繼續。
只有在刻意取代現有目標時，才使用 --overwrite 重新執行。提供者仍可能在遷移報告目錄中為被覆寫的檔案寫入項目層級備份。
對全新的 OpenClaw 安裝而言，衝突並不常見。通常是在你對已有使用者編輯的設定重新執行匯入時才會出現。

​
自動化用 JSON 輸出

openclaw migrate claude --dry-run --json
openclaw migrate apply claude --json --yes
在互動式終端機外執行 migrate apply 時必須使用 --yes；若未使用，OpenClaw 會報錯而不是套用，因此腳本與 CI 必須明確傳入 --yes。先使用 --dry-run --json 預覽，確認計畫正確後，再使用 --json --yes 套用。

​
疑難排解

傳入 --from /actual/path（命令列介面）或 --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。

​
相關