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

Maintenance

從 Claude 遷移

OpenClaw 透過內建的 Claude 遷移提供者匯入本機 Claude 狀態。提供者會在變更狀態前預覽每個項目、在計畫與報告中遮蔽機密資訊，並在套用前建立經過驗證的備份。

兩種匯入方式

新手引導精靈

精靈偵測到本機 Claude 狀態時，會提供 Claude 選項。

bash
openclaw onboard --flow import

或指定特定來源：

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

命令列介面

使用 openclaw migrate 執行指令碼化或可重複的作業。如需完整參考，請參閱 openclaw migrate。

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

加上 --from <path>，即可匯入特定的 Claude Code 主目錄或專案根目錄。

匯入的內容

指示與記憶
  • 專案 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 匯入 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 的預設 Claude Code 主目錄、取樣的 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 會在套用前建立並驗證備份。

  • 執行診斷

    bash
    openclaw doctor

    診斷會在匯入後檢查設定或狀態問題。

  • 重新啟動並驗證

    bash
    openclaw gateway restartopenclaw status

    確認閘道運作正常，且匯入的指示、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（命令列介面）或 --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。如果希望代理程式自動叫用這些 Skills，請編輯各 Skill 的 frontmatter。

    相關內容

    Was this useful?
    On this page

    On this page