夜雨聆风OpenClaw 彻底卸载指南
清理不留痕迹 · 完整 7 步流程
有时候，告别是为了更好的重逢。如果你决定暂时离开 OpenClaw，这份指南将帮助你干净彻底地卸载它。
为什么需要彻底卸载？
很多用户发现，简单地删除安装目录后，系统中仍残留着各种配置文件、缓存数据和进程。这些残留文件可能：
• 占用磁盘空间
• 影响后续重新安装
• 泄露敏感配置信息
• 导致端口冲突
今天，我们就来一份真正彻底的 OpenClaw 卸载指南。
第一步：停止运行中的服务
在开始卸载之前，确保所有 OpenClaw 相关进程都已停止。
1.1 停止 Gateway 服务
1# 停止 Gateway 服务
2openclaw gateway stop
1.2 检查并终止残留进程
1# 查找所有 openclaw 相关进程
2ps aux | grep openclaw
3# 如有残留，强制终止
4pkill -f openclaw
1.3 检查端口占用
1# 检查 OpenClaw 默认端口
2lsof -i :8080
第二步：卸载 npm 全局包
如果你是通过 npm 安装的 OpenClaw：
1# 卸载全局包
2npm uninstall -g openclaw
3# 验证卸载
4which openclaw # 应该无输出
第三步：删除配置目录
OpenClaw 的配置和数据存储在以下位置：
3.1 主工作区目录
1# 默认工作区
2rm -rf ~/.openclaw/workspace
3.2 配置文件
1# 配置目录
2rm -rf ~/.openclaw/config
3# 环境变量文件
4rm -f ~/.openclaw/.env
3.3 缓存和日志
1# 缓存目录
2rm -rf ~/.openclaw/cache
3# 日志目录
4rm -rf ~/.openclaw/logs
5# 会话数据
6rm -rf ~/.openclaw/sessions
⚠️ 警告：
执行一键清理命令前，请确保已备份需要保留的工作区和配置文件！
1# 一键清理所有 OpenClaw 数据
2rm -rf ~/.openclaw
第四步：清理系统级配置
4.1 检查 systemd 服务（Linux）
1# 查看是否有 openclaw 服务
2systemctl list-units | grep openclaw
3# 如有，停止并禁用
4sudo systemctl stop openclaw
5sudo systemctl disable openclaw
6# 删除服务文件
7sudo rm -f /etc/systemd/system/openclaw.service
8sudo systemctl daemon-reload
4.2 清理启动项（macOS）
1# 检查启动项
2ls ~/Library/LaunchAgents/ | grep openclaw
3# 删除启动项
4rm -f ~/Library/LaunchAgents/com.openclaw.*
5launchctl unload ~/Library/LaunchAgents/com.openclaw.* 2>/dev/null
4.3 清理环境变量
检查并编辑你的 shell 配置文件：
1# 编辑配置文件（根据你的 shell）
2nano ~/.bashrc # Bash
3nano ~/.zshrc # Zsh
4nano ~/.config/fish/config.fish # Fish
删除以下类似内容：
1# 删除这些配置
2export OPENCLAW_HOME=~/.openclaw
3export PATH=$PATH:~/.openclaw/bin
第五步：清理 Docker 资源
如果你使用 Docker 运行 OpenClaw：
1# 停止并删除容器
2docker ps -a | grep openclaw
3docker rm -f openclaw
4# 删除镜像
5docker images | grep openclaw
6docker rmi openclaw/openclaw:latest
7# 删除卷（谨慎操作）
8docker volume ls | grep openclaw
9docker volume rm openclaw_data
第六步：验证卸载
6.1 检查命令是否可用
1openclaw --version
2# 应该显示"command not found"
6.2 检查文件残留
1# 检查主目录
2ls -la ~/.openclaw # 应该不存在
3# 检查全局 npm 包
4npm list -g | grep openclaw # 应该无输出
6.3 检查进程
1ps aux | grep openclaw
2# 应该只有 grep 进程本身
第七步：可选清理
7.1 清理 npm 缓存
1npm cache clean --force
备份建议
在彻底卸载之前，建议备份以下内容：
1# 备份工作区
2cp -r ~/.openclaw/workspace ~/openclaw_workspace_backup
3# 备份配置
4cp -r ~/.openclaw/config ~/openclaw_config_backup
5# 备份重要的 skills
6cp -r ~/.openclaw/workspace/*/skills ~/openclaw_skills_backup
结语
卸载只是暂时的告别。如果你哪天想重新体验 OpenClaw 的强大功能，随时欢迎回来！
1# 重新安装
2npm install -g openclaw
官方文档：https://docs.openclaw.ai
社区：https://discord.com/invite/clawd
💡 喜欢本文？
如果这篇指南对你有帮助，欢迎：
1. 关注公众号 👆 点击下方绿色文字关注我
2. 分享给朋友 帮助更多需要的人
3. 在看 + 点赞 支持我们持续输出干货
觉得本文有帮助？点赞 • 在看 • 转发 分享给更多需要的朋友