1. 手動備份設定檔（保險起見）#

雖然 OpenClaw 支援自動遷移，但建議在操作前先進行備份，以防萬一。

1
# 備份舊有的設定資料夾
2
cp -r ~/.clawdbot ~/.clawdbot_backup

2. 停止舊有的 Clawdbot 服務#

在安裝新版之前，請先確保舊的 Gateway 已經停止運行，避免連接埠衝突。

1
clawdbot gateway stop

3. 安裝 OpenClaw#

如果你是使用 Volta 管理 Node.js 環境，可以直接執行：

1
volta install openclaw

安裝完成後，你可以輸入 openclaw --version 確認是否安裝成功。

4. 執行 Onboarding 遷移#

這是最關鍵的一步。執行以下指令後，系統會自動偵測到舊的 .clawdbot 設定並完成轉移：

1
openclaw onboard --install-daemon

執行後，系統不僅會繼承舊有的設定，還會自動安裝背景服務（Daemon）。

1. onboard --install-daemon vs gateway start 有什麼不同？#

在初次查詢 AI 工具時，得到的建議是直接使用 gateway start 啟動服務。然而在查閱官方文件後發現，正確的初始化流程應該使用 onboard --install-daemon。以下說明兩者的差異：

• openclaw onboard --install-daemon：這是一個完整的「設定嚮導」。它會引導使用者完成基本的初始化配置，最重要的功能是將 OpenClaw 註冊為作業系統的守護進程（Daemon）（在 macOS 是 launchd，在 Linux 是 systemd）。這意味著即使關閉終端機或重啟電腦，服務也會自動執行。
• openclaw gateway start：這是用來啟動或操作已經註冊好的 Daemon 服務。它不會進行初始化設定，僅作為服務的開關指令使用。

為什麼使用 onboard 能夠順利完成遷移？ 因為 onboard 指令具備自動偵測功能。當它發現環境中存在舊有的 Clawdbot 或 Moltbot 設定時，會自動進行資料庫遷移與路徑更新，實現無痛轉移。

2. 遷移完成後，舊的 clawdbot 套件需要刪除嗎？#

建議手動刪除。 雖然新舊指令理論上可以並存（如果沒有別名衝突），但為了保持環境整潔並節省磁碟空間，建議將不再使用的舊版套件移除。

如果你是用 Volta 安裝的，指令如下：

1
volta uninstall clawdbot

執行後，Volta 會自動清理相關的 Shim 和檔案，確保你的環境只留下最新的 OpenClaw。

3. Workspace 資料夾需要手動改名嗎？#

遷移完成後，存放 SOUL.md、MEMORY.md、AGENTS.md 等個人檔案的 Workspace 資料夾（如 ~/clawd）仍會保留原名。這是因為：

• ~/.clawdbot 是系統設定，會自動遷移至 ~/.openclaw
• ~/clawd 是使用者工作區，為避免破壞路徑依賴，不會自動改名

如果希望統一命名，可手動執行：

1
mv ~/clawd ~/openclaw
2
openclaw config set agents.defaults.workspace "$HOME/openclaw"
3
openclaw gateway restart

Q: 從 Clawdbot 升級到 OpenClaw 會不會遺失資料？#

A: 不會遺失任何資料。OpenClaw 的 onboard --install-daemon 指令具備自動遷移功能，會完整保留 ~/.clawdbot 目錄中的所有設定，包括 API 金鑰、模型配置、對話記錄、Workspace 路徑等。遷移過程採用複製而非移動的方式，原始資料會保留在舊位置作為備份，確保資料安全。建議在遷移前仍先手動備份一份到 ~/.clawdbot_backup，以防萬一。

Q: OpenClaw 和 Clawdbot 有什麼差別？#

A: OpenClaw 是 Clawdbot 的正式版本，兩者在核心功能上完全相同，主要差異在於專案名稱和套件名稱的更新。OpenClaw 修正了原本的商標問題，並提供更完善的官方支援和文件。技術架構、API 介面、設定格式都保持向下相容，因此遷移過程非常順暢。使用 openclaw onboard 可以無痛從舊版升級，所有功能都能正常運作。

Q: 遷移需要多久時間？整個流程複雜嗎？#

A: 整個遷移流程非常簡單，通常只需要 2-3 分鐘即可完成。主要步驟包括：停止舊版服務（clawdbot gateway stop）、安裝新版本（volta install openclaw）、執行自動遷移（openclaw onboard --install-daemon）。系統會自動偵測舊版設定並完成轉移，不需要手動修改任何配置檔。唯一需要注意的是確保舊版服務已完全停止，避免連接埠衝突（預設 3000）。

Q: 遷移後還需要保留 Clawdbot 套件嗎？#

A: 不需要，建議移除以保持環境整潔。遷移完成並確認 OpenClaw 運作正常後，可以執行 volta uninstall clawdbot 移除舊版套件。雖然技術上兩個版本可以並存，但會佔用額外的磁碟空間，且可能因為連接埠衝突導致服務啟動失敗。移除舊版本後，Volta 會自動清理相關的 Shim 和檔案，確保只保留最新的 OpenClaw。

Q: 遷移失敗或出現錯誤該怎麼處理？#

A: 遷移失敗通常是因為舊版服務未完全停止或連接埠被佔用。解決步驟：1) 確認執行 clawdbot gateway stop 停止舊版服務；2) 使用 lsof -i :3000 檢查連接埠是否被其他程式佔用；3) 如果問題持續，可以刪除 ~/.openclaw 資料夾，從備份的 ~/.clawdbot_backup 復原設定後重新執行 openclaw onboard。遷移完成後，執行 openclaw config list 和 openclaw gateway status 驗證設定是否正確。