乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > OpenClaw怎么彻底卸载?一篇讲清 Mac、Windows、云端的完整清理方法.

OpenClaw怎么彻底卸载?一篇讲清 Mac、Windows、云端的完整清理方法.

当前时间： 2026-03-12 21:34:42 分类：办公文件 评论(0)
OpenClaw怎么彻底卸载?一篇讲清 Mac、Windows、云端的完整清理方法.

大家好，这里是神经网络实验室。
最近，对OpenClaw的安全提醒越来越多，不少人开始重新关注一个很实际的问题：如果我不想用了，应该怎么把它正确卸载掉？

因为OpenClaw不只是一个命令行工具，它往往还伴随着后台服务、配置文件、状态目录、Workspace，甚至云端部署资源。所以如果只删表面，不处理底层残留，后面就很容易留下隐患。
所以这篇文章，我将详细描述如何在不同的平台进行删除操作。

1. 卸载 OpenClaw 前，先搞清楚你要删到什么程度

很多人说“卸载”，其实想做的不一定是相同的一件事。

有人可能只是暂时不想用了，这种情况只需要停掉 gateway或者关掉开机自启/后台服务就够了。

如果想彻底从当前设备移除呢？

这种就需要把下面几类东西一起处理：

  • • OpenClaw CLI
  • • Gateway 后台服务
  • • 状态目录 ~/.openclaw
  • • workspace（如果你不再需要）
  • • 平台上的启动项（LaunchAgent / systemd / 计划任务）

如果是云端部署，还需要卸载

  • • 停服务
  • • 删容器 / 镜像 / volume
  • • 删云主机上的状态目录
  • • 如果机器就是专门跑 OpenClaw 的，直接删实例

2. 最省事的办法：直接用官方卸载命令

如果 openclaw 命令还在，优先用官方方式：

openclaw uninstall

如果你想无交互、尽可能一次删干净：

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

如果是通过 npx 临时调用：

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

这通常是最推荐的方法。

3. 如果你想手动卸载，按照下面的顺序操作

无论你是 Mac、Windows 还是 Linux，手动清理的逻辑都差不多：

  1. 1. 停掉 gateway
  2. 2. 删除后台服务
  3. 3. 删除状态目录和配置
  4. 4. 删除 workspace（可选）
  5. 5. 删除 CLI / App / 源码目录 / 容器

3.1停掉 Gateway

openclaw gateway stop

3.2 卸载 Gateway 服务

openclaw gateway uninstall

3.3 删除状态目录

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

如果你设置过自定义配置文件路径（比如 OPENCLAW_CONFIG_PATH），记得一起删。

3.4 删除 workspace（如果你不再需要）

rm -rf ~/.openclaw/workspace

注意：workspace 里可能有你自己的记忆文件、skills、脚本、下载内容。删之前最好先看一眼。

3.5 删除 CLI

根据安装方式选择：

npm rm -g openclaw
pnpm remove -g openclaw
bun remove -g openclaw

4. macOS 卸载指南

4.1 最简单的方式

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

如果你只想停掉服务，也可以先：

openclaw gateway stop

4.2 如果命令没了，但后台还在跑

macOS 上 OpenClaw 常见是通过 LaunchAgent 运行。

默认标签一般是：

  • • ai.openclaw.gateway
  • • 或 ai.openclaw.<profile>
  • • 老版本可能残留 com.openclaw.*

手动移除：

launchctl bootout gui/$UID/ai.openclaw.gateway
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

如果你用了 profile，需要把名字换掉，比如：

launchctl bootout gui/$UID/ai.openclaw.work
rm -f ~/Library/LaunchAgents/ai.openclaw.work.plist

如果你怀疑有老残留：

ls ~/Library/LaunchAgents | grep openclaw

看到旧的 com.openclaw.* 也可以一起清掉。

4.3 删除状态目录

rm -rf ~/.openclaw

如果你用过 profile：

rm -rf ~/.openclaw-<profile>

例如：

rm -rf ~/.openclaw-work

4.4 如果你装过 OpenClaw.app

rm -rf /Applications/OpenClaw.app

4.5 如果你还想把权限也清掉

OpenClaw 本身或者承载它的 Terminal / iTerm / App，可能申请过：

  • • 辅助功能
  • • 屏幕录制
  • • 文件与文件夹访问

可以去：

系统设置 → 隐私与安全性

手动撤销这些授权。

5.Windows 卸载指南

5.1 如果命令还在

在 PowerShell 或 CMD 中：

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

5.2 如果 CLI 没了，但服务还在

Windows 上常见是通过 计划任务（Scheduled Task） 跑 Gateway。

默认任务名一般是：

  • • OpenClaw Gateway
  • • 或 OpenClaw Gateway (<profile>)

可以这样删：

schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

如果用了 profile：

schtasks /Delete /F /TN "OpenClaw Gateway (work)"
Remove-Item -Force "$env:USERPROFILE\.openclaw-work\gateway.cmd"

5.3 删除状态目录

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

如果用了 profile：

Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw-work"

5.4 删除 CLI

npm rm -g openclaw

或者：

pnpm remove -g openclaw
bun remove -g openclaw

6. Linux 卸载指南

Linux 常见通过 systemd user service 运行。

6.1 命令还在：

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

6.2 CLI 没了，但 systemd 还在

默认 unit 常见为：

  • • openclaw-gateway.service
  • • 或 openclaw-gateway-<profile>.service

