跳到內容

如何乾淨地解除安裝 OpenClaw

有時候想試用新工具,最怕的就是解除安裝後,背景還留著一堆關不掉的服務在耗資源,或者設定檔散落在硬碟各處。如果你決定暫時告別 OpenClaw,我建議你按照正確步驟操作,確保你的系統乾乾淨淨,不會留下任何「殭屍行程」。

這份指南提供兩條路徑:如果你還留著 CLI,用自動化指令最快;如果 CLI 已經刪了但服務還在跑,就得手動清理。

  • 安裝了 OpenClaw 的終端機環境
  • 對應作業系統的權限(用於停止服務)

如果你手邊還有 openclaw 指令,這是最推薦的「簡單路徑」。直接執行內建的解除安裝程式:

Terminal window
openclaw uninstall

如果你是在自動化腳本或透過 npx 執行,可以使用非互動模式:

Terminal window
openclaw uninstall --all --yes --non-interactive
# 或者
npx -y openclaw uninstall --all --yes --non-interactive

如果你偏好手動操作,或者想確認每個細節,請依序執行以下步驟:

  1. 停止 Gateway 服務:

    Terminal window
    openclaw gateway stop
  2. 解除安裝服務(launchd/systemd/schtasks):

    Terminal window
    openclaw gateway uninstall
  3. 刪除狀態與設定檔:

    Terminal window
    rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

    注意:如果你將 OPENCLAW_CONFIG_PATH 設定在狀態目錄以外的地方,記得也要手動刪除該檔案。

  4. 刪除工作空間(選用,這會移除 Agent 相關檔案):

    Terminal window
    rm -rf ~/.openclaw/workspace
  5. 移除 CLI 程式(依據你當初安裝的方式選擇):

    Terminal window
    npm rm -g openclaw
    # 或者
    pnpm remove -g openclaw
    # 或者
    bun remove -g openclaw
  6. 移除 macOS App(如果你有安裝的話):

    Terminal window
    rm -rf /Applications/OpenClaw.app

如果你已經刪除了 openclaw CLI,但發現 Gateway 服務還在背景執行,請根據你的作業系統執行以下指令。

預設標籤為 bot.molt.gateway。如果你有使用 --profile,標籤會是 bot.molt.<profile>。

Terminal window
launchctl bootout gui/$UID/bot.molt.gateway
rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist

預設名稱為 openclaw-gateway.service。

Terminal window
systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload

預設工作名稱為 OpenClaw Gateway。

Terminal window
schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

從原始碼(Source Checkout)解除安裝

Section titled “從原始碼(Source Checkout)解除安裝”

如果你是透過 git clone 方式安裝並直接執行:

  1. 先移除服務:在刪除專案資料夾之前,先執行上述的「簡單路徑」或「手動移除服務」。
  2. 刪除 Repo:直接刪除你 git clone 下來的資料夾。
  3. 清理狀態:手動刪除 ~/.openclaw 與工作空間目錄。

如果你在移除過程中遇到任何意外,可以詢問 AI Setup Assistant 獲取即時協助。

OpenClaw

OpenClaw Expert

還是卡住了?

如果這篇文件沒有解決你的情境,直接問 OpenClaw Expert,拿到可執行步驟。