OpenClaw 完全卸载指南：彻底清理不留痕迹

适用于 macOS 系统 | 版本：OpenClaw 2026.3.x

⚠️ 重要提示

卸载前请确保：
1. ✅ 已备份重要数据（工作区、配置文件等）
2. ✅ 了解卸载后所有 OpenClaw 功能将不可用
3. ✅ 有管理员权限（部分操作需要 sudo）

本指南涵盖的清理范围：
- 主程序文件
- 用户数据和配置
- 系统服务和启动项
- 环境变量和 Shell 配置
- 缓存和日志文件
- 浏览器扩展（可选）

一、卸载前准备

1.1 停止所有 OpenClaw 进程

# 查看正在运行的 OpenClaw 进程
ps aux | grep -i openclaw | grep -v grep

# 停止 Gateway 服务
openclaw gateway stop

# 或者强制终止所有进程
pkill -f openclaw
pkill -f openclaw-gateway

1.2 备份重要数据（可选）

# 创建工作区备份
mkdir -p ~/Desktop/openclaw-backup
cp -r ~/.openclaw/workspace ~/Desktop/openclaw-backup/

# 备份配置文件
cp ~/.openclaw/openclaw.json ~/Desktop/openclaw-backup/

# 备份环境变量
cp ~/.openclaw/.env ~/Desktop/openclaw-backup/ 2>/dev/null || true

二、标准卸载流程

2.1 卸载 npm 包

# 全局卸载 OpenClaw
npm uninstall -g openclaw

# 验证卸载
which openclaw
# 应该返回空或 "not found"

2.2 使用 Homebrew 卸载（如果通过 brew 安装）

# 如果通过 Homebrew 安装
brew uninstall openclaw

# 或者
brew uninstall --force openclaw

三、深度清理：删除所有残留文件

3.1 删除主程序目录

# 删除 npm 全局安装目录
sudo rm -rf /opt/homebrew/lib/node_modules/openclaw

# 删除符号链接
sudo rm -f /opt/homebrew/bin/openclaw

# 删除本地 bin 目录（如果存在）
rm -rf ~/.local/share/openclaw

3.2 删除用户数据和配置

# 删除主配置目录（包含所有用户数据）
rm -rf ~/.openclaw

# 验证删除
ls -la ~/.openclaw 2>&1
# 应该显示 "No such file or directory"

⚠️ 注意：这会删除以下内容：
- 所有工作区文件（~/.openclaw/workspace/）
- 配置文件（openclaw.json）
- 凭证和密钥（credentials/）
- 浏览器数据（browser/）
- 日志文件（logs/）
- 定时任务（cron/）
- 已安装的技能（workspace/skills/）

3.3 删除系统服务（macOS LaunchAgent）

# 停止并卸载 LaunchAgent
launchctl unload ~/Library/LaunchAgents/ai.openclaw.gateway.plist 2>/dev/null || true

# 删除 plist 文件
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

# 验证删除
launchctl list | grep openclaw
# 应该返回空

3.4 删除 Shell 配置

Zsh 用户（默认）

# 编辑 ~/.zshrc，删除 OpenClaw 相关行
# 查找并删除以下行：
# source "/Users/$USER/.openclaw/completions/openclaw.zsh"

# 使用 sed 自动删除（谨慎使用）
sed -i '' '/# OpenClaw Completion/d' ~/.zshrc
sed -i '' '/\.openclaw\/completions/d' ~/.zshrc

# 重新加载配置
source ~/.zshrc

Bash 用户

# 编辑 ~/.bashrc 或 ~/.bash_profile
sed -i '' '/# OpenClaw Completion/d' ~/.bashrc 2>/dev/null || true
sed -i '' '/\.openclaw\/completions/d' ~/.bashrc 2>/dev/null || true

# 重新加载配置
source ~/.bashrc

Fish 用户

# 删除 Fish 补全文件
rm -f ~/.config/fish/completions/openclaw.fish

3.5 删除补全脚本

