遷移指南

將 OpenClaw 遷移到新機器

本指南將 OpenClaw 閘道移至新機器，無需重新進入入門流程。

當您複製 狀態目錄（預設為 ~/.openclaw/）和您的 工作區 時，您會保留：

停止閘道並備份
在舊機器上，停止閘道以免檔案在複製過程中變更，然後進行封存：
Terminal window
```
openclaw gateway stop
cd ~
tar -czf openclaw-state.tgz .openclaw
```
如果您使用多個設定檔（例如 ~/.openclaw-work），請分別封存每一個。
在新機器上安裝 OpenClaw
在新機器上安裝 CLI（如果需要也包括 Node）。如果入門程序建立了一個新的 ~/.openclaw/ 也不打緊——您接下來會將其覆蓋。
複製狀態目錄和工作區
透過 scp、rsync -a 或外部硬碟傳輸封存檔，然後解壓縮：
Terminal window
```
cd ~
tar -xzf openclaw-state.tgz
```
確保包含隱藏目錄，且檔案擁有權符合將執行閘道的使用者。
Run doctor and verify
在新機器上，執行 Doctor 以套用設定遷移並修復服務：
Terminal window
```
openclaw doctor
openclaw gateway restart
openclaw status
```

Profile or state-dir mismatch

如果舊的閘道使用了 --profile 或 OPENCLAW_STATE_DIR 而新的沒有，頻道將顯示為已登出且工作階段將是空的。使用您遷移的相同 profile 或 state-dir 啟動閘道，然後重新執行 openclaw doctor。

僅複製 openclaw.

僅有設定檔是不夠的。憑證位於 credentials/ 下，而代理程式狀態位於 agents/ 下。請務必遷移整個狀態目錄。

權限與所有權

如果您以 root 身份複製或切換了使用者，閘道可能無法讀取憑證。請確保狀態目錄和工作區是由執行閘道的使用者所擁有。

遠端模式

如果您的 UI 指向遠端閘道，遠端主機擁有工作階段和工作區。請遷移閘道主機本身，而不是您的本機筆電。請參閱 FAQ。

Secrets in backups

狀態目錄包含 API 金鑰、OAuth 權杖和頻道憑證。請以加密方式儲存備份，避免使用不安全的傳輸通道，如果您懷疑資料外洩，請輪換金鑰。

在新機器上，確認：