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