彻底删干净!OpenClaw 完全卸载指南(Win/Mac/Linux 全平台)

引言：为什么"卸载"也需要一篇指南？

很多人以为卸载软件就是"删个文件夹"或"拖进回收站"。但作为企业级 AI 助手框架，OpenClaw 的残留可能藏在系统的各个角落。

真正的底层逻辑是：不是删掉就行，而是要干净彻底。

今天这篇指南，教你如何在 Windows、macOS、Linux 三大平台上，100% 彻底卸载 OpenClaw，不留任何残留。

卸载前必读：这些操作前请备份

需要备份的内容

如果你以后可能重新安装，建议备份以下配置：

内容	位置	是否必须备份
配置文件	`~/.openclaw/openclaw.json`	可选
渠道凭证	各渠道配置文件	建议备份
自定义 Agent	自定义工作区	必须备份
日志文件	`~/.openclaw/logs/`	不需要
缓存文件	各平台缓存目录	不需要

备份命令

# 创建备份目录mkdir -p ~/openclaw-backup-$(date +%Y%m%d)# 备份配置文件cp -r ~/.openclaw ~/openclaw-backup-$(date +%Y%m%d)/# 备份自定义 Agent（如有）# cp -r /path/to/your/agent ~/openclaw-backup-$(date +%Y%m%d)/

Windows 平台完全卸载

第一步：停止运行中的 OpenClaw

打开 任务管理器（Ctrl+Shift+Esc）
查找以下进程：

node.exe
（OpenClaw 相关）
openclaw

右键 → 结束任务

第二步：卸载全局安装的 npm 包

打开 命令提示符 或 PowerShell（管理员权限）：

npm uninstall -g openclaw

如果提示找不到，尝试：

npm remove -g openclaw

第三步：删除配置目录

OpenClaw 在 Windows 上的配置目录通常位于：

C:\Users\你的用户名\.openclaw

或者：

%USERPROFILE%\.openclaw

删除方法：

打开文件资源管理器
在地址栏输入 %USERPROFILE%\.openclaw
删除整个 .openclaw 文件夹

第四步：删除 npm 全局缓存

npm cache clean --force

第五步：清理注册表（可选）

⚠️ 警告：操作注册表前请备份。

按 Win+R，输入 regedit
导航到：HKEY_CURRENT_USER\Software\
查找并删除 openclaw 相关项

第六步：验证卸载

openclaw --version

如果显示"'openclaw' 不是内部或外部命令"，说明卸载成功。

macOS 平台完全卸载

第一步：停止运行中的 OpenClaw

# 查找并终止 OpenClaw 进程pkill -f openclawpkill -f "node.*openclaw"

第二步：卸载全局安装的 npm 包

npm uninstall -g openclaw

第三步：删除配置目录

# 删除主配置目录rm -rf ~/.openclaw# 删除可能的其他位置rm -rf ~/Library/Application\ Support/openclawrm -rf ~/Library/Preferences/openclaw

第四步：清理缓存

# 清理 npm 缓存npm cache clean --force# 清理 Homebrew 缓存（如使用 Homebrew 安装）brew cleanup

第五步：删除日志文件

rm -rf ~/Library/Logs/openclaw

第六步：验证卸载

openclaw --version

如果显示 command not found，说明卸载成功。

Linux 平台完全卸载

第一步：停止运行中的 OpenClaw

# 查找并终止 OpenClaw 进程pkill -f openclawpkill -f "node.*openclaw"# 如果作为 systemd 服务运行sudo systemctl stop openclawsudo systemctl disable openclaw

第二步：卸载全局安装的 npm 包

npm uninstall -g openclaw

第三步：删除配置目录

# 删除主配置目录rm -rf ~/.openclaw# 删除系统级配置（如有）sudo rm -rf /etc/openclawsudo rm -rf /opt/openclaw

第四步：清理 systemd 服务（如已安装）

# 删除服务文件sudo rm -f /etc/systemd/system/openclaw.servicesudo rm -f /lib/systemd/system/openclaw.service# 重新加载 systemdsudo systemctl daemon-reload

第五步：清理缓存

# 清理 npm 缓存npm cache clean --force# 清理用户缓存rm -rf ~/.npmrm -rf ~/.cache/npm

第六步：删除日志文件

# 系统日志sudo rm -rf /var/log/openclaw# 用户日志rm -rf ~/.local/share/openclaw/logs

第七步：验证卸载

openclaw --version

如果显示 command not found，说明卸载成功。

跨平台通用清理

清理环境变量

检查并清理以下环境变量：

# Windows（PowerShell）$env:OPENCLAW_HOME$env:OPENCLAW_CONFIG# macOS/Linuxecho $OPENCLAW_HOMEecho $OPENCLAW_CONFIG

如有设置，请从配置文件（.bashrc、.zshrc、.profile 等）中删除相关行。

清理 Docker 容器（如使用）

# 查看 OpenClaw 相关容器docker ps -a | grep openclaw# 停止并删除容器docker stop openclaw-containerdocker rm openclaw-container# 删除镜像docker rmi openclaw/openclaw:latest

清理 Python 虚拟环境（如使用）

# 查找并删除相关虚拟环境rm -rf /path/to/venv

常见问题

Q1: 卸载后还能找到 openclaw 命令？

可能原因：npm 全局路径未清理

解决方法：

# 查看 npm 全局路径npm root -g# 手动删除rm -rf <npm 全局路径>/openclaw

Q2: 配置文件删除不了？

可能原因：文件被占用或权限不足

解决方法：

# macOS/Linux - 强制删除sudo rm -rf ~/.openclaw# Windows - 使用管理员权限的 PowerShellRemove-Item -Recurse -Force $env:USERPROFILE\.openclaw

Q3: 重新安装后配置还在？

原因：配置目录未完全删除

解决方法：按照本文步骤重新检查所有目录

Q4: 如何确认完全卸载？

检查清单：

openclaw --version显示命令不存在

~/.openclaw目录不存在

系统进程中没有 openclaw 相关进程

npm 全局包列表中没有 openclaw

卸载后想重新安装？

如果你是因为遇到问题而卸载，重新安装前建议：

更新 Node.js
— 确保使用 Node.js 18+
更新 npm
— npm install -g npm@latest
检查网络
— 确保能访问 npm 仓库
查看官方文档
— 获取最新安装指南

快速安装命令

# 全局安装npm install -g openclaw# 验证安装openclaw --version# 初始化配置openclaw init

结语：干净卸载，轻松重来

不是卸载麻烦，而是你没找对方法。

按照本文步骤，你可以：

✅ 100% 彻底删除 OpenClaw
✅ 不留任何配置残留
✅ 随时干净地重新安装

如果本文帮到了你，欢迎分享给更多需要的朋友！