openclaw migrate

透過外掛擁有的遷移提供者，從另一個代理程式系統匯入狀態。隨附的提供者涵蓋 Claude、Codex 命令列介面及 Hermes；外掛可註冊其他提供者。

命令

openclaw migrate listopenclaw migrate claude --dry-runopenclaw migrate codex --dry-runopenclaw migrate codex --skill gog-vault77-google-workspaceopenclaw migrate codex --plugin google-calendar --dry-runopenclaw migrate codex --plugin google-calendar --verify-plugin-apps --dry-runopenclaw migrate hermes --dry-runopenclaw migrate hermesopenclaw migrate apply codex --yes --skill gog-vault77-google-workspaceopenclaw migrate apply codex --yes --plugin google-calendaropenclaw migrate apply codex --yesopenclaw migrate apply claude --yesopenclaw migrate apply hermes --yesopenclaw migrate apply hermes --include-secrets --yesopenclaw onboard --flow importopenclaw onboard --import-from claude --import-source ~/.claudeopenclaw onboard --import-from hermes --import-source ~/.hermes

執行 openclaw migrate <provider> 且未指定其他旗標時，會規劃、預覽，並在套用前（於終端介面中）提示確認。openclaw migrate plan <provider> 與 openclaw migrate apply <provider> 使用相同的旗標，將預覽和套用拆分為不同的子命令。

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ijxwcm92aWRlcg " type="string"> 已註冊遷移提供者的名稱，例如 hermes。執行 openclaw migrate list 以查看已安裝的提供者。

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tZnJvbSA8cGF0aA " type="string"> 覆寫來源狀態目錄。Hermes 會依循 $HERMES_HOME 和作用中的設定檔，接著使用平台預設值（~/.hermes 或 %LOCALAPPDATA%\hermes）。Codex 預設為 ~/.codex（或 $CODEX_HOME），Claude 預設為 ~/.claude。

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tcGx1Z2luIDxuYW1l " type="string"> 依外掛名稱或項目 ID 選取一個 Codex 外掛安裝項目。重複使用此旗標可遷移多個 Codex 外掛。省略時，互動式 Codex 遷移會顯示原生 Codex 外掛核取方塊選擇器，非互動式遷移則保留所有已規劃的外掛。僅適用於由 Codex 應用程式伺服器清單所探索、從來源安裝的 openai-curated Codex 外掛。

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tYmFja3VwLW91dHB1dCA8cGF0aA " type="string"> 遷移前備份封存檔的路徑或目錄。原樣傳遞給 openclaw backup create。

安全模型

openclaw migrate 採取預覽優先。

Claude 提供者

隨附的 Claude 提供者預設會在 ~/.claude 偵測 Claude Code 狀態。使用 --from <path> 可匯入指定的 Claude Code 主目錄或專案根目錄。

Claude 匯入的內容

