


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。



编辑丨黄若琦
审核 | 姚渺波
长按扫码可关注
夜雨聆风