How to upgrade from Clawdbot to OpenClaw

1

以下是完整的解決步驟：

問題分析

你目前的版本是 clawdbot 2026.1.24-3，這是 clawdbot 的最後一個版本。該專案經歷了 Clawdbot → Moltbot → OpenClaw 的改名過程，而 clawdbot 套件已棄用，不會再收到修補。目前最新版本是 OpenClaw v2026.2.24。

此外，clawdbot <= 2026.1.24-3 存在一個 Webhook 路由漏洞（CVE，嚴重程度：中等），所以遷移也有安全上的必要。

遷移步驟

1. 先停止 clawdbot gateway

clawdbot gateway stop

2. 卸載舊的 clawdbot

npm uninstall -g clawdbot

3. 確認 Node.js 版本（需要 22+）

node -v

OpenClaw 需要 Node.js 22.12.0 以上。如果版本不夠，請先升級 Node。

4. 安裝 OpenClaw

npm install -g openclaw@latest

5. 執行 onboarding（會自動遷移設定檔）

openclaw onboard --install-daemon

安裝 openclaw 時，所有重要檔案會自動遷移，例如 .clawdbot 目錄會被遷移至 .openclaw，並建立 symlink。

6. 健康檢查

openclaw doctor

7. 如果舊的 systemd 服務還在（Linux VPS 環境）

可能需要手動清理舊的 clawdbot 服務：

systemctl --user stop clawdbot-gateway.service
systemctl --user disable clawdbot-gateway.service
rm -f ~/.config/systemd/user/clawdbot-gateway.service
systemctl --user daemon-reload
systemctl --user reset-failed

關於 Gateway 重啟權限被阻擋

截圖中提到 gateway 重啟被權限設定阻擋，這在遷移到 openclaw 後應該會解決，因為 openclaw onboard --install-daemon 會重新設定 daemon 服務的權限。如果遷移後仍有問題，可以執行：

openclaw gateway restart
openclaw doctor --fix

簡單來說：不是升級，是換套件。clawdbot 已死，直接裝 openclaw@latest 就對了 :lobster:

2

由於專案已正式更名為 OpenClaw，舊的 npm update -g clawdbot 指令只能檢查舊套件的更新，而無法自動遷移到新系統。此外，權限問題（Permission denied）也阻擋了 Gateway 的自動重啟。

請按照以下步驟手動完成從 Clawdbot 到 OpenClaw 的遷移：

  1. 徹底清理舊版 Clawdbot

您需要手動停止舊服務並解除安裝舊套件，以避免埠位（Port 18789）衝突：

  • 停止服務： systemctl --user stop clawdbot-gateway.service
  • 解除安裝： npm uninstall -g clawdbot
  1. 安裝最新的 OpenClaw

使用官方建議的腳本進行安裝，這會自動偵測您的環境並完成必要的配置遷移：

  • 執行安裝指令：

bash

curl -fsSL https://openclaw.bot/install.sh | bash

Use code with caution.

  • 這會將 clawdbot 指令替換為 openclaw，並自動建立相關的符號連結（symlink）。
  1. 執行診斷與修復

安裝後，請執行「醫生」工具來自動修復配置檔案與權限問題：

  • 執行指令： openclaw doctor
  • 此步驟會自動遷移您的設定檔、API 金鑰，並確保新版的 Gateway 服務能正確啟動。
  1. 手動重啟 Gateway (如仍有權限問題)

如果 openclaw doctor 無法自動重啟，請手動執行：

  • 指令： systemctl --user restart openclaw-gateway.service
  • 如果是在 Windows (WSL2) 或 Linux 上，建議使用帶有 --user 的指令以避免 root 權限限制。

後續建議：
完成後，您可以透過輸入 openclaw --version 確認是否已成功升級至最新版本。

您在執行上述指令時，終端機是否有出現任何具體的錯誤代碼（例如 EACCES 或端口衝突提示）？