• 來自 ~/.claude/projects/*/memory 的 Claude Code 自動記憶 Markdown，以及 使用者設定的 autoMemoryDirectory，會複製至 memory/imports/claude-code/ 下供索引回憶。
• 專案 CLAUDE.md 和 .claude/CLAUDE.md 會匯入 OpenClaw 代理程式工作區（AGENTS.md）。
• 使用者 ~/.claude/CLAUDE.md 會附加至工作區 USER.md。
• 來自專案 .mcp.json、Claude Code ~/.claude.json（包括其各專案項目）及 Claude Desktop claude_desktop_config.json 的 MCP 伺服器定義。
• 包含 SKILL.md 的 Claude Skills 目錄（使用者 ~/.claude/skills 及專案 .claude/skills）。
• Claude 命令 Markdown 檔案（使用者 ~/.claude/commands 及專案 .claude/commands）會轉換為僅能手動叫用的 OpenClaw Skills。

封存與手動檢閱狀態

Claude 鉤子、權限、環境預設值、專案 CLAUDE.local.md、.claude/rules、使用者與專案 agents/ 目錄，以及專案歷史記錄（~/.claude 下的 projects、cache、plans）會保留在遷移報告中，或回報為手動檢閱項目。OpenClaw 不會自動執行鉤子、複製廣泛的允許清單，或匯入 OAuth／Desktop 認證資訊狀態。

Codex 提供者

隨附的 Codex 提供者預設會在 ~/.codex 偵測 Codex 命令列介面狀態；若已設定該環境變數，則會在 CODEX_HOME 偵測。使用 --from <path> 可盤點指定的 Codex 主目錄。

若要移轉至 OpenClaw Codex 執行框架，並有意識地提升實用的個人 Codex 命令列介面資產，請使用此提供者。本機 Codex 應用程式伺服器啟動會使用每個代理程式各自的 CODEX_HOME，因此預設不會讀取你的個人 ~/.codex。一般程序的 HOME 仍會繼承，因此 Codex 可看到共用的 $HOME/.agents/* Skills／外掛市集項目，而子程序則可找到使用者主目錄中的設定與權杖。

在互動式終端機中執行 openclaw migrate codex，會先預覽完整計畫，接著在最終套用確認前開啟核取方塊選擇器。系統會先提示選取 Skills 複製項目。使用 Toggle all on 或 Toggle all off 可進行大量選取。按下空白鍵可切換資料列，或按 Enter 啟用反白的資料列並繼續。已規劃的 Skills 預設勾選，有衝突的 Skills 預設不勾選，而 Skip for now 會略過此次執行的 Skills 複製，但仍繼續進行外掛選取。若有可遷移且從來源安裝的精選 Codex 外掛，並且未提供 --plugin，遷移接著會依外掛名稱提示啟用原生 Codex 外掛。除非目標 OpenClaw Codex 外掛設定已包含該外掛，否則外掛項目預設勾選。現有目標外掛預設不勾選，並顯示類似 conflict: plugin exists 的衝突提示；選擇 Toggle all off 可在該次執行中不遷移任何原生 Codex 外掛，或選擇 Skip for now 在套用前停止。

若要進行指令碼化或精確執行，請明確選取一或多個 Skills 或外掛：

openclaw migrate codex --dry-run --skill gog-vault77-google-workspaceopenclaw migrate apply codex --yes --skill gog-vault77-google-workspaceopenclaw migrate codex --dry-run --plugin google-calendaropenclaw migrate apply codex --yes --plugin google-calendar

Codex 匯入的內容

• 來自 $CODEX_HOME/memories 的整合 Codex MEMORY.md 和 memory_summary.md， 會複製至 memory/imports/codex/ 下供索引 回憶。不會匯入原始 rollout 記憶。
• $CODEX_HOME/skills 下的 Codex 命令列介面 Skills 目錄，但不包括 Codex 的 .system 快取。
• $HOME/.agents/skills 下的個人 AgentSkills，會複製至目前的 OpenClaw 代理程式工作區，以歸屬於各代理程式。
• 透過 Codex 應用程式伺服器 plugin/list 探索到、從來源安裝的 openai-curated Codex 外掛。規劃作業會讀取每個已啟用且已安裝外掛的 plugin/read。

由應用程式支援的外掛遷移有額外的限制條件：

• 由應用程式支援的外掛要求來源 Codex 應用程式伺服器帳戶為 ChatGPT 訂閱帳戶。非 ChatGPT 帳戶或缺少帳戶的回應會以 codex_subscription_required 略過。
• 根據預設，遷移不會呼叫來源 app/list，因此通過帳戶限制條件且由應用程式支援的外掛，會在未驗證來源應用程式可存取性的情況下進行規劃；帳戶查詢傳輸失敗則會以 codex_account_unavailable 略過。
• 傳入 --verify-plugin-apps 可強制取得最新的來源 app/list 快照，並要求每個擁有的應用程式都必須存在、已啟用且可存取，才會規劃原生啟用。在此模式下，帳戶查詢傳輸失敗會接續使用來源應用程式清單進行驗證。快照僅保留於目前程序的記憶體中；絕不會寫入遷移輸出或目標設定。

已停用的外掛、無法讀取的外掛詳細資訊、受訂閱限制的來源帳戶，以及（設定 --verify-plugin-apps 時）缺少、已停用或無法存取的應用程式，會成為具有型別化原因的手動略過項目，而不會成為目標設定項目。套用作業會針對每個選取且符合資格的外掛呼叫應用程式伺服器 plugin/install，即使目標應用程式伺服器已回報該外掛已安裝並啟用。遷移後的 Codex 外掛僅能在選取原生 Codex 執行框架的工作階段中使用；不會公開給 OpenClaw 提供者執行、ACP 對話繫結或其他執行框架。

手動檢閱的 Codex 狀態

Codex config.toml、原生 hooks/hooks.json、非精選市集、並非以原始碼安裝之精選外掛的快取外掛套件，以及未通過原始碼訂閱閘門的原始碼安裝外掛，都不會自動啟用。設定 --verify-plugin-apps 時，也會略過未通過來源應用程式清單閘門的外掛。所有這些項目都會複製至移轉報告或在其中回報，以供手動審查。

對於已移轉、以原始碼安裝的精選外掛，套用下列寫入：

• plugins.entries.codex.enabled: true
• plugins.entries.codex.config.codexPlugins.enabled: true
• plugins.entries.codex.config.codexPlugins.allow_destructive_actions: true
• 每個所選外掛各有一個明確的外掛項目，其中包含 marketplaceName: "openai-curated" 和 pluginName

移轉絕不會寫入 plugins["*"]，也絕不會儲存本機市集快取路徑。

略過的外掛不會寫入目標設定。來源端訂閱失敗會在手動處理項目中以具型別的原因回報：codex_subscription_required、codex_account_unavailable、plugin_disabled 或 plugin_read_unavailable。使用 --verify-plugin-apps 時，來源應用程式清單失敗也可能顯示為 app_inaccessible、app_disabled、app_missing 或 app_inventory_unavailable。目標端需要驗證的安裝會在受影響的外掛項目中回報，並包含 status: "skipped"、reason: "auth_required" 和經過清理的應用程式識別碼；其明確設定項目會以停用狀態寫入，直到你重新授權並啟用它們。其他安裝失敗會產生以項目為範圍的 error 結果。

如果規劃期間無法取得 Codex 應用程式伺服器外掛清單，移轉會改用快取套件的建議項目，而不會讓整個移轉失敗。

Hermes 提供者

隨附的 Hermes 提供者會依循 $HERMES_HOME 和作用中的設定檔，接著使用平台預設值（~/.hermes 或 %LOCALAPPDATA%\hermes）。使用 --from <path> 可覆寫探索行為。

Hermes 匯入的內容

• 來自 config.yaml 的預設模型設定。
• 來自 model、providers 和 custom_providers 的已設定模型提供者與自訂 OpenAI 相容端點。
• 來自 mcp_servers 或 mcp.servers 的 MCP 伺服器定義。精確的 OpenClaw 對應涵蓋預設的可串流 HTTP 路由、OAuth 範圍、布林值 TLS 驗證、分開的用戶端憑證／金鑰路徑，以及 Hermes 原生／資源／提示詞工具政策。不支援的 Hermes 專用執行階段或認證資訊欄位會回報以供手動審查。
• 將 SOUL.md 和 AGENTS.md 匯入 OpenClaw 代理程式工作區。
• 將 memories/MEMORY.md 和 memories/USER.md 附加至工作區記憶檔案。
• OpenClaw 檔案記憶的記憶設定預設值，以及 Honcho 等外部記憶提供者的封存或手動審查項目。
• 在 skills/ 下任何位置包含 SKILL.md 檔案的 Skills；巢狀 Skills 會攤平至工作區 Skills 目錄。
• 來自 skills.config 的各 Skills 設定值。
• 當接受互動式認證資訊移轉，或設定 --include-secrets 時，匯入目前的 Hermes OpenAI Codex OAuth 認證資訊與 OpenCode OpenAI OAuth 認證資訊。請勿讓 Hermes 和 OpenClaw 使用同一個匯入的重新整理授權。
• 當接受互動式認證資訊移轉，或設定 --include-secrets 時，匯入 Hermes .env 和 OpenCode auth.json 中支援的 API 金鑰與權杖。

支援的 .env 金鑰

AI_GATEWAY_API_KEY、ALIBABA_API_KEY、ANTHROPIC_API_KEY、ARCEEAI_API_KEY、CEREBRAS_API_KEY、CHUTES_API_KEY、CLOUDFLARE_AI_GATEWAY_API_KEY、COPILOT_GITHUB_TOKEN、DASHSCOPE_API_KEY、DEEPINFRA_API_KEY、DEEPSEEK_API_KEY、FIREWORKS_API_KEY、GEMINI_API_KEY、GH_TOKEN、GITHUB_TOKEN、GLM_API_KEY、GOOGLE_API_KEY、GROQ_API_KEY、HF_TOKEN、HUGGINGFACE_HUB_TOKEN、KILOCODE_API_KEY、KIMICODE_API_KEY、KIMI_API_KEY、KIMI_CODING_API_KEY、MINIMAX_API_KEY、MINIMAX_CODING_API_KEY、MISTRAL_API_KEY、MODELSTUDIO_API_KEY、MOONSHOT_API_KEY、NVIDIA_API_KEY、OPENAI_API_KEY、OPENCODE_API_KEY、OPENCODE_GO_API_KEY、OPENCODE_ZEN_API_KEY、OPENROUTER_API_KEY、QIANFAN_API_KEY、QWEN_API_KEY、TOGETHER_API_KEY、VENICE_API_KEY、XAI_API_KEY、XIAOMI_API_KEY、ZAI_API_KEY、Z_AI_API_KEY。

僅封存狀態

OpenClaw 無法安全解讀的 Hermes 狀態會複製到移轉報告中以供手動審查，但不會載入即時 OpenClaw 設定或認證資訊。這包括 plugins/、sessions/、logs/、cron/、mcp-tokens/、plans/、workspace/、skins/、kanban/、配對／平台狀態、閘道路由／程序狀態，以及偵測到的 Hermes SQLite 資料庫。

套用後

openclaw doctor

外掛合約

移轉來源是外掛。外掛會在 openclaw.plugin.json 中宣告其提供者 ID：

{  "contracts": {    "migrationProviders": ["hermes"]  }}

執行階段中，外掛會呼叫 api.registerMigrationProvider(...)。提供者會實作 detect、plan 和 apply。核心負責命令列介面協調、備份政策、提示、JSON 輸出與衝突預先檢查。核心會將審查過的計畫傳入 apply(ctx, plan)；只有在基於相容性而未提供該引數時，提供者才可重新建立計畫。

提供者外掛可使用 openclaw/plugin-sdk/migration 建構項目及計算摘要數量，並可使用 openclaw/plugin-sdk/migration-runtime 進行可感知衝突的檔案複製、僅封存的報告複製、快取設定執行階段包裝函式，以及產生移轉報告。

初始設定整合

當提供者偵測到已知來源時，初始設定可提供移轉選項。openclaw onboard --flow import 和 openclaw setup --wizard --import-from hermes 都會使用相同的外掛移轉提供者，並仍會在套用前顯示預覽。

相關內容

• 從 Hermes 移轉：面向使用者的逐步指南。
• 從 Claude 移轉：面向使用者的逐步指南。
• 移轉：將 OpenClaw 移至新機器。
• Doctor：套用移轉後進行健康狀態檢查。
• 外掛：外掛安裝與註冊。