🔧 手動分步解除安裝

當一鍵解除安裝不可用時(比如 CLI 損壞了),按照以下步驟手動操作。順序很重要——先停服務,再刪檔案,最後移除工具。

第 1 步:停止 Gateway 服務

首先,確保背景運行的網關服務被停止:

openclaw gateway stop

如果 openclaw 命令已經不可用了,跳過這一步,直接用系統命令強制停止(參見對應系統的專項清理頁面)。

第 2 步:解除安裝服務守護程序

移除開機自啟動設定,防止重啟後服務又回來:

openclaw gateway uninstall

同樣,如果 CLI 不可用,需要手動操作——macOS 清理 launchd,Linux 清理 systemd,Windows 清理排程工作。詳見各系統專項頁面。

第 3 步:刪除設定和狀態資料

OpenClaw 的所有設定檔、聊天記錄、運行狀態都儲存在狀態目錄中:

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

如果你自訂過 OPENCLAW_STATE_DIR 環境變數,需要檢查實際路徑。預設情況下就是 ~/.openclaw

⚠️ 這一步不可逆!所有聊天記錄、自訂設定都會被刪除。如果你可能以後還會用到,請先備份整個 ~/.openclaw 目錄。關於備份的詳細建議,請看注意事項

第 4 步:刪除工作區檔案(可選)

如果第 3 步已經刪了整個 .openclaw 目錄,這步可以跳過。否則單獨清理工作區:

rm -rf ~/.openclaw/workspace

第 5 步:移除 CLI 工具

根據你當初安裝 OpenClaw 的方式,選擇對應的解除安裝命令:

npm 安裝

npm rm -g openclaw

pnpm 安裝

pnpm remove -g openclaw

Bun 安裝

bun remove -g openclaw

Homebrew 安裝(macOS)

# CLI 版本
brew uninstall openclaw-cli

# 桌面應用版本
brew uninstall --cask openclaw

原始碼安裝(git clone)

如果是從原始碼安裝的,確保先完成前面的服務停止和解除安裝步驟,然後直接刪除原始碼目錄即可。一定要先停服務再刪目錄,否則服務可能會引用已刪除的路徑導致報錯。

多 Profile 安裝

如果你使用了自訂 Profile(比如一個用於工作、一個用於個人),每個 Profile 有獨立的狀態目錄,需要逐個刪除:

# 刪除所有 openclaw 相關的 profile 目錄
rm -rf ~/.openclaw
rm -rf ~/.openclaw-*
💡 不確定自己有幾個 Profile?運行 ls -la ~ | grep openclaw 看看就知道了。