English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk 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

CLI

使用 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 伺服器定義會從專案 .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 檔案會轉換為 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 主目錄。

建議流程

  • 預覽計畫

    bash
    openclaw migrate claude --dry-run

    計畫會列出所有將變更的項目，包括衝突、略過的項目，以及從巢狀 MCP env 或 headers 欄位中遮蔽的敏感值。

  • 使用備份套用

    bash
    openclaw migrate apply claude --yes

    OpenClaw 會在套用前建立並驗證備份。

  • 執行 doctor

    bash
    openclaw doctor

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

  • 重新啟動並驗證

    bash
    openclaw gateway restartopenclaw status

    確認 Gateway 健康，且你匯入的指示、MCP 伺服器與 Skills 已載入。

    • 衝突處理

    當計畫回報衝突時，套用會拒絕繼續（目標位置已存在檔案或設定值）。

    對全新的 OpenClaw 安裝而言，衝突並不常見。通常會在你對已有使用者編輯的設定重新執行匯入時出現。

    自動化的 JSON 輸出

    bash
    openclaw migrate claude --dry-run --jsonopenclaw 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。

    相關

    Was this useful?