如何卸载 OpenClaw：从配置文件到残留清理的完整卸载指南

1. 卸载 OpenClaw 为什么总留尾巴

OpenClaw 是一个本地 AI 智能体平台，用来在你自己电脑上跑自主运行的 AI 代理，很多人叫它“龙虾”。它装起来方便，但卸载这件事，官方命令只做了一半的活。我见过太多人执行完openclaw uninstall就以为完事了，结果过几天发现后台还有个网关进程在跑，或者~/.openclaw目录里躺着一堆带 API Key 的配置文件。

这篇就是给已经装过 OpenClaw、现在想彻底清干净的人写的。核心要解决三件事：把正在跑的服务停掉、把 CLI 和配置目录删干净、最后验证环境里确实没有残留。适合 macOS、Linux、Windows 三种系统的用户，也覆盖 npm、pnpm、bun、Docker 这几种安装方式。

需要提前说清楚一个概念：OpenClaw 的“卸载”分两层。第一层是程序本体，也就是 CLI 命令和网关服务；第二层是数据层，包括config.toml、settings.json、工作区目录、日志、启动项。官方卸载命令默认只动第一层，第二层得你自己手动清。这就是为什么很多人卸载完还觉得“没干净”。

下面按顺序来，每一步都给可复制的命令。你不需要全部执行，按自己系统的实际情况挑对应的段落就行。

2. 卸载前先停服务，再确认安装方式

动手删之前，必须先让 OpenClaw 停下来。如果网关服务还在后台跑着，你删文件的时候可能遇到“文件被占用”或者删完又被重新生成的情况。

先停网关和守护进程：

openclaw gateway stop openclaw daemon stop

如果这两条命令报“command not found”，说明 CLI 可能已经不在 PATH 里了，但服务可能还在。这种情况直接跳到后面的进程排查部分。

停完服务，确认一下你当初是怎么装的。这一步很关键，因为卸载 CLI 的命令不一样：

# 查看全局安装的包管理器来源 npm ls -g openclaw pnpm ls -g openclaw bun pm ls -g | grep openclaw

哪个命令能列出 openclaw，就说明你是用哪个装的。如果都查不到，但openclaw --version还能输出版本号，那可能是二进制直接安装或者 Docker 方式，后面单独处理。

注意：如果你在 OpenClaw 里配置过 OpenAI、Claude、Gemini 这类平台的 API Key，先别急着删配置。建议先去对应平台把旧 Key 废除并重新生成一个，因为配置文件里存的是明文或可解密的内容，删之前撤销掉最安全。

3. 执行官方卸载与 CLI 移除

服务停掉、安装方式确认后，先跑官方卸载命令。它会把网关服务、状态数据、工作区这几块勾选清理。

交互式卸载：

openclaw uninstall

执行后会出来一个选择界面，用空格键把 Gateway service、State + config、Workspace 全部勾上，然后回车确认。

如果你想一步到位、不用手动确认，用全自动模式：

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

这一步做完，核心服务就没了。但 CLI 命令本体还在，接着按安装方式移除：

# npm 安装 npm uninstall -g openclaw # pnpm 安装 pnpm remove -g openclaw # bun 安装 bun remove -g openclaw

移除完再敲一次openclaw --version，如果提示 command not found，说明 CLI 这层清掉了。如果还能输出版本，检查一下是不是有别名的软链接，比如/usr/local/bin/openclaw这种，手动删掉。

Docker 安装的用户走另一条路：

docker compose down --volumes --remove-orphans docker image prune -f

--volumes会把容器关联的数据卷一起删掉，--remove-orphans清理掉 compose 文件里已经不存在的服务容器。这两步不做，数据卷会一直占着磁盘。

4. config.toml 与 settings.json 残留检查清单

官方卸载命令不会自动删配置目录，这是最容易漏的地方。下面这份清单按系统分，逐条对照检查。

macOS / Linux 下需要检查的目录：

ls -la ~/.openclaw ls -la ~/.clawdbot ls -la ~/.moltbot ls -la ~/.molthub ls -la ~/.config/openclaw

这几个目录里，~/.openclaw是主配置目录，通常包含config.toml、settings.json、日志和会话状态。后面几个是旧版本遗留的目录名，如果你是从早期版本升级上来的，很可能还留着。

确认要删就执行：

rm -rf ~/.openclaw rm -rf ~/.clawdbot ~/.moltbot ~/.molthub ~/.config/openclaw

Windows PowerShell：

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

Windows CMD：

rmdir /s /q "%USERPROFILE%\.openclaw"

删之前建议先看一眼config.toml和settings.json里有没有你还想保留的东西，比如自定义的模型端点、本地知识库路径。确认不需要了再删。

5. 启动项、进程与端口验证

配置删完，还要确认系统里没有开机自启的残留，以及没有进程还在监听端口。

macOS 检查启动代理：

ls ~/Library/LaunchAgents | grep -i -E "openclaw|molt" rm ~/Library/LaunchAgents/bot.molt.gateway.plist rm ~/Library/LaunchAgents/ai.openclaw.gateway.plist

Linux 检查 systemd 用户服务：

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

Windows 打开“任务计划程序”，找名为 “OpenClaw Gateway” 的定时任务，右键删除。

然后验证进程和端口：

# macOS / Linux 查进程 ps aux | grep -i openclaw | grep -v grep # 查端口占用（OpenClaw 默认网关端口常见为 18789 或 3000 附近） lsof -i :18789

Windows 用：

Get-Process | Where-Object {$_.ProcessName -like "*openclaw*"} netstat -ano | findstr "18789"

如果进程还在，用kill -9 <PID>（macOS/Linux）或taskkill /F /PID <PID>（Windows）强制结束。端口如果被别的程序占用，说明不是 OpenClaw 的残留，不用管。

最后做一次总验证：

openclaw --version which openclaw

两条都应该报找不到。到这一步，程序、配置、启动项、进程四层都清干净了。

6. 卸载后常见报错排查

报错一：openclaw: command not found但目录还在

这是正常的，说明 CLI 删了但配置目录没删。回到第 4 节，手动rm -rf ~/.openclaw。

报错二：删除时提示Permission denied

macOS / Linux 在命令前加sudo，Windows 用管理员身份打开终端再执行。注意sudo rm -rf要确认路径没错再回车。

报错三：openclaw uninstall卡在选择界面

用方向键和空格勾选，别直接回车。如果界面乱码，改用--all --yes --non-interactive全自动模式。

报错四：Docker 卸载后磁盘没释放

执行docker system df看占用，再跑docker volume prune清理无主数据卷。docker image prune -f只清镜像，不清卷。

报错五：重启后网关又自己起来了

说明启动项没删干净。macOS 重点查~/Library/LaunchAgents和~/Library/LaunchDaemons，Linux 查systemctl --user list-units | grep openclaw，Windows 查任务计划程序和服务列表。

报错六：API Key 忘了撤销

这个不算报错但风险最高。去 OpenAI、Anthropic、Google AI 等平台的控制台，找到对应 Key 直接废除。已经删了配置文件也没关系，平台侧撤销才是最终保险。

如果你在清理过程中需要重新申请或管理 API Key，可以到 TaoToken API Keys 页面操作，接入细节看 TaoToken 接入文档。想先验证模型连通性，用 模型对话 快速试一下；如果是长期跑编码或 Agent 任务，Coding Plan 更合适。控制台入口在 TaoToken Console。

卸载完建议重启一次电脑，确保所有后台进程和内存里的服务彻底释放。重启后再跑一遍第 5 节的验证命令，全绿就说明这台机器上 OpenClaw 已经清干净了。