手动删除：

systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload

如果是 profile：

systemctl --user disable --now openclaw-gateway-work.service
rm -f ~/.config/systemd/user/openclaw-gateway-work.service
systemctl --user daemon-reload

6.3 删除状态目录与 CLI

rm -rf ~/.openclaw
npm rm -g openclaw

7. Docker / Docker Compose 场景怎么卸载

如果你是容器部署，那卸载不仅是删 OpenClaw 命令，还要处理容器、镜像和持久化数据。

7.1 Docker Compose

停止并删除容器：

docker compose down

如果连 volume 也一起删：

docker compose down -v

如果镜像也不想留：

docker compose down --rmi all -v

7.2 单独 Docker 容器

先找容器：

docker ps -a | grep openclaw

删除容器：

docker stop <container_id>
docker rm <container_id>

删除镜像：

docker images | grep openclaw
docker rmi <image_id>

删除 volume：

docker volume ls | grep openclaw
docker volume rm <volume_name>

删 volume 前一定确认里面没有你还要的状态数据。

8. 云端 / VPS / 远程主机场景怎么卸载

如果你是在云服务器上部署的 OpenClaw，本质上还是：

  • • 进机器
  • • 停服务
  • • 删状态
  • • 删 CLI / 容器 / 仓库

8.1 保留服务器，只卸载 OpenClaw

进入远程机器执行：

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

如果命令不可用，就按平台手动处理：

  • • Linux：删 systemd user service
  • • macOS：删 LaunchAgent
  • • Windows：删计划任务

然后再删：

rm -rf ~/.openclaw

如果有 workspace 也顺手清掉。

8.2 整个云主机都不要了

如果这个服务器本来就是专门跑 OpenClaw 的，最干净的方法通常是：

  1. 1. 先备份你要保留的文件
  2. 2. 在云平台控制台中直接删除实例
  3. 3. 同时删除：
    • • 持久磁盘
    • • volume
    • • 快照
    • • 相关 DNS / 防火墙 / 负载均衡（如果是专门为它配的）

9. Fly.io 怎么卸载

如果是 Fly.io：

9.1 删除应用

fly apps destroy <app-name>

9.2 删除 volume（如果有）

fly volumes list -a <app-name>
fly volumes destroy <volume-id>

如果你已经不需要任何状态数据，这样删最干净。

10. Remote Mode 特别容易漏什么？

如果你是：本地客户端或者远程 gateway 主机

那一定要记住：

本地删了 ≠ 远程也删了。

真正还在跑的 gateway 和状态目录，可能在远程机器上。

所以最好分成两边处理：

本地

  • • 删除本地 CLI / App / 本地配置

远程

  • • 停 gateway
  • • 卸载服务
  • • 删除 ~/.openclaw
  • • 删除 workspace

11. 如果你是源码运行（git clone）

如果你不是全局安装，而是直接在源码目录里运行：

  • • git clone
  • • bun run openclaw ...
  • • 或其他本地开发方式

卸载顺序建议是：

  1. 1. 先卸载服务
  2. 2. 再删仓库目录
  3. 3. 再删状态目录

示例：

openclaw gateway uninstall
rm -rf /path/to/openclaw-repo
rm -rf ~/.openclaw

如果 openclaw 命令已经不在，就按对应平台手动删服务。

12. 如果你用了profile，不要漏删

如果你以前用过：

  • • --profile
  • • OPENCLAW_PROFILE

那状态目录可能不是：

~/.openclaw

而是：

~/.openclaw-<profile>

比如：

~/.openclaw-work
~/.openclaw-prod

卸载时别忘了：

  • • 删对应目录
  • • 删对应服务名
  • • 删对应 gateway 脚本 / plist / systemd unit

13. 只想“停用”，不想“删除”，怎么做？

如果只是短期不用，可以只做下面这些：

停服务

openclaw gateway stop

禁止自启

  • • macOS：删除 LaunchAgent
  • • Linux：disable systemd user unit
  • • Windows：删除计划任务

这样做的好处是：

  • • 不会继续后台运行
  • • 之后恢复也方便
  • • workspace 和配置还能保留

14. 怎么确认删干净了？

14.1 检查命令是否还存在

macOS / Linux

which openclaw

Windows

where openclaw

14.2 检查服务是否还存在

macOS

launchctl list | grep openclaw

Linux

systemctl --user list-units | grep openclaw

Windows

去任务计划程序里看有没有：

  • • OpenClaw Gateway

14.3 检查端口是否还在监听

OpenClaw gateway 常见端口是 18789。

macOS / Linux

lsof -i :18789

Windows

netstat -ano | findstr 18789

14.4 检查状态目录是否还在

ls ~/.openclaw

如果不存在，通常说明状态目录已经删掉了。

15. 最短速查版

想彻底删掉，优先用：

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

想手动删：

openclaw gateway stop
openclaw gateway uninstall
rm -rf ~/.openclaw
npm rm -g openclaw

macOS 服务残留：

launchctl bootout gui/$UID/ai.openclaw.gateway
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

Linux 服务残留：

systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload

Windows 服务残留：

schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

16. 最后提醒

如果你的 ~/.openclaw/workspace 里放了这些内容：

  • • skills
  • • memory
  • • 下载文件
  • • 自己写的脚本
  • • 文档资料

在删除前一定先确认一下。因为对很多人来说，真正有价值的反而不是 OpenClaw本体，而是workspace里的东西。