OpenClaw 卸载完全指南
本文涵盖 Windows、macOS、Linux 以及 npm、pnpm 等主流安装方式的完整卸载流程，确保不留残余文件。
卸载前的准备
在动手之前，建议先做两件事，避免后续出现端口占用或配置残留。
1. 停止守护进程
如果正在运行 Gateway 服务或 daemon，请先手动停止。否则卸载后可能有残留进程占用资源。
# PowerShell / CMD
openclaw daemon stop
# 或者停止 Gateway 服务
openclaw gateway stop
2. 备份配置文件（可选）
如果你不确定是否需要保留现有配置，建议先备份目录。
- macOS / Linux：
~/.openclaw/ - Windows：
%USERPROFILE%\.openclaw\
⚠️ 注意：卸载 OpenClaw 本体不会自动删除配置目录。如需彻底清除，需手动删除该目录。
Windows 系统卸载
PowerShell 和 CMD 脚本的底层安装机制相同，均通过 npm install -g openclaw 全局安装并写入 PATH。因此卸载核心命令一致，区别仅在于残留文件的清理语法。
PowerShell 方式
以管理员身份打开 PowerShell，执行以下操作：
-
移除全局包
npm uninstall -g openclaw -
验证卸载结果
Get-Command openclaw -ErrorAction SilentlyContinue # 若无输出，说明已卸载成功 -
清理残留文件 如果使用了
-InstallMethod git参数安装，还需额外删除克隆目录和包装脚本。# 删除配置目录 Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw" # 删除 git 源码目录（如有） Remove-Item -Recurse -Force "$env:USERPROFILE\openclaw" # 删除 .local\bin 中的包装脚本 Remove-Item -Force "$env:USERPROFILE\.local\bin\openclaw.cmd" -ErrorAction SilentlyContinue
CMD 方式
打开命令提示符（CMD），逻辑与 PowerShell 类似：
-
移除全局包
npm uninstall -g openclaw -
验证卸载结果
where openclaw :: 若显示'无法找到文件'则卸载成功 -
清理残留文件
:: 删除配置目录 rmdir /s /q "%USERPROFILE%\.openclaw" :: 删除 git 源码目录（如果存在） rmdir /s /q "%USERPROFILE%\openclaw" :: 删除 .local\bin 包装脚本 del /f "%USERPROFILE%\.local\bin\openclaw.cmd"
macOS / Linux 系统卸载
安装脚本默认使用 npm install -g openclaw，但也支持 git 源码方式（--install-method git）。两种方式的卸载步骤略有不同。
A. 默认 npm 安装方式
-
卸载 npm 全局包
npm uninstall -g openclaw -
确认命令已从 PATH 移除
which openclaw # 应无输出，或提示'not found' -
清理遗留目录 通常
npm uninstall会自动处理，但为了保险起见，可以检查并删除。# 找到 npm 全局包根目录 npm root -g # 手动删除残留目录（通常已自动处理） rm -rf "$(npm root -g)/openclaw" # 删除可能遗留的 Homebrew 软链接（macOS） rm -f /opt/homebrew/bin/openclaw /usr/local/bin/openclaw -
彻底清除配置目录
# 主配置目录 rm -rf ~/.openclaw # 兼容旧版本遗留目录（如有） rm -rf ~/.clawdbot ~/.moltbot ~/.moldbot
B. git 源码安装方式（--install-method git）
这种方式会将 OpenClaw 克隆到 ~/openclaw，并在 ~/.local/bin/openclaw 创建包装脚本。
-
删除包装脚本
rm -f ~/.local/bin/openclaw -
删除源码目录
rm -rf ~/openclaw # 如果使用了自定义路径，替换为你当时指定的目录 # 例如：rm -rf ~/my-openclaw-src -
清理 Shell 配置 安装脚本可能向
~/.bashrc或~/.zshrc追加了 PATH 配置行，可手动打开文件删除以下内容：export PATH="$HOME/.local/bin:$PATH" export PATH="$HOME/.npm-global/bin:$PATH"修改后重新加载配置：
source ~/.bashrc # bash 用户 source ~/.zshrc # zsh 用户 -
删除配置目录
rm -rf ~/.openclaw
包管理器全局卸载
npm 全局安装
这是最简洁的安装方式，卸载也只需一条命令。
npm uninstall -g openclaw
验证卸载结果：
- macOS / Linux：
which openclaw应无输出；npm list -g openclaw --depth=0应显示(empty)。 - Windows：
where openclaw应提示'无法找到'。
最后记得删除配置目录：
- macOS / Linux：
rm -rf ~/.openclaw - Windows PowerShell：
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
✅ npm 全局安装是五种方式里卸载最干净的，它会自动移除二进制文件、符号链接和包目录。
pnpm 全局安装
pnpm 将 OpenClaw 写入全局存储目录（通常是 ~/.local/share/pnpm）。
-
执行卸载
pnpm remove -g openclaw # 或者使用 rm 别名 pnpm rm -g openclaw -
验证卸载结果
which openclaw pnpm list -g # openclaw 应不在列表中 -
清理缓存（可选）
# 查看 pnpm 全局包根目录 pnpm root -g # 手动清理（通常 pnpm remove 已处理） rm -rf "$(pnpm root -g)/openclaw" rm -f "$(dirname $(pnpm root -g))/bin/openclaw" -
删除配置目录 同 npm 方式，删除
~/.openclaw。
💡 pnpm 的全局 bin 目录在不同系统下位置不同。如果
pnpm remove -g后命令仍存在，请手动检查并删除该目录下的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 |
按照上述步骤操作，即可彻底卸载 OpenClaw 及其相关依赖。
