这份完整的卸载教程全面覆盖了主流安装方式——不论你是在 Windows、macOS 还是 Linux 系统中部署的 OpenClaw,亦或是通过 npm、pnpm 完成的全局安装,下面都提供了与之对应的详细卸载步骤。
兼容平台与安装方式一览:
- Windows PowerShell
- Windows CMD
- macOS / Linux
- npm
- pnpm

卸载前的准备事项
在正式开始卸载之前,建议先完成两个小操作,确保系统环境不留“痕迹”。
步骤 1 — 停止正在运行的 OpenClaw 守护进程
如果你当前正在使用 Gateway 服务,请手动将其终止,否则可能出现残留进程持续占用端口的情况。
# 停止守护进程 openclaw daemon stop # 或者停止 Gateway 服务 openclaw gateway stop
步骤 2 —(可选)备份配置文件
如果日后可能再次使用,建议先将配置文件复制保存:
- macOS / Linux:
~/.openclaw/ - Windows:
%USERPROFILE%\.openclaw
特别提示: 卸载 OpenClaw 本身不会自动删除配置目录(~/.openclaw/)。如需彻底清除所有数据,需要手动执行删除操作。
Windows — PowerShell 安装方式的卸载步骤
原始安装命令如下: iwr -useb https://openclaw.ai/install.ps1 | iex
PowerShell 脚本实际通过 npm install -g openclaw 完成全局安装,安装位置通常位于 %APPDATA%\npm 目录下。
步骤 1 — 右键以管理员身份启动 PowerShell,然后执行以下命令:
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
若当初安装时使用了 -InstallMethod git 参数,还需额外删除 $env:USERPROFILE\openclaw(git 克隆目录)以及 $env:USERPROFILE\.localbin\openclaw.cmd(包装脚本)。
Windows — 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"
CMD 和 PowerShell 的核心卸载命令完全一致,唯一区别在于清理残留时 CMD 使用 rmdir /s /q,而 PowerShell 使用 Remove-Item -Recurse -Force。
macOS / Linux 安装方式的卸载步骤
安装命令: curl -fsSL https://openclaw.ai/install.sh | bash
安装脚本默认采用 npm install -g openclaw(npm 方式),也可选择 git 源码安装(添加 --install-method git)。两种方式的卸载步骤略有差异。
默认 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
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 配置文件中的 PATH 设置
安装脚本可能向 ~/.bashrc 或 ~/.zshrc 中添加了以下内容,手动打开文件删除对应行即可:
# 以下两行如果存在请删除 export PATH="$HOME/.local/bin:$PATH" export PATH="$HOME/.npm-global/bin:$PATH"
然后重新加载配置:
source ~/.bashrc # bash 用户 source ~/.zshrc # zsh 用户
步骤 4 — 删除配置目录
rm -rf ~/.openclaw
安装脚本在某些情况下还会向 ~/.bashrc / ~/.zshrc 中写入 PATH 配置行(例如在 Linux 上配置 ~/.npm-global)。如需彻底清除,请检查并手动删除这些行,然后执行 source ~/.bashrc(或 source ~/.zshrc)使改动生效。
npm 全局安装方式的卸载步骤
安装命令: npm i -g openclaw,然后执行 openclaw onboard
这种方式最为简洁,卸载也同样省事——一条命令即可完成。
步骤 1 — 执行 npm 全局卸载
npm uninstall -g openclaw
步骤 2 — 验证卸载结果
# macOS / Linux which openclaw # 应无输出 npm list -g openclaw --depth=0 # 应显示 "(empty)" 或报错
# Windows where openclaw # 应提示“无法找到”
步骤 3 —(彻底清除)删除配置目录
# macOS / Linux rm -rf ~/.openclaw
# Windows PowerShell Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
npm 全局安装是五种方式中卸载最干净利落的:npm uninstall -g openclaw 会自动移除二进制文件、符号链接和包目录,无需手动进入 node_modules 处理。
pnpm 全局安装方式的卸载步骤
安装命令: pnpm add -g openclaw,然后执行 openclaw onboard
pnpm 全局安装会将 OpenClaw 放置到 pnpm 的全局存储目录中(通常为 ~/.local/share/pnpm,可通过 pnpm root -g 查看具体路径)。
步骤 1 — 执行 pnpm 全局卸载
pnpm remove -g openclaw # 或者使用 rm 别名 pnpm rm -g openclaw
步骤 2 — 确认是否卸载干净
# macOS / Linux which openclaw # 应无输出 pnpm list -g # openclaw 不应出现在列表中
# Windows PowerShell pnpm 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 / Linux rm -rf ~/.openclaw
# Windows PowerShell Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
pnpm 的全局 bin 目录通常为 ~/.local/share/pnpm(Linux)或 ~/Library/pnpm(macOS)。若执行 pnpm remove -g 后 openclaw 命令仍然存在,可手动检查并删除该目录下的 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 |
