OpenClaw爆火之后也留下了不少隐患,作为本地AI智能体,需按系统执行官方一键卸载 + 手动清理残留,确保彻底删除服务、配置与数据。以下是分平台完整步骤,优先使用官方命令,失败再手动操作。

基本步骤
1、停止运行中的 Gateway 服务
2、卸载系统服务(自动启动项)
3、卸载全局 CLI 工具
4、删除状态 / 配置目录(.openclaw)
5、清理自定义工作区(可选)
6、验证卸载成功
Windows系统卸载步骤
方法1:官方一键卸载
以管理员身份打开PowerShell(Win+X→Windows PowerShell (管理员))
执行一键卸载命令(自动处理服务、数据、配置):
powershellopenclaw uninstall --all --yes --non-interactive
若提示 “不是内部命令”,用 npx 临时调用:
powershellnpx -y openclaw uninstall --all --yes --non-interactive
彻底删除 CLI 工具:
powershellnpm uninstall -g openclaw
验证:输入Get-Command openclaw -ErrorAction SilentlyContinue,无输出即成功
方法2:手动卸载
停止并删除后台任务:
powershellschtasks delete /f /tn "openclaw gateway"
卸载全局 CLI:npm uninstall -g openclaw
删除用户数据目录:
powershellRemove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
删除自定义工作区(如C:\Users\用户名\openclaw)

macOS/Linux 系统卸载步骤
方法 1:官方一键卸载
打开终端(Terminal)
执行一键卸载:
bashopenclaw uninstall --all --yes --non-interactive
卸载全局 CLI:
bashnpm uninstall -g openclaw
验证:输入which openclaw,无输出即成功
方法 2:手动卸载
停止 Gateway 服务:
bashopenclaw gateway stop
卸载 Gateway 服务(launchd/systemd):
bashopenclaw gateway uninstall
删除状态 + 配置:
bashrm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
若设置过自定义配置文件,同步删除
卸载 CLI 工具:npm uninstall -g openclaw
Docker部署版额外清理
停止并删除所有容器:
bashdocker stop $(docker ps -a -q)docker rm $(docker ps -a -q)
删除 OpenClaw 镜像:
bashdocker rmi openclaw
删除本地部署文件:
Windows:删除openclaw/claw文件夹
macOS/Linux:删除自定义安装目录
常见问题与注意事项
权限不足,Windows必须用管理员 PowerShell,macOS/Linux可能需加sudo
命令未找到,确保 Node.js/npm 已安装,或用 npx 临时调用
服务无法停止,手动结束进程(Windows 任务管理器 /kill命令)
彻底清理,删除OPENCLAW_CONFIG环境变量指向的自定义配置文件。
夜雨聆风