# 删除所有 Shell 补全文件
rm -f ~/.openclaw/completions/openclaw.bash
rm -f ~/.openclaw/completions/openclaw.zsh
rm -f ~/.openclaw/completions/openclaw.fish
rm -f ~/.openclaw/completions/openclaw.ps1

# 删除补全目录（如果为空）
rmdir ~/.openclaw/completions 2>/dev/null || true

四、清理缓存和临时文件

4.1 删除缓存目录

# npm 缓存
npm cache clean --force

# 删除 OpenClaw 相关的临时文件
rm -rf /tmp/openclaw*
rm -rf /var/tmp/openclaw*

# 删除用户缓存（macOS）
rm -rf ~/Library/Caches/openclaw*

# 删除应用支持文件（macOS）
rm -rf ~/Library/Application\ Support/openclaw*

4.2 删除日志文件

# 删除系统日志中的 OpenClaw 条目（可选）
sudo rm -f /var/log/openclaw*

# 清理 Console 日志（macOS）
# 打开 Console.app，搜索 "openclaw"，删除相关日志

五、清理浏览器扩展（可选）

5.1 Chrome 扩展

# 手动删除 Chrome 扩展：
# 1. 打开 Chrome
# 2. 访问 chrome://extensions/
# 3. 找到 "OpenClaw Browser Relay" 扩展
# 4. 点击 "删除"

