乐于分享
好东西不私藏

OpenClaw 安全指南④|卸载OpenClaw,主打干净不残留

OpenClaw 安全指南④|卸载OpenClaw,主打干净不残留

INTRODUCTION

卸载一个软件不难,难的是卸载得干净、彻底且优雅。OpenClaw的架构复杂度远超普通工具,但只要你按照这篇指南一步步来,就能确保你的系统回到安装前的干净状态,不留任何安全隐患。

图源:AI生成

一张清单,六大步骤,十项操作(附代码说明!主要面向windows和macOS用户),确保卸载万无一失。

手动备份

在正式动刀之前先备份,这不是多余的步骤,而是”优雅”的核心。

#备份整个配置目录cp -r ~/.openclaw ~/openclaw-backup-$(date +%Y%m%d)#如果你需要保留工作区文件cp -r ~/.openclaw/workspace ~/openclaw-workspace-backup

停止服务

这是最关键的一步,跳过它后面的操作都可能出问题。 如果Gateway还在运行,文件可能因被占用而无法删除,端口也不会释放。

Windows (PowerShell,管理员权限)

#删除计划任务schtasks /Delete /F /TN "OpenClaw Gateway"#终止进程Get-Process -Name "openclaw*" | Stop-Process -Force

macOS

 #停止并卸载 LaunchAgentlaunchctl bootout gui/$UID/ai.openclaw.gateway 2>/dev/nulllaunchctl bootout gui/$UID/bot.molt.gateway 2>/dev/nulllaunchctl bootout gui/$UID/com.openclaw.gateway 2>/dev/null#杀掉残留进程pkill -f openclaw || true

验证服务是否已停止

如果还有输出,说明服务没有完全停止,不要继续,先排查原因。

 #检查端口18789 是否还被占用netstat -ano | findstr :18789   Windowslsof -i :18789         macOS/Linux

执行卸载

#官方一键卸载命令openclaw uninstall --all --yes --non-interactive

这条命令会依次执行:停止Gateway服务->删除状态目录(~/.openclaw)->卸载npm全局包

重要提醒:很多人犯的错误是先跑 npm uninstall -g openclaw,这会导致 openclaw 命令消失,之后就无法运行官方的卸载命令了。

手动清理

即使官方命令执行成功,以下手动检查仍然是必要的,因为官方卸载不会清理历史名称的残留目录。

删除所有配置目录

 #当前版本与历史版本残留(OpenClaw经历了两次改名,如果你在不同阶段安装过,系统里可能同时存在三套配置目录)rm -rf ~/.openclawrm -rf ~/.clawdbotrm -rf ~/.moltbotrm -rf ~/.molthub#Windows用户请在 PowerShell 中执行:Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"Remove-Item -Recurse -Force "$env:USERPROFILE\.clawdbot"Remove-Item -Recurse -Force "$env:USERPROFILE\.moltbot"Remove-Item -Recurse -Force "$env:APPDATA\OpenClaw"# macOS 用户rm-rf /Applications/OpenClaw.apprm -rf /tmp/openclaw/rm-f ~/Library/LaunchAgents/ai.openclaw.gateway.plistrm-f ~/Library/LaunchAgents/bot.molt.gateway.plistrm-f ~/Library/LaunchAgents/com.openclaw.plist

卸载 CLI 工具

(如通过 npm/pnpm/bun安装的全局CLI工具)

#npm安装的npm uninstall -g openclawnpm uninstall -g @qingchencloud/openclaw-zh   如果装过中文汉化版#pnpm安装的pnpm remove -g openclaw#bun安装的bun remove -g openclaw

Docker 清理

(如使用Docker部署,还有容器、镜像和数据卷需要清理)

# 停止并删除容器docker stop openclaw && docker rm openclaw# 删除数据卷docker volume rm openclaw-data# 删除镜像docker rmi openclaw/openclaw:latest# 如果用了 docker-composedocker compose down --volumes

清理 Shell 配置

检查你的 .bashrc、.zshrc 或 .bash_profile,删除所有与OpenClaw相关的环境变量和PATH配置。

撤销授权

OpenClaw使用长期有效的OAuth令牌连接你的各种账号。这些令牌存储在服务提供商的服务器上,而非您的本地设备中——因此删除本地文件不会对这些令牌产生任何影响。

必须手动撤销的授权清单

轮换 API 密钥

所有曾经配置在OpenClaw中的API密钥都应该被废弃,并重新生成:

1.OpenAI/Claude/DeepSeek等AI模型的API Key

2.云服务(AWS、阿里云、腾讯云)的Access Key

3.任何第三方服务的API令牌

安全建议:如果你不确定 OpenClaw 曾经连接过哪些服务,可以在删除~/.openclaw之前先查看 ~/.openclaw/openclaw.json和~/.openclaw/agents/*/agent/auth-profiles.json 文件中的配置信息。

验证检查

卸载完成后,执行以下检查确保一切干净:

#1. 命令是否已移除which openclaw#期望输出:openclaw not found#2. 配置目录是否已删除ls ~/.openclaw ~/.clawdbot ~/.moltbot ~/.molthub 2>&1# 期望输出:No such file or directory #3. 后台服务是否已停止(macOS)launchctl list | grep -i openclawlaunchctl list | grep -i moltlaunchctl list | grep -i clawd# 期望输出:无#4. 后台服务是否已停止(Linux)systemctl --user list-units | grep -i openclaw# 期望输出:无#5. 端口是否已释放lsof -i :18789# 期望输出:无#6. 进程是否已终止ps aux | grep -i openclaw# 期望输出:只有 grep 自身

如果以上六项检查步骤全部通过,恭喜你,你的系统已经彻底告别了 OpenClaw。

编辑丨黄若琦

审核 | 姚渺波

长按扫码可关注