🔧 手動分步解除安裝
當一鍵解除安裝不可用時(比如 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 看看就知道了。