如果大家测试完毕、不再需要 OpenClaw,或者部署出错想要重置环境,建议完全干净卸载。普通删除命令只会卸载程序,会残留模型密钥、Agent 记忆、后台服务配置等垃圾文件,容易导致重装报错、配置冲突。
下面给大家一套官方标准卸载方案,适配 Windows、WSL2、macOS、Linux,真正做到零残留、全覆盖。
一、 官方卸载核心命令
首先执行 OpenClaw 官方完整卸载指令,自动关停后台进程、卸载系统守护服务、清除程序注册信息,是最安全、最彻底的卸载方式:
openclaw uninstall --all --yes --non-interactive三大核心参数详细解析
很多新手不清楚参数作用,这里逐一拆解,看懂之后就知道为什么必须用这条完整命令:
--all(核心关键)
卸载 OpenClaw全部组件与用户数据,不保留任何配置:
卸载 Gateway 网关后台服务、系统定时任务
删除所有 Agent 会话、聊天记忆、运行缓存
清空模型配置、联网搜索、技能、钩子等自定义设置
对比:不加--all仅卸载后台服务,会完整保留.openclaw配置文件夹,密钥和旧配置全部残留。
--yes(自动确认)
卸载过程中会多次弹出确认提问(是否删除配置、是否卸载服务等),添加该参数后,自动同意所有操作,无需手动输入 y 确认,全程自动执行。
--non-interactive(静默无交互)
关闭所有交互式弹窗、选择菜单,强制静默运行。避免卸载中途弹出选择框卡住进程,适合一键卸载、脚本批量操作,确保卸载流程不中断、不卡死。
二、卸载全局 NPM 命令
官方卸载仅清理服务和用户数据,通过 NPM 安装的全局 CLI 工具仍会保留,需要手动卸载:
npm uninstall -g openclaw卸载完成后,终端输入openclaw -v,提示“不是内部或外部命令”,即代表 CLI 卸载成功。
三、手动清理残留目录(彻底清零)
为确保 100% 无残留,最后手动删除本地隐藏配置目录,该目录存储所有密钥、人设、日志、缓存文件。
Windows 原生系统(PowerShell)
Remove-Item $env:USERPROFILE\.openclaw -Recurse -Force Remove-Item $env:APPDATA\openclaw -Recurse -Force -ErrorAction Ignore Remove-Item $env:LOCALAPPDATA\openclaw -Recurse -Force -ErrorAction IgnoreWSL2 / Linux / macOS
rm -rf ~/.openclaw rm -rf ~/.config/openclaw四、异常情况补救(命令失效时强制卸载)
如果卸载前进程卡死、命令失效,无法执行卸载指令,先强制终止所有 OpenClaw 相关进程,再执行上述卸载、清残留操作:
# Windows 强制结束占用进程 Stop-Process -Name node -Filter "*openclaw*" -Force -ErrorAction SilentlyContinue五、最终校验:确认卸载干净
完成以上所有步骤,满足以下两点即为彻底卸载:
终端输入
openclaw,提示命令不存在;用户根目录下
.openclaw文件夹已完全删除,无任何残留文件。
至此,你的电脑中 OpenClaw 所有服务、配置、密钥、数据已全部清除,环境完全恢复初始状态。