全平台：Windows、macOS、Linux系统及npm/pnpm包管理器下详细卸载OpenClaw完整指南

这份完整的卸载教程全面覆盖了主流安装方式——不论你是在 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 链接文件。

卸载方式汇总对照表