在决定卸载 OpenClaw 之前,有一项重要的准备工作咱们需要先做好。别急着敲命令,先把后台进程停干净,再将配置目录妥善备份。毕竟,谁也不想卸载之后发现遗留了一堆垃圾文件,对吧?
因此,首要步骤就是停止正在运行的 OpenClaw 守护进程。如果你启用了 Gateway 服务,务必手动将其停止,否则进程持续占用端口,后续操作可能会出现问题。
# 停止守护进程openclaw daemon stop# 或者停止 Gateway 服务openclaw gateway stop
退一步说,即使你打算彻底“断舍离”,也建议先看一眼配置文件。万一以后想重新搭建,这些配置能节省不少时间。配置文件备份路径如下:
- macOS / Linux:
~/.openclaw/ - Windows:
%USERPROFILE%\.openclaw
准备工作就绪后,下面咱们分平台、分安装方式,逐一完成移除过程。
Windows — PowerShell 安装的卸载方法
如果你是通过那个经典的 iwr -useb https://openclaw.ai/install.ps1 | iex 命令安装的,底层其实是 npm install -g openclaw,把 OpenClaw 写入了 Windows 的用户 PATH(通常是 %APPDATA%\npm)。
步骤 1 — 以管理员身份打开 PowerShell,执行 npm 卸载命令:
npm uninstall -g openclaw
步骤 2 — 验证卸载是否成功:
Get-Command openclaw -ErrorAction SilentlyContinue# 如果没有任何输出,说明已卸载成功
步骤 3 — 要想清理得彻底,顺便删除配置目录和残留文件:
# 删除配置目录Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"# 如果有遗留的 git 安装(~/openclaw 目录),一并删除Remove-Item -Recurse -Force "$env:USERPROFILE\openclaw"# 删除 .localbin 中的包装脚本(git 方式安装时创建)Remove-Item -Force "$env:USERPROFILE\.localbin\openclaw.cmd" -ErrorAction SilentlyContinue
Windows — CMD 安装的卸载方法
CMD 安装命令长这样:curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd。别看它走的是 CMD 脚本,底层和 PowerShell 那一套一模一样——都是走 npm install -g openclaw 的路径,所以卸载方式也相同。
步骤 1 — 打开命令提示符(CMD),执行卸载命令:
npm uninstall -g openclaw
步骤 2 — 验证结果:
where openclaw:: 若显示"无法找到文件"则卸载成功
步骤 3 — 彻底打扫战场:
:: 删除配置目录rmdir /s /q "%USERPROFILE%\.openclaw":: 删除 git 源码目录(如果存在)rmdir /s /q "%USERPROFILE%\openclaw":: 删除 .localbin 包装脚本del /f "%USERPROFILE%\.localbin\openclaw.cmd"
macOS / Linux 安装的卸载方法
macOS 和 Linux 安装方式就丰富一些了。默认安装走的是 curl -fsSL https://openclaw.ai/install.sh | bash,本质是 npm install -g openclaw。但如果当时你指定了 --install-method git,那就是从源码拉取的。两种方式,卸载步骤略有差别。
A. 默认 npm 安装方式卸载
步骤 1 — 执行 npm 全局卸载:
npm uninstall -g openclaw
步骤 2 — 确认命令已经从 PATH 中移除:
which openclaw# 应该没有任何输出,或提示"not found"
步骤 3 — 如果发现卸载后还有残余,可以手动清理 npm 包目录和软链接:
# 找到 npm 全局包根目录npm root -g# 手动删除残留目录(通常 npm uninstall 已自动处理)rm -rf "$(npm root -g)/openclaw"# 删除可能遗留的 Homebrew 软链接(macOS)rm -f /opt/homebrew/bin/openclaw /usr/local/bin/openclaw
步骤 4 — 最后,删除配置目录:
# 主配置目录rm -rf ~/.openclaw# 兼容旧版本遗留目录(如有)rm -rf ~/.clawdbot ~/.moltbot ~/.moldbot
B. git 源码安装方式卸载(--install-method git)
当初用 --install-method git 安装时,脚本会把 OpenClaw 克隆到 ~/openclaw,同时在 ~/.local/bin/openclaw 创建一个包装脚本。卸载时,咱们就把这些东西原路送回。
步骤 1 — 删除包装脚本:
rm -f ~/.local/bin/openclaw
步骤 2 — 删除源码目录(默认路径是 ~/openclaw):
rm -rf ~/openclaw# 如果你使用了自定义路径,替换为你当时指定的目录# 例如:rm -rf ~/my-openclaw-src
步骤 3 — 别忘了清理 shell 配置文件。安装脚本有可能向 ~/.bashrc 或 ~/.zshrc 追加过 PATH 配置,手动打开文件删掉下面这两行:
# 以下两行如存在则删除export PATH="$HOME/.local/bin:$PATH"export PATH="$HOME/.npm-global/bin:$PATH"
然后重新加载配置:
source ~/.bashrc # bash 用户source ~/.zshrc# zsh 用户
步骤 4 — 最后,删除配置目录:
rm -rf ~/.openclaw
npm 全局安装的卸载方法
这种方式最简洁,安装命令就是 npm i -g openclaw,然后 openclaw onboard。卸载自然也是一条命令的事。
步骤 1 — 执行 npm 全局卸载:
npm uninstall -g openclaw
步骤 2 — 验证结果:
# macOS / Linuxwhich openclaw# 应无输出npm list -g openclaw --depth=0 # 应显示 "(empty)" 或报错
# Windowswhere openclaw # 应提示"无法找到"
步骤 3 — 顺便删掉配置目录:
# macOS / Linuxrm -rf ~/.openclaw
# Windows PowerShellRemove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
pnpm 全局安装的卸载方法
如果你用的是 pnpm,安装命令是 pnpm add -g openclaw,然后 openclaw onboard。pnpm 会把全局包写到它自己的存储目录里,一般是 ~/.local/share/pnpm,具体位置可以通过 pnpm root -g 查看。
步骤 1 — 执行 pnpm 全局卸载:
pnpm remove -g openclaw# 或者使用 rm 别名pnpm rm -g openclaw
步骤 2 — 确认已移除:
# macOS / Linuxwhich openclaw# 应无输出pnpm list -g# openclaw 应不在列表中
# Windows PowerShellpnpm list -g# openclaw 应不在列表中
步骤 3 — 如果发现缓存没清干净,可以手动处理一下 pnpm 存储目录:
# 查看 pnpm 全局包根目录pnpm root -g# 手动清理(通常 pnpm remove 已处理)rm -rf "$(pnpm root -g)/openclaw"# 清理 pnpm 全局 bin(如有残留链接)rm -f "$(dirname $(pnpm root -g))/bin/openclaw"
步骤 4 — 最后,删除配置目录:
# macOS / Linuxrm -rf ~/.openclaw
# Windows PowerShellRemove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
卸载方式汇总对照表
| 安装方式 | 核心卸载命令 | 配置目录(可选删除) |
|---|---|---|
| ? Windows PowerShell | npm uninstall -g openclaw | %USERPROFILE%\.openclaw |
| ⌨️ Windows CMD | npm uninstall -g openclaw | %USERPROFILE%\.openclaw |
| ? macOS / Linux(npm 方式) | npm uninstall -g openclaw | ~/.openclaw |
| ? macOS / Linux(git 方式) | rm -f ~/.local/bin/openclaw + rm -rf ~/openclaw | ~/.openclaw |
| ? npm 全局安装 | npm uninstall -g openclaw | ~/.openclaw |
| ⚡ pnpm 全局安装 | pnpm remove -g openclaw | ~/.openclaw |
