关闭权限且无残留的完整操作手册
如果你决定不再使用 OpenClaw,或者需要重新安装,本指南将帮助你彻底、干净地卸载 OpenClaw,确保不留任何残留文件、配置或权限。
📋 卸载前准备
在开始卸载之前,建议先备份你可能需要保留的数据:
• 工作区文件: ~/.openclaw/workspace/下的项目文件• 记忆文件: MEMORY.md和memory/目录下的个人记忆• 配置文件:如有自定义配置,建议备份
🔧 方法一:使用官方卸载命令(推荐)
OpenClaw 提供了完善的卸载命令,可以安全、彻底地清理所有组件。
1. 停止网关服务
首先停止正在运行的 OpenClaw 网关服务:
openclaw gateway stop2. 执行卸载
根据你的需求选择不同的卸载级别:
🟡 基础卸载(仅删除服务)
openclaw uninstall --service• ✅ 删除网关服务 • ✅ 保留配置和工作区文件 • ✅ CLI 工具仍可继续使用
🟠 标准卸载(服务 + 配置)
openclaw uninstall --service --state• ✅ 删除网关服务 • ✅ 删除配置和状态文件 • ✅ 保留工作区文件
🔴 完全卸载(所有内容)
openclaw uninstall --all --yes• ✅ 删除网关服务 • ✅ 删除所有配置和状态 • ✅ 删除工作区目录 • ✅ 删除应用(macOS) • ⚠️ CLI 工具保留(如需删除需手动操作)
3. 干运行预览(可选)
如果不确定卸载会删除什么,可以先执行干运行:
openclaw uninstall --dry-run这会列出将要删除的文件和目录,但不会实际执行删除操作。
🗑️ 方法二:手动完全清理
如果你想确保100% 无残留,可以手动清理以下步骤:
Windows 系统
# 1. 停止网关服务openclaw gateway stop# 2. 删除配置目录Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"# 3. 删除全局配置(如有)Remove-Item -Recurse -Force "$env:APPDATA\openclaw"# 4. 删除缓存Remove-Item -Recurse -Force "$env:LOCALAPPDATA\openclaw"# 5. 卸载 CLI(如通过 npm 安装)npm uninstall -g openclawmacOS / Linux 系统
# 1. 停止网关服务openclaw gateway stop# 2. 删除配置目录rm -rf ~/.openclaw# 3. 删除全局配置rm -rf ~/.config/openclaw# 4. 删除缓存rm -rf ~/.cache/openclaw# 5. 卸载 CLI(如通过 npm 安装)npm uninstall -g openclaw🔐 权限清理清单
卸载 OpenClaw 后,建议检查并清理以下权限:
浏览器权限
1. 打开浏览器设置 2. 进入 隐私与安全 → 网站设置 3. 搜索 localhost或127.0.0.14. 移除 OpenClaw 相关的权限(摄像头、麦克风、通知等)
系统权限
macOS
# 检查辅助功能权限# 系统设置 → 隐私与安全性 → 辅助功能# 移除终端应用的权限Windows
# 检查防火墙规则Get-NetFirewallRule | Where-Object { $_.DisplayName -like "*openclaw*" }# 删除相关规则(谨慎操作)已连接的服务
检查并断开以下服务的连接:
• [ ] 微信公众号/小程序 • [ ] Telegram Bot • [ ] Discord Bot • [ ] WhatsApp Web • [ ] 其他已配置的渠道
✅ 验证卸载完成
执行以下命令验证是否卸载干净:
# 检查配置目录是否存在# WindowsTest-Path "$env:USERPROFILE\.openclaw" # 应返回 False# macOS/Linuxls -la ~/.openclaw # 应返回 "No such file or directory"# 检查端口占用(默认端口 18789)# Windowsnetstat -ano | findstr :18789 # 应无输出# macOS/Linuxlsof -i :18789 # 应无输出🔄 重新安装
如果你计划重新安装 OpenClaw:
# 全局安装(推荐)npm install -g openclaw# 验证安装openclaw --version# 初始化配置openclaw setup❓ 常见问题
Q: 卸载后 CLI 还能用吗?
A: 是的。openclaw uninstall 只删除网关服务和数据,CLI 工具会保留。如需删除 CLI,使用 npm uninstall -g openclaw。
Q: 工作区文件会被删除吗?
A: 使用 --all 参数会删除工作区。如要保留,请使用 --service --state 组合。
Q: 如何确认没有残留进程?
A: 使用任务管理器(Windows)或活动监视器(macOS)搜索 openclaw 或 node 相关进程。
📞 需要帮助?
• 📖 官方文档:https://docs.openclaw.ai • 💬 社区支持:https://discord.com/invite/clawd • 🐛 问题反馈:https://github.com/openclaw/openclaw
提示:定期清理不用的软件是保持系统清爽的好习惯。如果你只是暂时不使用,可以考虑只停止服务而非完全卸载。
本文档基于 OpenClaw 2026.3.2 版本编写,命令可能随版本更新有所变化。
夜雨聆风