OpenClaw卸载完全教程：Windows/macOS/Linux/npm/pnpm

本卸载方案涵盖全部主流部署路径——无论你通过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 链接文件。

卸载方式汇总对照表

来源：互联网