1. 为什么 openclaw 卸载后还有残留进程和端口占用
很多人第一次卸载 openclaw（小龙虾）时，以为敲一句npm uninstall -g openclaw就完事了。结果过几天发现~/.openclaw目录还在，lsof -i :18789还能看到 gateway 进程在跑，甚至开机后某个后台服务又自己起来了。这不是错觉，而是 openclaw 的架构决定的：它由三部分组成——npm 全局包（CLI 本体）、gateway 网关服务（常驻进程 + 端口监听）、状态与工作区目录（配置、日志、workspace）。这三者卸载路径互相独立，只删其中一个，另外两个就会变成"幽灵残留"。
我实测过一台 macOS 机器，npm ls -g --depth=0里已经看不到 openclaw 了，但ps aux | grep openclaw依然能抓到 gateway 子进程，端口 18789 处于 LISTEN 状态。原因就是 gateway 被注册成了独立的后台服务（launchd 或 systemd），npm 包删除并不会自动注销这个服务。所以"完全卸载"的核心不是删包，而是先停服务、再注销服务、再删包、最后清目录，顺序错了就会留下尾巴。
这篇内容面向已经决定不再使用 openclaw、希望把本地痕迹清干净的开发者。我会给出可复制的卸载命令清单、gateway 进程与端口检查步骤、npm 全局包与缓存清理配置，以及卸载后验证无残留的检查动作。如果你只是想临时停用，那openclaw gateway stop就够了；但如果你要彻底移除，就按下面的顺序走。整个过程不需要重装系统，也不需要手动翻注册表（Windows 场景我会单独说明）。
先明确一个判断标准：什么叫"完全卸载干净"？我的定义是四条同时成立——which openclaw无输出、ps aux | grep openclaw无匹配进程、lsof -i :18789无监听、~/.openclaw目录不存在。四条里任何一条不满足，就说明还有残留。下面所有步骤都是围绕这四条验收标准展开的。
另外提醒一句：卸载前先确认你没有正在跑的任务依赖它。openclaw 的 gateway 可能挂着定时任务或工作区数据，直接rm -rf会丢数据。如果你还想保留 workspace 里的文件，先把~/.openclaw/workspace备份到别处，再执行删除。这个动作花不了两分钟，但能避免后悔。
2. 卸载前的环境确认与 TaoToken 配置留存
在动手删之前，有一件事值得先做：确认你当前是否还在用 openclaw 对接某个模型服务。openclaw 这类工具通常需要配置 Base URL、API Key、Model ID 三件套才能调用模型。如果你之前是通过 TaoToken 这类聚合服务接入的，卸载 openclaw 并不会影响你的账号和 Key，但本地配置文件里的 Key 会随目录一起被删掉。所以建议先把配置里的关键信息记下来，方便以后在别的工具里复用。
TaoToken 的定位是模型 API 聚合与调用入口，官网在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 端点是 https://taotoken.net/api 。它的作用是让你用一套 Key 和统一的 Base URL 去调用不同模型，省去每个工具单独配置的麻烦。openclaw 卸载后，如果你后续换用 Claude Code、Cline 或其他编码工具，这套配置依然能直接迁移过去，不用重新申请。
具体要留存的信息有三项，建议复制到一个临时笔记里：
| 配置项 | 典型值 | 说明 |
|---|---|---|
| Base URL | https://taotoken.net/api | 统一入口，不要带多余路径 |
| API Key | sk-xxxx（你的实际 Key） | 在控制台生成，卸载不影响 |
| Model ID | 如 claude-sonnet-4-5 等 | 按你实际调用的模型填 |
如果你不确定 Key 存在哪，openclaw 一般会放在~/.openclaw/config.json或环境变量里。可以先cat ~/.openclaw/config.json看一眼（注意别把 Key 泄露到公开场合）。确认记下后，再进入卸载流程。这一步不是必须的，但如果你以后还想用同一个 Key 接别的工具，会省很多事。
环境确认还包括检查 openclaw 的安装方式。它可能通过 npm、pnpm、bun 三种包管理器之一安装，也可能是下载的独立二进制或 macOS App。你可以用下面几条命令快速判断：
# 查看命令来源 which openclaw # 查看 npm 全局包 npm ls -g --depth=0 | grep openclaw # 查看 pnpm 全局包 pnpm ls -g --depth=0 2>/dev/null | grep openclaw # 查看 bun 全局包 bun pm ls -g 2>/dev/null | grep openclaw哪条有输出，就说明对应包管理器装了它。三种都查一遍，避免漏删。macOS 用户还要额外检查/Applications/OpenClaw.app是否存在。Windows 用户则要检查%APPDATA%\openclaw和%LOCALAPPDATA%\openclaw两个目录。把这些前置信息摸清楚，后面的删除才不会漏。
3. 可复制的卸载命令清单与 gateway 服务注销
这一节是核心操作区。我按"先停服务、再注销、再删包、最后清目录"的顺序给出完整命令，你可以直接复制执行。注意：命令里的$HOME在 Windows PowerShell 里要换成$env:USERPROFILE，路径分隔符也要相应调整。
第一步，停止 gateway 网关。openclaw 内置了 stop 命令，优先用它，因为它会走正常的关闭流程，释放端口和子进程：
openclaw gateway stop如果命令已经找不到（比如包被误删了），就直接杀进程。先找到 PID：
# macOS / Linux ps aux | grep -i openclaw | grep -v grep # 或者按端口找 lsof -i :18789拿到 PID 后kill -9 <PID>。Windows 用tasklist | findstr openclaw找进程，再taskkill /F /PID <PID>。
第二步，注销 gateway 服务。这一步最容易被忽略，也是残留的根源。openclaw 在安装时可能注册了开机自启服务：
# 先尝试内置卸载 openclaw gateway uninstall # macOS：检查 launchd 服务 launchctl list | grep -i openclaw # 如果有输出，用下面的命令卸载（把 label 换成实际值） launchctl unload ~/Library/LaunchAgents/<label>.plist rm -f ~/Library/LaunchAgents/<label>.plist # Linux：检查 systemd 用户服务 systemctl --user list-units | grep -i openclaw systemctl --user stop openclaw-gateway.service systemctl --user disable openclaw-gateway.service rm -f ~/.config/systemd/user/openclaw-gateway.service systemctl --user daemon-reload第三步，删除 npm / pnpm / bun 全局包。三个都执行一遍，没装的会报错，忽略即可：
npm rm -g openclaw pnpm remove -g openclaw bun remove -g openclaw第四步，删除状态目录和工作区。这一步会删掉配置和 workspace，确认已备份再执行：
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}" rm -rf ~/.openclaw/workspace第五步，删除 macOS App（如果装过）：
rm -rf /Applications/OpenClaw.app第六步，清理 npm 缓存里的残留包。npm 缓存不会自动清，时间久了会占空间，也可能让重装时用到旧版本：
npm cache clean --force # 或者只清 openclaw 相关（npm 不直接支持，用 verify 查看） npm cache verify如果你用的是 pnpm，缓存清理命令是pnpm store prune。bun 则是bun pm cache rm。
关于配置文件的留存，如果你之前用 openclaw 对接过 TaoToken，配置大概长这样（JSON 格式，路径通常是~/.openclaw/config.json）：
{ "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的实际Key", "model": "claude-sonnet-4-5", "gateway": { "port": 18789, "host": "127.0.0.1" } }这个文件会随~/.openclaw一起被删。如果你想把这份配置迁移到别的工具，现在就是复制它的最后时机。迁移时记住三件套：Base URL 填https://taotoken.net/api，Key 填你自己的，Model ID 按需选。这三项在大多数兼容 OpenAI 协议的工具里都能直接用。
4. 验证卸载是否彻底：进程、端口、目录三项检查
命令跑完不代表干净了，必须做验收。我给自己定的验收标准就是开头说的四条，这里展开成可执行的检查动作。
检查一：命令是否还在。执行which openclaw，正常应该没有任何输出。如果还输出路径，说明某个包管理器里还有残留，回到第 3 节重新删。
which openclaw # 期望：无输出检查二：进程是否还在。用ps抓一遍：
ps aux | grep -i openclaw | grep -v grep # 期望：无输出如果还有进程，说明 gateway 服务没注销干净，或者有子进程被别的父进程拉起。这时候用lsof -i :18789看端口占用，找到 PID 再杀。
检查三：端口是否释放。openclaw gateway 默认监听 18789，检查它：
lsof -i :18789 # 期望：无输出 # 或者用 netstat netstat -an | grep 18789端口还处于 LISTEN 状态，就说明有进程没死透。macOS 上可以用lsof -i :18789 -t | xargs kill -9强制清理。
检查四：目录是否删除。确认状态目录和工作区都没了：
ls -la ~/.openclaw 2>/dev/null # 期望：No such file or directory ls -la ~/.openclaw/workspace 2>/dev/null # 期望：No such file or directory四项全过，才算真正卸载干净。我建议把这四条写成一个脚本，以后卸载别的工具也能套用：
#!/bin/bash echo "=== 检查命令 ===" which openclaw || echo "OK: 命令已移除" echo "=== 检查进程 ===" ps aux | grep -i openclaw | grep -v grep || echo "OK: 无残留进程" echo "=== 检查端口 ===" lsof -i :18789 || echo "OK: 端口已释放" echo "=== 检查目录 ===" ls ~/.openclaw 2>/dev/null || echo "OK: 目录已删除"跑一遍，四条都打印 OK，就可以放心了。如果某条没 OK，对照第 3 节对应步骤重做。这里有个小坑：有时候ps抓不到进程，但端口还被占着，那可能是 TIME_WAIT 状态，等几十秒会自己释放，不用慌。
另外，Windows 用户的检查命令略有不同：
# 检查命令 Get-Command openclaw -ErrorAction SilentlyContinue # 检查进程 Get-Process | Where-Object {$_.ProcessName -like "*openclaw*"} # 检查端口 netstat -ano | findstr 18789 # 检查目录 Test-Path "$env:USERPROFILE\.openclaw"逻辑一样，四项都为空/False 才算干净。
5. 卸载 openclaw 常见报错排查：401、local proxy failed 与 OAuth 残留
卸载过程中或卸载后，你可能会撞上几类典型报错。我把它们和真实场景对应起来，方便你对号入座。
第一类：401 Unauthorized。这个报错通常出现在你卸载后想用别的工具复用旧配置时。原因是你复制了旧的 API Key，但那个 Key 可能已经失效，或者 Base URL 填错了。排查顺序：先确认 Base URL 是https://taotoken.net/api（不要多加/v1或斜杠），再确认 Key 没有多余空格。如果还报 401，去控制台重新生成一个 Key。注意，卸载 openclaw 本身不会导致 401，401 是配置问题，不是卸载问题。
第二类：local proxy failed或connect ECONNREFUSED 127.0.0.1:18789。这个报错说明你的某个工具还在尝试连 openclaw 的本地 gateway，但 gateway 已经被你卸载了。典型场景是你之前把别的编辑器或 CLI 的 Base URL 指向了http://127.0.0.1:18789，卸载后这个地址没人监听了。解决办法是把那个工具的 Base URL 改成直连地址，比如https://taotoken.net/api。检查一下你的 Claude Code、Cline、Codex 配置里有没有残留的 localhost 指向。
第三类：reading 'choices'或Cannot read properties of undefined (reading 'choices')。这是 OpenAI 兼容接口的经典报错，通常发生在响应体不是标准格式时。如果你卸载 openclaw 后换了新工具，但新工具的请求格式和返回解析不匹配，就会报这个。排查方法是先用 curl 直接打一次接口，确认返回结构：
curl https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的Key" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-4-5", "messages": [{"role": "user", "content": "hi"}] }'如果 curl 能正常返回带choices的 JSON，说明服务端没问题，是客户端解析的锅。如果 curl 也报错，那就是 Key 或模型 ID 的问题。
第四类：OAuth 相关残留。有些工具（比如 Codex 类）会用 OAuth 登录，卸载 openclaw 后本地可能还留着 token 缓存。典型路径是~/.codex/auth.json或~/.config/openclaw/oauth.json。如果你遇到"已登录但请求失败"的怪现象，检查这些文件并清理：
rm -f ~/.codex/auth.json rm -rf ~/.config/openclaw清理后重新走一遍登录流程即可。这里要强调三件套的完整性：无论你用哪个工具，Base URL、API Key、Model ID 三项必须同时正确，缺一个都会报错。Base URL 用https://taotoken.net/api，Key 用你自己的，Model ID 按工具支持的填。
第五类：EACCES权限错误。删除/Applications/OpenClaw.app或系统级目录时可能遇到，加sudo即可，但要注意别误删系统文件。npm 全局包删除报EACCES，通常是 npm 全局目录权限问题，可以用npm config get prefix看路径，必要时用sudo npm rm -g openclaw。
排查的核心思路是：先分清报错是"卸载没干净"还是"新配置没填对"。前者看第 4 节的四项检查，后者看三件套是否齐全。大部分 401 和 local proxy failed 都是配置迁移问题，不是卸载残留。
6. 卸载后的工具迁移与长期使用建议
把 openclaw 清干净之后，你大概率会换一个工具继续用。这时候前面留存的 TaoToken 配置就派上用场了。不管你换 Claude Code、Cline 还是别的编码助手，接入逻辑都是填三件套：Base URL 填https://taotoken.net/api，API Key 填你自己的，Model ID 按需选。这套配置的好处是统一入口，换工具不用重新申请 Key，也不用记多个地址。
如果你打算长期做编码或跑 Agent 任务，可以考虑用 Coding Plan 这类按量或包月方案，比每次单独调用更划算。具体入口在 https://taotoken.net/api 对应的控制台里能找到。如果你只是想先验证某个模型能不能用，直接用模型对话页面测一下最快，不用装任何工具。控制台里可以管理 API Keys，地址是 https://taotoken.net/api 下的 console 路径。
迁移时有个细节要注意：不同工具对 Base URL 的拼接方式不一样。有的工具会自动加/v1/chat/completions，有的需要你手动补全。TaoToken 的 API 端点是https://taotoken.net/api，如果工具要求填完整的 chat 端点，就填https://taotoken.net/api/v1/chat/completions。填错会导致 404 或 401，这是迁移时最常见的坑。
最后给一个实用建议：卸载工具时养成"停服务→注销服务→删包→清目录→验收"的固定流程，把它变成一个习惯。我见过太多人只删包不注销服务，结果几个月后某个端口还被占着，排查半天才想起来是旧工具。你可以把第 4 节的检查脚本存成~/bin/check-uninstall.sh，每次卸载完跑一遍，四条全 OK 再收工。这样既省心，也不会给系统留垃圾。
如果你后续还想用 openclaw 但只是换台机器，那不用卸载，直接在新机器上重新配置三件套即可。卸载只针对"确定不再用"的场景。清干净之后，你的机器会少一个常驻进程、少一个监听端口、少一份配置目录，启动速度和排查干扰都会好一些。
