很多人安装 OpenClaw 后，如果卸载不干净，可能会遇到这些问题：

 • 网关服务还在后台运行

 • 重启电脑后服务又自动启动

 • 端口一直被占用

 • 系统里残留配置文件

所以本篇文章整理了一份 OpenClaw 最完整卸载教程，包含：

1️⃣ 官方卸载方式

2️⃣ 手动完整卸载步骤

3️⃣ 常见卸载踩坑

4️⃣ 深度清理残留方法

只要按顺序操作，基本可以 100%彻底删除 OpenClaw。

⸻

一、官方卸载方式（推荐）

如果你是使用 官方脚本安装 的 OpenClaw，最简单的方式就是直接运行官方卸载命令。

# 交互式卸载

openclaw uninstall

如果想 一键自动卸载所有组件：

openclaw uninstall --all --yes --non-interactive

如果本机没有 CLI，可以用 npx 直接运行卸载脚本

npx -y openclaw uninstall --all --yes --non-interactive

说明

该命令会删除以下核心组件：

 • gateway service

 • agent runtime

 • config/state

 • workspace

但是注意：

官方卸载并不会保证完全删除所有残留文件。

所以建议继续执行下面的 扫尾清理步骤。

⸻

二、手动完整卸载步骤

如果你想 彻底删除 OpenClaw，建议按以下顺序操作。

顺序一定要正确：

先停止服务 → 再删除数据 → 最后卸载程序

1、停止 Gateway 服务

openclaw gateway stop

2、卸载 Gateway 启动项

openclaw gateway uninstall

3、删除状态文件和工作区

rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

rm -rf ~/.openclaw/workspace

如果使用过 profile：

rm -rf ~/.openclaw-*

⚠️ 如果出现权限问题，可以使用：

sudo rm -rf

但是一定要注意：

删除命令一定要确认路径。

误删系统目录可能导致 系统损坏甚至服务器崩溃。

⸻

4、卸载 CLI 或 GUI 程序

根据你的安装方式执行对应命令。

npm / pnpm / bun

npm rm -g openclaw

pnpm remove -g openclaw

bun remove -g openclaw

macOS（Homebrew）

brew uninstall openclaw-cli

brew uninstall --cask openclaw

如果是源码安装

如果是通过：

git clone

安装的版本，需要：

1️⃣ 先执行

openclaw gateway uninstall

2️⃣ 确认服务停止

3️⃣ 再删除源码目录

否则可能会出现：

服务仍然引用已经被删除的路径，导致卸载失败。

⸻

三、常见卸载踩坑

很多人会遇到一个问题：

CLI 已经删除，但 Gateway 还在后台运行。

甚至电脑重启之后：

服务又自动启动。

这种情况只能通过 系统级强制卸载。

macOS 强制卸载

launchctl bootout gui/$UID/ai.openclaw.gateway

rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

有些版本的服务名称可能是：

 • com.openclaw.gateway

 • com.clawdbot.gateway

建议检查后再删除。

Linux 强制卸载

systemctl --user disable --now openclaw-gateway.service

rm -f ~/.config/systemd/user/openclaw-gateway.service

systemctl --user daemon-reload

如果是系统服务：

sudo systemctl disable --now openclaw-gateway.service

sudo rm -f /etc/systemd/system/openclaw-gateway.service

sudo systemctl daemon-reload

Windows 强制卸载

以 管理员身份运行 PowerShell

删除计划任务：

schtasks /Delete /F /TN "OpenClaw Gateway"

删除启动脚本：

Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

不同版本可能名称不同：

 • openclaw

 • clawdbot

 • gateway

建议全部检查一遍。

四、深度清理残留

最后建议检查是否还有残留进程。

查看进程

macOS / Linux

ps aux | grep -i openclaw

查看监听端口

lsof -iTCP -sTCP:LISTEN -P -n | grep -i openclaw

或者：

ss -lptn | grep -i openclaw

检查系统启动任务

systemctl --user list-units | grep -i openclaw

launchctl list | grep -i openclaw

crontab -l | grep -i openclaw

五、Docker 安装用户

如果你是 Docker 方式安装，卸载其实最简单。

因为 Docker 环境是隔离的，不会污染宿主机。

只需要执行：

docker ps -a | grep openclaw

docker rm -f <container>

docker rmi <image>

即可完全删除。

总结

如果你想 彻底卸载 OpenClaw，推荐按这个顺序操作：

1️⃣ 官方卸载

2️⃣ 手动删除配置

3️⃣ 删除 CLI / GUI

4️⃣ 强制删除服务

5️⃣ 检查残留进程

这样基本可以 100%清理干净。

如果你经常折腾 AI工具 / 服务器环境 / 自动化工具，后续我也会持续整理：

 • AI工具部署教程

 • 服务器优化指南

 • 自动化脚本合集

 • 实用工具资源库

欢迎关注公众号 「源仓Lab」