乐于分享
好东西不私藏

OpenClaw怎么卸载?完整卸载教程,彻底清除残留!

OpenClaw怎么卸载?完整卸载教程,彻底清除残留!

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环境变量指向的自定义配置文件。