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）并手动删除残留链接。

📊 卸载方式速查表

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

💡 常见问题

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

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

Q：卸载后配置没了吗？

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