各平台完整卸载OpenClaw完全指南(Windows/macOS/Linux/npm/pnpm)实用指南

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“各平台完整卸载OpenClaw完全指南(Windows/macOS/Li……”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

理解这一步时，涵盖所有安装方式的逐步卸载教程 — Windows、macOS、Linux、npm、pnpm 全部搞定。

平台兼容： Windows PowerShell · ⌨ Windows CMD · macOS / 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 （链接已移除） | iex

落到代码里，PowerShell 脚本借助 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:USERPROFILEopenclaw"

# 删除 .localbin 中的包装脚本（git 方式安装时创建）
Remove-Item -Force "$env:USERPROFILE.localbinopenclaw.cmd" -ErrorAction SilentlyContinue

在这个场景下，如果 PowerShell 安装时采用了 -InstallMethod git 参数，还需额外删除 $env:USERPROFILEopenclaw（git 克隆目录）和 $env:USERPROFILE.localbinopenclaw.cmd（包装脚本）。

Windows — CMD 安装的卸载方法

安装命令： curl -fsSL （链接已移除） -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%.localbinopenclaw.cmd"

实际处理时，CMD 与 PowerShell 安装的卸载核心命令完全相同，区别只在于删除残留文件时 CMD 采用 rmdir /s /q，而 PowerShell 采用 Remove-Item -Recurse -Force。

macOS / Linux 安装的卸载方法

安装命令： curl -fsSL （链接已移除） | bash

安装脚本默认采用 npm install -g openclaw（npm 方式），也能够以 git 源码方式安装（--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

# 或者使用 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/macOS/Linux/npm/pnpm完整卸载OpenClaw的文章就介绍到这了,更多相关完整卸载OpenClaw内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多兼容脚本之家！