OpenClaw全平台卸载完整指南（含npm/pnpm）

卸载OpenClaw这件事，操作门槛不算高，但不同平台和包管理器的处理路径各有差异。下面这份指南覆盖了从Windows到Linux、从npm到pnpm的完整卸载流程——不仅讲清楚核心命令，还会指出哪些位置容易留残留、哪些目录需要手动清扫。

卸载前的准备工作

真正动手卸载前，最好先完成几个前置操作。处理到位了，后续就不会被残留进程或锁文件折腾。

步骤 1 — 停止正在运行的 OpenClaw 守护进程（daemon）

如果开启了 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 完成全局安装，并将路径写入 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

? 如果安装时使用了 -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 模式），也支持通过 --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 配置文件中的 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

# 或使用简写别名
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 链接文件。

卸载方式汇总对照表

来源：互联网