OpenClaw 彻底卸载 SOP,送小龙虾回家的正确方式!

你是不是以为一句 npm uninstall -g openclaw 就万事大吉了？ 不。你的 API 密钥还躺在磁盘里，后台服务还在偷偷跑着，甚至你的 OAuth 令牌也没删干净。 这篇教程，就是让你把小龙虾送走得干净、彻底、有尊严。

卸载前要搞清楚OpenClaw 到底留下了什么？

OpenClaw 不是一个普通的命令行工具，它是一套完整的 AI Agent 系统，由以下几部分组成：

⚠️ 安全提示：OX Security 研究员发现，不完整卸载会导致 API 密钥、OAuth 令牌残留。 即使你以为删掉了，凭证文件可能仍在磁盘上。请务必完整执行本教程。

🗂️ 选择你的卸载路径

你的情况是哪种？    ├── openclaw 命令还能用？ → 走「方式一：一键卸载」（最简单）    ├── 用 Docker 部署的？   → 走「方式三：Docker 卸载」（最快）    └── CLI 已删但服务还跑？ → 走「方式二：手动清理」（最稳）

方式一：一键卸载（CLI 仍然可用）

第 1 步：确认 openclaw 命令可用

openclaw --version

看到版本号就可以往下走。

第 2 步：执行内置卸载程序

openclaw uninstall

会弹出交互式菜单，勾选你要卸载的组件（默认全选前三项），回车确认即可：

◆ Uninstall which components?│ ◼ Gateway service (launchd / systemd / schtasks)│ ◼ State + config (~/.openclaw)│ ◼ Workspace (agent files)│ ◻ macOS app

如果你想跳过交互、全部自动删除：

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

或者用 npx（即使本地没装也能跑）：

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

第 3 步：移除 CLI 本体

根据你当初安装时用的包管理器选一条执行：

# 用 npm 安装的npm rm -g openclaw# 用 pnpm 安装的pnpm remove -g openclaw# 用 bun 安装的bun remove -g openclaw

第 4 步：删除 macOS 应用（如果装了）

rm -rf /Applications/OpenClaw.app

✅ 验证是否卸载干净

which openclaw        # 应该返回空openclaw --version    # 应该提示找不到命令ls ~/.openclaw        # 应该返回 No such file or directory

全部通过 → 恭喜，小龙虾已经离开了你的机器。

方式二：手动清理（CLI 已删、服务还在跑）🔧

适合已经手动删过 CLI 但 Gateway 服务仍在后台运行的情况。

macOS（launchd）

# 停止并卸载 Gateway 服务launchctl bootout gui/$UID/bot.molt.gateway# 删除服务描述文件rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist# 清理旧版残留（老版本标签不同）rm -f ~/Library/LaunchAgents/com.openclaw.*.plist# 删除配置 + 数据目录rm -rf ~/.openclaw

Linux（systemd）

# 停止并禁用服务systemctl --user disable --now openclaw-gateway.service# 删除 systemd 单元文件rm -f ~/.config/systemd/user/openclaw-gateway.service# 重载 systemd 配置systemctl --user daemon-reload# 删除配置 + 数据目录rm -rf ~/.openclaw

Windows（计划任务）

CMD / PowerShell 均可：

REM 删除计划任务schtasks /Delete /F /TN "OpenClaw Gateway"REM 删除配置文件夹rmdir /s /q "%USERPROFILE%\.openclaw"

或使用 PowerShell：

# 注销计划任务Unregister-ScheduledTask -TaskName "OpenClaw Gateway" -Confirm:$false# 强制删除配置目录Remove-Item -Path "$env:USERPROFILE\.openclaw" -Recurse -Force# 删除 npm 全局安装残留Remove-Item "$env:APPDATA\npm\openclaw"Remove-Item "$env:APPDATA\npm\openclaw.cmd"

检查是否还有残留进程

# macOS / Linuxps aux | grep -i openclawlsof -iTCP -sTCP:LISTEN -P -n | grep -i openclaw# 如果有进程残留，强制结束pkill -f openclaw

方式三：Docker 部署卸载（最轻松）🐳

Docker 部署是隔离的，不会污染宿主机，卸载最简单：

# 找到 openclaw 容器docker ps -a | grep openclaw# 强制删除容器（替换 <container_id>）docker rm -f <container_id># 删除镜像docker images | grep openclawdocker rmi <image_id># （可选）清理 openclaw 相关的 volumedocker volume ls | grep openclawdocker volume rm <volume_name>

方式四：源码检出（git clone）卸载

适合从 GitHub 直接 clone 源码运行的用户。

# 第一步：先卸载服务（必须在删仓库之前做！）openclaw gateway stopopenclaw gateway uninstall# 第二步：删除仓库目录rm -rf /path/to/openclaw# 第三步：删除数据目录rm -rf ~/.openclaw

⚠️ 顺序不能反：必须先卸载服务，再删仓库，否则服务会因为找不到脚本而无法清理。

🔍 高级排查：卸载后怎么确认真的干净了？

# 1. 检查是否还有残留进程ps aux | grep -i openclaw# 2. 检查端口占用（默认 Gateway 用 8765）lsof -i :8765# 3. 检查服务注册# macOSlaunchctl list | grep openclawlaunchctl list | grep molt# Linuxsystemctl --user list-units | grep openclaw# 4. 全盘搜索残留文件find ~ -name "*openclaw*" 2>/dev/nullfind ~ -name "*molt*" 2>/dev/null

💡 注意：不同版本的 OpenClaw 服务名称不一样，历史上用过 openclaw、clawdbot、gateway、bot.molt.gateway 等多个名称。以上命令会帮你全部扫描到。

🗂️ 使用了多 Profile？

如果你用 --profile 参数或 OPENCLAW_PROFILE 环境变量启动过多个实例，每个 profile 都有独立的状态目录：

# 默认是 ~/.openclaw# 非默认 profile 是 ~/.openclaw-<profile名># 列出所有相关目录ls -d ~/.openclaw*# 逐一删除rm -rf ~/.openclaw-myprofile

服务名也对应不同，比如 bot.molt.<profile>，按上述手动方式逐一清理。

☁️ 用的是云服务器？别忘了这一步！

如果你是租了 VPS / 云服务器跑 OpenClaw，卸载软件≠停止计费。

请到云服务商控制台确认：

• [ ] 服务器是否仍在计费，是否需要销毁实例
• [ ] 是否有附带开通的其他服务（对象存储、带宽包等）
• [ ] 是否绑定了域名解析，需要一并清理

💾 想保留配置，先备份！

如果你日后可能重装，卸载前可以备份配置：

# 备份整个配置目录cp -r ~/.openclaw ~/openclaw_backup_$(date +%Y%m%d)

重装后通过官方恢复功能导入，你的模型配置、渠道设置、聊天记录可以一键还原。

🎯 命令速查表

最后说一句：卸载一个工具不难，难的是卸得干净不留隐患。OpenClaw 作为一个 AI Agent 操作系统，架构复杂，但只要按本教程一步步来，你的系统就能回到装它之前的干净状态——一个字节都不多留。

如果你只是暂时告别，别忘了先备份配置，说不定哪天还想让小龙虾回来帮你干活。🦞