# 或者删除扩展目录（Chrome 需要关闭）
rm -rf ~/Library/Application\ Support/Google/Chrome/Default/Extensions/*openclaw*

5.2 Edge 扩展

# 手动删除 Edge 扩展：
# 1. 打开 Edge
# 2. 访问 edge://extensions/
# 3. 找到 OpenClaw 相关扩展
# 4. 点击 "删除"

六、验证完全卸载

6.1 检查进程

# 确认没有 OpenClaw 进程在运行
ps aux | grep -i openclaw | grep -v grep
# 应该返回空

6.2 检查文件

# 检查主目录
ls -la ~/.openclaw 2>&1
# 应该显示 "No such file or directory"

# 检查程序
which openclaw
# 应该返回空或 "not found"

# 检查 npm 包
npm list -g openclaw 2>&1
# 应该显示 "empty" 或 "not found"

6.3 检查服务

# 检查 LaunchAgent
launchctl list | grep openclaw
# 应该返回空

# 检查 plist 文件
ls ~/Library/LaunchAgents/ | grep openclaw
# 应该返回空

6.4 检查环境变量

# 检查环境变量中是否还有 OpenClaw 相关配置
env | grep -i openclaw
# 应该返回空

# 检查 Shell 配置
grep -r "openclaw" ~/.zshrc ~/.bashrc ~/.bash_profile 2>/dev/null
# 应该返回空

七、一键卸载脚本

⚠️ 警告：此脚本会删除所有 OpenClaw 数据，请确保已备份重要文件！

#!/bin/bash
# OpenClaw 完全卸载脚本
# 使用方法: chmod +x uninstall_openclaw.sh && ./uninstall_openclaw.sh

set -e

echo "🦞 OpenClaw 完全卸载脚本"
echo "========================"
echo ""
echo "⚠️  警告: 此操作将删除所有 OpenClaw 数据!"
echo ""
read -p "确定要继续吗? (yes/no): " confirm

if [ "$confirm" != "yes" ]; then
    echo "已取消卸载"
    exit 0
fi

echo ""
echo "📋 开始卸载..."
echo ""

# 1. 停止进程
echo "1️⃣  停止 OpenClaw 进程..."
pkill -f openclaw 2>/dev/null || true
pkill -f openclaw-gateway 2>/dev/null || true
sleep 2

# 2. 卸载 npm 包
echo "2️⃣  卸载 npm 包..."
npm uninstall -g openclaw 2>/dev/null || true

# 3. 停止并删除 LaunchAgent
echo "3️⃣  删除系统服务..."
launchctl unload ~/Library/LaunchAgents/ai.openclaw.gateway.plist 2>/dev/null || true
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

# 4. 删除主程序
echo "4️⃣  删除程序文件..."
sudo rm -rf /opt/homebrew/lib/node_modules/openclaw 2>/dev/null || true
sudo rm -f /opt/homebrew/bin/openclaw 2>/dev/null || true

# 5. 删除用户数据
echo "5️⃣  删除用户数据..."
rm -rf ~/.openclaw

# 6. 删除 Shell 配置
echo "6️⃣  清理 Shell 配置..."
sed -i '' '/# OpenClaw Completion/d' ~/.zshrc 2>/dev/null || true
sed -i '' '/\.openclaw\/completions/d' ~/.zshrc 2>/dev/null || true
sed -i '' '/# OpenClaw Completion/d' ~/.bashrc 2>/dev/null || true
sed -i '' '/\.openclaw\/completions/d' ~/.bashrc 2>/dev/null || true

# 7. 删除缓存
echo "7️⃣  清理缓存..."
rm -rf /tmp/openclaw*
rm -rf ~/Library/Caches/openclaw*
rm -rf ~/Library/Application\ Support/openclaw*

echo ""
echo "✅ 卸载完成!"
echo ""
echo "📊 验证结果:"
echo "--------------"

# 验证
if which openclaw >/dev/null 2>&1; then
    echo "❌ openclaw 命令仍存在"
else
    echo "✅ openclaw 命令已删除"
fi

if [ -d ~/.openclaw ]; then
    echo "❌ ~/.openclaw 目录仍存在"
else
    echo "✅ ~/.openclaw 目录已删除"
fi

if launchctl list | grep -q openclaw; then
    echo "❌ LaunchAgent 仍存在"
else
    echo "✅ LaunchAgent 已删除"
fi

echo ""
echo "🎉 OpenClaw 已完全卸载!"
echo ""
echo "如需重新安装，请运行:"
echo "   npm install -g openclaw"

保存并运行：

# 保存脚本
cat > ~/uninstall_openclaw.sh << 'EOF'
[粘贴上面的脚本内容]
EOF

# 添加执行权限
chmod +x ~/uninstall_openclaw.sh

# 运行脚本
~/uninstall_openclaw.sh

八、常见问题

Q1: 卸载后想重新安装怎么办？

# 重新安装 OpenClaw
npm install -g openclaw

# 初始化配置
openclaw setup

Q2: 卸载后残留进程怎么办？

# 强制终止所有 OpenClaw 进程
sudo pkill -9 -f openclaw

# 或者使用 Activity Monitor 手动终止
# 打开 Activity Monitor，搜索 "openclaw"，强制退出

Q3: 如何只删除工作区但保留程序？

# 只删除工作区，保留 OpenClaw 程序
rm -rf ~/.openclaw/workspace/*

# 或者移动到备份目录
mv ~/.openclaw/workspace ~/.openclaw/workspace-backup-$(date +%Y%m%d)

Q4: 卸载后 Shell 提示找不到命令？

这是正常的，说明卸载成功。如果看到以下提示：

zsh: command not found: openclaw

表示 OpenClaw 已成功卸载。

Q5: 如何彻底删除所有备份？

# 删除桌面备份
rm -rf ~/Desktop/openclaw-backup*

# 删除其他位置的备份
find ~ -name "*openclaw*backup*" -type d -exec rm -rf {} + 2>/dev/null || true

九、卸载后清理建议

9.1 重启终端

卸载完成后，建议重启终端或运行：

exec zsh -l
# 或
exec bash -l

9.2 重启系统（可选）

如果担心有残留进程，可以重启系统：

sudo reboot

9.3 检查磁盘空间

# 查看释放的磁盘空间
df -h ~

# 清理系统缓存
sudo purge  # macOS

十、总结

完全卸载 OpenClaw 需要清理以下内容：

验证卸载成功：
- which openclaw 返回空
- ~/.openclaw 目录不存在
- 没有 openclaw 进程运行
- LaunchAgent 已移除

本指南基于 OpenClaw 2026.3.x 版本编写
如有疑问，请参考 OpenClaw 官方文档或社区讨论