乐于分享
好东西不私藏

OpenClaw 完全卸载指南 - 关闭权限且无残留

OpenClaw 完全卸载指南 - 关闭权限且无残留

关闭权限且无残留的完整操作手册

如果你决定不再使用 OpenClaw,或者需要重新安装,本指南将帮助你彻底、干净地卸载 OpenClaw,确保不留任何残留文件、配置或权限。


📋 卸载前准备

在开始卸载之前,建议先备份你可能需要保留的数据:

  • • 工作区文件~/.openclaw/workspace/ 下的项目文件
  • • 记忆文件MEMORY.md 和 memory/ 目录下的个人记忆
  • • 配置文件:如有自定义配置,建议备份

🔧 方法一:使用官方卸载命令(推荐)

OpenClaw 提供了完善的卸载命令,可以安全、彻底地清理所有组件。

1. 停止网关服务

首先停止正在运行的 OpenClaw 网关服务:

openclaw gateway stop

2. 执行卸载

根据你的需求选择不同的卸载级别:

🟡 基础卸载(仅删除服务)

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 openclaw

macOS / 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. 1. 打开浏览器设置
  2. 2. 进入 隐私与安全 → 网站设置
  3. 3. 搜索 localhost 或 127.0.0.1
  4. 4. 移除 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 版本编写,命令可能随版本更新有所变化。