如何將 OpenClaw 遷移到新機器

換電腦或更換伺服器最煩人的就是重新設定。你可能已經在舊機器上調教好了各種 Prompt，連好了 WhatsApp，存了一堆 Session 歷史。如果只是在新機器重新安裝，這些資料都會消失，你得花大把時間重新輸入 API Key、重新掃碼登入。其實只要搬對資料夾，這一切都能無痛轉移。

這篇指南會教你如何搬移 OpenClaw Gateway，讓你不需要重新進行 Onboarding 就能在新的環境繼續工作。

需要準備的東西

在開始搬家前，請先確認你在舊機器上的以下路徑：

• State Directory (預設為 ~/.openclaw/)：這包含你的 Gateway 設定 (openclaw.json)、API keys、OAuth tokens、Session 歷史以及頻道狀態（例如 WhatsApp 的登入資訊）。
• Workspace (預設為 ~/.openclaw/workspace/)：這存放你的 Agent 檔案，包含 MEMORY.md、USER.md 和 memory/*.md 等。

如果你不確定路徑，可以在舊機器執行：

openclaw status

檢查輸出中的 OPENCLAW_STATE_DIR 或 profile 資訊。

快速開始

按照以下步驟，在 5 分鐘內完成遷移：

1. 備份舊機器資料

先停止 Gateway 確保資料不再變動，然後打包資料夾：

openclaw gateway stop

# 進入家目錄進行打包
cd ~
tar -czf openclaw-state.tgz .openclaw
tar -czf openclaw-workspace.tgz .openclaw/workspace

2. 在新機器安裝 OpenClaw

在新機器上安裝 CLI（參考 Install）。安裝時如果自動產生了新的 ~/.openclaw/ 資料夾也沒關係，我們在下一步會蓋掉它。

3. 搬移並還原資料

將剛才打包的檔案傳送到新機器並解壓縮。請確保：

• 隱藏資料夾（如 .openclaw/）有被正確包含。
• 檔案的擁有者（Ownership）與新機器執行 Gateway 的使用者一致。

4. 執行修復與啟動

在新機器執行 doctor 指令，它會自動修復服務、套用設定遷移並檢查不匹配的項目：

openclaw doctor

接著啟動並檢查狀態：

openclaw gateway restart
openclaw status

疑難排解

以下是遷移時常見的坑，請務必留意：

• 只搬了 openclaw.json：這是最常見的錯誤。設定檔本身並不包含 API 憑證或 WhatsApp 的登入狀態。這些資料存在 $OPENCLAW_STATE_DIR/credentials/ 下，所以一定要整包搬移。
• Profile 或路徑不匹配：如果你在舊機器用了 --profile <name>，新機器也要用同樣的 Profile 啟動。否則你會發現設定沒生效、頻道不見了或是 Session 歷史是空的。
• 權限問題：如果你是用 root 權限搬移檔案，Gateway 可能會因為權限不足而無法讀取憑證。請確保檔案權限屬於目前的使用者。
• 備份檔中的祕密資訊：$OPENCLAW_STATE_DIR 裡面全是敏感資料（API keys, WhatsApp creds）。請像保護生產環境密鑰一樣保護你的備份檔，建議加密存儲，且不要透過不安全的管道傳輸。

如果你在搬家過程中卡住了，可以隨時諮詢 AI Setup Assistant。

下一步

• Doctor 指令詳解
• Gateway 疑難排解
• 資料儲存路徑說明