OpenClaw 卸载完全指南：从清理到彻底移除

1. 引言OpenClaw 是一款功能强大的开源 AI 助手框架但当你需要更换工具链、释放磁盘空间或解决环境冲突时彻底卸载就显得尤为重要。本文将从二进制文件、配置目录、依赖包、系统服务等多个层面详细介绍如何在 Linux、macOS 和 Windows 上完整卸载 OpenClaw并提供丰富的代码实例供你直接复制运行。2. 卸载前的准备工作在动手卸载之前建议先完成以下准备工作避免误删重要数据或影响其他项目。2.1 备份配置与数据OpenClaw 的配置文件和会话数据通常存放在用户主目录下。如果你之后可能重新安装或迁移到其他机器请先备份这些目录。# 备份 OpenClaw 配置目录Linux / macOS mkdir -p ~/openclaw-backup cp -r ~/.openclaw ~/openclaw-backup/ 2/dev/null || echo 未找到 ~/.openclaw 目录 备份全局配置如果存在 cp -r ~/.config/openclaw ~/openclaw-backup/ 2/dev/null || echo 未找到 ~/.config/openclaw 目录 备份数据目录如果存在 cp -r ~/.local/share/openclaw ~/openclaw-backup/ 2/dev/null || echo 未找到数据目录2.2 确认安装方式OpenClaw 可以通过多种方式安装包括 npm 全局包、Homebrew、源码编译或 Docker。不同的安装方式对应不同的卸载方法请先确认你的安装来源。# 检查是否通过 npm 安装 which openclaw npm ls -g openclaw 2/dev/null 检查是否通过 Homebrew 安装macOS brew list openclaw 2/dev/null 检查是否通过 Docker 运行 docker ps -a | grep openclaw3. 通过包管理器卸载根据你的安装方式选择对应的卸载命令。以下分别介绍 npm、Homebrew 和源码安装的卸载方法。3.1 卸载 npm 全局包如果 OpenClaw 是通过 npm 全局安装的使用以下命令卸载# 卸载 npm 全局包 npm uninstall -g openclaw 验证是否卸载成功 which openclaw || echo openclaw 命令已移除3.2 卸载 Homebrew 安装macOS# 卸载 Homebrew 安装的 openclaw brew uninstall openclaw 如果存在相关依赖可一并清理 brew autoremove3.3 卸载源码编译安装如果你是从源码编译安装的需要手动删除安装目录和符号链接。# 查找 openclaw 可执行文件位置 which openclaw 删除可执行文件假设安装在 /usr/local/bin sudo rm -f /usr/local/bin/openclaw 删除源码目录根据实际路径修改 rm -rf ~/openclaw-source4. 清理配置与数据目录包管理器卸载只会移除可执行文件配置文件和缓存数据仍会残留在系统中。以下命令用于彻底清理这些残留。4.1 Linux / macOS 清理# 删除用户级配置目录 rm -rf ~/.openclaw 删除 XDG 配置目录 rm -rf ~/.config/openclaw 删除缓存目录 rm -rf ~/.cache/openclaw 删除数据目录 rm -rf ~/.local/share/openclaw 删除日志目录如果存在 rm -rf ~/.local/state/openclaw4.2 Windows 清理在 Windows 上OpenClaw 的配置通常位于用户目录下的 AppData 文件夹中。使用 PowerShell 执行以下命令# 删除配置目录 Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw -ErrorAction SilentlyContinue Remove-Item -Recurse -Force $env:APPDATA\openclaw -ErrorAction SilentlyContinue Remove-Item -Recurse -Force $env:LOCALAPPDATA\openclaw -ErrorAction SilentlyContinue 验证清理结果 Test-Path $env:USERPROFILE.openclaw5. 清理环境变量与 Shell 配置安装 OpenClaw 时某些安装脚本可能会修改你的 Shell 配置文件如.bashrc、.zshrc添加 PATH 或别名。卸载后需要手动清理这些残留。# 在 .bashrc 或 .zshrc 中查找 openclaw 相关行 grep -n openclaw ~/.bashrc ~/.zshrc 2/dev/null 使用 sed 删除包含 openclaw 的行请先确认上面的输出 sed -i /openclaw/d ~/.bashrc sed -i /openclaw/d ~/.zshrc 重新加载配置 source ~/.bashrc # 或 source ~/.zshrc6. 清理 Docker 容器与镜像如果你通过 Docker 使用 OpenClaw还需要清理相关的容器、镜像和卷。# 停止并删除 openclaw 容器 docker stop $(docker ps -aq --filter nameopenclaw) 2/dev/null docker rm $(docker ps -aq --filter nameopenclaw) 2/dev/null 删除 openclaw 镜像 docker rmi $(docker images -q --filter referenceopenclaw) 2/dev/null 删除相关数据卷 docker volume rm $(docker volume ls -q --filter nameopenclaw) 2/dev/null 验证清理结果 docker ps -a | grep openclaw || echo Docker 中已无 openclaw 相关资源7. 清理系统服务与定时任务部分安装方式会注册 systemd 服务或 crontab 定时任务需要一并移除。7.1 清理 systemd 服务Linux# 停止并禁用 openclaw 服务 sudo systemctl stop openclaw 2/dev/null sudo systemctl disable openclaw 2/dev/null 删除服务文件 sudo rm -f /etc/systemd/system/openclaw.service sudo rm -f /lib/systemd/system/openclaw.service 重新加载 systemd 配置 sudo systemctl daemon-reload7.2 清理 crontab 定时任务# 查看当前用户的 crontab crontab -l | grep -i openclaw 删除包含 openclaw 的定时任务先确认上面的输出 crontab -l | grep -v -i openclaw | crontab -8. 验证卸载结果完成以上步骤后通过以下命令验证 OpenClaw 是否已彻底移除。# 检查命令是否可用 which openclaw || echo ✓ openclaw 命令已移除 检查配置目录 ls -d ~/.openclaw 2/dev/null || echo ✓ 配置目录已清理 检查 npm 全局包 npm ls -g openclaw 2/dev/null || echo ✓ npm 全局包已移除 检查 Docker 资源 docker ps -a | grep openclaw || echo ✓ Docker 资源已清理 检查环境变量 env | grep -i openclaw || echo ✓ 环境变量已清理9. 常见问题与注意事项在卸载过程中你可能会遇到以下问题这里给出对应的解决方案。9.1 权限不足导致无法删除某些目录或文件需要管理员权限才能删除使用sudo提升权限即可。# 使用 sudo 强制删除 sudo rm -rf /usr/local/lib/node_modules/openclaw sudo rm -rf /usr/local/share/openclaw9.2 卸载后命令仍然可用如果卸载后openclaw命令仍然存在可能是存在多个安装位置逐一排查并删除。# 查找所有 openclaw 可执行文件 find /usr /opt /home -name openclaw -type f 2/dev/null 逐一删除找到的文件 sudo rm -f /找到的路径/openclaw9.3 残留的 Python 包如果 OpenClaw 通过 pip 安装了 Python 依赖也需要一并清理。# 卸载相关 Python 包 pip uninstall openclaw -y pip3 uninstall openclaw -y 清理 pip 缓存 pip cache purge10. 总结彻底卸载 OpenClaw 需要从可执行文件、配置目录、环境变量、系统服务等多个层面入手。本文提供了覆盖 Linux、macOS、Windows 以及 Docker 环境的完整卸载方案并给出了丰富的代码实例。建议按照「备份 → 卸载 → 清理 → 验证」的顺序操作确保系统环境干净无残留。如果在卸载过程中遇到其他问题欢迎在评论区留言交流。