卸载不干净?OpenClaw 全平台完全卸载攻略(Win/Mac/Linux)

OpenClaw 虽好用，但当我们需要重装或更换版本时，如何彻底卸载往往让人头疼。不同的安装方式（脚本、npm、pnpm）对应着不同的卸载路径。今天这份指南，涵盖了 Windows、macOS、Linux 全平台，助你无残留卸载 OpenClaw 🦞。

🛑 第一步：卸载前的准备工作

在开始之前，做两件小事可以避免后续的麻烦：1. 停止运行中的进程如果 OpenClaw 正在运行，强制删除可能会导致文件占用或端口冲突。打开任意终端，执行：

# 停止守护进程openclaw daemon stop# 如果使用了 Gateway 服务openclaw gateway stop

2. 备份配置（可选）如果你后续还需要用到配置文件，建议先备份以下目录：

macOS / Linux：~/.openclaw/
Windows：%USERPROFILE%\.openclaw\

“
💡 注意：卸载程序本体不会自动删除配置目录，如需彻底清除，请参考文末的“彻底清除”步骤。

🪟 Windows 卸载指南

无论你是用 PowerShell 还是 CMD 安装的，核心卸载逻辑是一样的。

1. 核心卸载命令

打开 PowerShell（管理员） 或 CMD，执行：

npm uninstall -g openclaw

2. 验证是否成功

PowerShell：输入 Get-Command openclaw，若无输出则成功。
CMD：输入 where openclaw，若提示“无法找到文件”则成功。

3. 彻底清除残留文件

如果你想让电脑干干净净，继续执行以下命令删除配置和残留文件：PowerShell 用户：

# 删除配置目录Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"# 删除可能的 git 源码目录Remove-Item -Recurse -Force "$env:USERPROFILE\openclaw"# 删除包装脚本（如果有）Remove-Item -Force "$env:USERPROFILE\.local\bin\openclaw.cmd" -ErrorAction SilentlyContinue

CMD 用户：

rmdir /s /q "%USERPROFILE%\.openclaw"rmdir /s /q "%USERPROFILE%\openclaw"del /f "%USERPROFILE%\.local\bin\openclaw.cmd"

🍎 macOS / Linux 卸载指南

macOS 和 Linux 用户通常有两种安装方式，请根据你的记忆选择对应的卸载方法。

✅ 方式 A：默认 npm 安装（大多数人）

如果你运行的是默认安装脚本，通常是通过 npm 安装的。1. 执行卸载：

npm uninstall -g openclaw

2. 验证：输入 which openclaw，应该没有任何输出。3. 彻底清除残留：

# 删除配置目录rm -rf ~/.openclaw# 删除可能遗留的旧目录（如有）rm -rf ~/.clawdbot ~/.moltbot ~/.moldbot# 清理可能残留的符号链接rm -f /opt/homebrew/bin/openclaw /usr/local/bin/openclaw

✅ 方式 B：Git 源码安装

如果你当时使用了 --install-method git 参数，需要手动删除文件。1. 删除包装脚本：

rm -f ~/.local/bin/openclaw

2. 删除源码目录：

rm -rf ~/openclaw

3. 清理 PATH 环境变量（重要）：检查你的 ~/.bashrc 或 ~/.zshrc，删除包含 export PATH="$HOME/.local/bin:$PATH" 的相关行，然后执行 source ~/.bashrc 生效。

📦 包管理器安装

如果你是极客玩家，直接使用了包管理器安装，卸载只需一条命令。

npm 全局安装用户

# 卸载命令npm uninstall -g openclaw# 彻底清除配置rm -rf ~/.openclaw

pnpm 全局安装用户

# 卸载命令pnpm remove -g openclaw# 彻底清除配置rm -rf ~/.openclaw

“
⚡ 提示：卸载后，如果发现 openclaw 命令依然存在，请检查 pnpm 的全局 bin 目录（pnpm root -g）并手动删除残留链接。

📊 卸载方式速查表

为了方便大家查阅，我整理了一张对照表，建议收藏：

安装方式	核心卸载命令	配置目录（需手动删）
🪟Windows (PS/CMD)	`npm uninstall -g openclaw`	`%USERPROFILE%\.openclaw`
🍎macOS / Linux (npm)	`npm uninstall -g openclaw`	`~/.openclaw`
🐙macOS / Linux (git)	`rm -rf ~/openclaw` (含脚本删除)	`~/.openclaw`
📦npm 全局	`npm uninstall -g openclaw`	`~/.openclaw`
⚡pnpm 全局	`pnpm remove -g openclaw`	`~/.openclaw`

💡 常见问题

Q：我只是想升级，也需要这么麻烦吗？

A：不需要！ OpenClaw 的安装脚本支持自动覆盖升级。本指南仅适用于“彻底删除”或“完全重装”的情况。

Q：卸载后配置没了吗？

A：默认卸载不会删除配置目录。如果你想保留 API Key 等配置以便下次安装使用，可以不执行删除配置目录的步骤。

希望这篇指南能帮到你！如果有其他问题，欢迎在评论区留言交流 👇