1. 为什么 npm uninstall 之后OpenClaw 还在你机器里“活着”如果你在 macOS 或 Linux 上装过 OpenClaw大概率经历过这个场景玩了两天觉得不适合自己随手敲一句npm uninstall -g openclaw看到终端返回 removed 1 package心里就觉得完事了。但真实情况是你只拔掉了地面上那根草土里的根系一点没动。OpenClaw 不是普通的命令行小工具它是一套完整的 AI Agent 运行时有常驻的 Gateway 守护进程、有 SQLite 记忆库、有工作区文件、有 OAuth 授权令牌、有技能插件缓存。这些东西分散在用户目录、系统服务目录、Docker 数据卷里npm 卸载命令根本碰不到它们。更麻烦的是一旦你把全局 CLI 删了官方自带的openclaw uninstall命令也就跑不起来了剩下的残留只能靠手动清理。这篇内容面向的就是这个场景macOS/Linux 上通过 npm 或 Docker 安装过 OpenClaw现在想干净彻底地卸掉并且用 TaoToken 统一 Key 通道验证一下残留是否会影响新工具的接入。我会把每一步的可复制命令、配置文件骨架、以及验证动作都写清楚你跟着做就行。2. 卸载前先搞清楚OpenClaw 到底留了哪些东西动手之前先建立一张“残留地图”不然你删着删着就会漏。OpenClaw 的足迹大致分六类我按清理优先级排一下。第一类是核心配置目录~/.openclaw/里面有openclaw.json主配置、API 密钥、workspace/工作区文件、memory/记忆数据、logs/网关日志。这是敏感信息最集中的地方。第二类是历史残留目录。OpenClaw 改过名早期叫 Clawdbot后来叫 Moltbot所以你可能同时存在~/.clawdbot/、~/.moltbot/、~/.molthub/三套目录。哪怕你现在装的是最新版这些老目录也不会自动消失。第三类是系统服务。macOS 上是 LaunchAgent路径在~/Library/LaunchAgents/下文件名可能是ai.openclaw.gateway.plist或bot.molt.gateway.plistLinux 上是 systemd 用户服务路径~/.config/systemd/user/openclaw-gateway.service。这个 Gateway 默认监听127.0.0.1:18789不先停掉它后面删文件会提示被占用。第四类是 npm 全局包第五类是 Docker 容器/镜像/数据卷第六类是 macOS 特有的/Applications/OpenClaw.app和/tmp/openclaw/临时文件。注意清理顺序必须是“先停服务再删文件最后卸包”。顺序反了服务占着文件句柄你会删不干净。3. TaoToken 前置用统一 Key 通道做接入验证清理残留的最终目的是让机器回到干净状态不影响你后续接入别的 AI 工具。这里我用 TaoToken 作为验证通道原因是它把多家模型的 Key 统一成一个入口配置一次就能切换模型很适合用来做“残留是否干扰新接入”的对照测试。TaoToken 的定位是统一 API Key 通道兼容 OpenAI 风格的接口协议。你只需要一个 Key就能在模型对话、编码 Agent、脚本调用之间复用不用为每个工具单独配一套密钥。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。具体要拿的东西有两个一个 API Key一个 Base URL。Key 在控制台的 API Keys 页面生成地址是 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。生成后先复制到剪贴板后面配置里要用。如果你只是想快速验证模型通不通可以直接用模型对话页面发一条消息试试 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。如果你是要长期跑编码任务或者 Agent建议走 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入细节和参数说明在文档里 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。4. 可复制配置settings.json 与 config.toml 骨架清理完残留之后你需要一个干净的配置来验证新通道。下面给两份骨架一份 JSON 格式给大多数 CLI 工具用一份 TOML 格式给偏好 ini 风格的工具用。把sk-你的TaoToken密钥替换成你实际生成的 Key。先看settings.json{ provider: taotoken, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: claude-sonnet-4-20250514, timeout: 60, max_retries: 3, log_level: info }再看config.toml[provider] name taotoken base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model claude-sonnet-4-20250514 timeout 60 max_retries 3 [logging] level info path ~/.taotoken/logs两份配置的核心字段是一致的base_url指向 TaoToken 的 API 入口api_key是你生成的密钥model填你要用的模型名。区别只是格式按你手头工具的要求选一份即可。提示配置文件建议放在~/.config/你的工具名/下权限设成600避免密钥被其他用户读到。命令是chmod 600 ~/.config/你的工具名/settings.json。5. 六步清理流程从停服务到删目录5.1 第一步备份给自己留条后路卸载不等于毁尸灭迹先备份再动手。核心配置目录整个打包cp -r ~/.openclaw ~/openclaw-backup-$(date %Y%m%d)如果你还想保留工作区文件单独再备一份cp -r ~/.openclaw/workspace ~/openclaw-workspace-backup备份完确认一下目录大小别备份了个空壳du -sh ~/openclaw-backup-*5.2 第二步停止 Gateway 服务macOS 上先停 LaunchAgent因为改过名可能有好几个launchctl bootout gui/$UID/ai.openclaw.gateway 2/dev/null launchctl bootout gui/$UID/bot.molt.gateway 2/dev/null launchctl bootout gui/$UID/com.openclaw.gateway 2/dev/null pkill -f openclaw || trueLinux 上停 systemd 用户服务systemctl --user stop openclaw-gateway.service systemctl --user disable openclaw-gateway.service rm -f ~/.config/systemd/user/openclaw-gateway.service systemctl --user daemon-reload停完验证端口是否释放lsof -i :18789没有任何输出说明服务真的停了。如果还有输出回到上面重新执行停止命令。5.3 第三步优先用官方命令卸载如果openclaw命令还能用先跑官方卸载openclaw uninstall --all --yes --non-interactive如果命令已经不可用用 npx 临时调用npx -y openclaw uninstall --all --yes --non-interactive5.4 第四步手动清理残留目录官方命令不会碰历史目录这一步必须手动做rm -rf ~/.openclaw rm -rf ~/.clawdbot rm -rf ~/.moltbot rm -rf ~/.molthubmacOS 用户额外清理桌面应用和临时文件rm -rf /Applications/OpenClaw.app rm -rf /tmp/openclaw/ rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist rm -f ~/Library/LaunchAgents/com.openclaw.plist5.5 第五步卸载全局包与 Docker 资源按你当初的安装方式选对应命令npm uninstall -g openclaw pnpm remove -g openclaw bun remove -g openclawDocker 部署过的清理容器、卷、镜像docker stop openclaw docker rm openclaw docker volume rm openclaw-data docker rmi openclaw/openclaw:latest docker compose down --volumes5.6 第六步清理 Shell 配置与撤销授权打开~/.zshrc或~/.bashrc删掉所有含OPENCLAW的行比如export OPENCLAW_HOME...和 PATH 里追加的路径。保存后source ~/.zshrc生效。授权撤销是最容易被忽略的一步。本地文件删了但服务商那边的 OAuth 令牌还在。去 Google、GitHub、Slack、Discord、Notion 的授权管理页面把 OpenClaw 相关的应用移除。同时把所有曾经配在 OpenClaw 里的 API Key 全部作废重生成包括模型 Key 和云服务 Access Key。6. 验证请求用 TaoToken 通道确认残留不影响新接入清理完成后用第 4 节的配置发一条真实请求确认新通道能通同时确认没有残留进程干扰。先检查残留which openclaw ls ~/.openclaw ~/.clawdbot ~/.moltbot ~/.molthub 21 ps aux | grep -i openclaw期望结果是openclaw not found、No such file or directory、以及只有 grep 自身。然后发一条 curl 请求验证 TaoToken 通道curl -s https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: 回复 OK 两个字母}], max_tokens: 16 }如果返回里能看到正常的choices结构说明通道通了残留没有影响新工具接入。如果报连接错误先确认base_url写的是https://taotoken.net/api再确认 Key 没有多余空格。7. 本篇常见错排查报错一launchctl bootout返回No such process。说明这个服务名本来就不存在属于正常情况继续执行下一条即可不用管。报错二rm -rf ~/.openclaw提示Operation not permitted。这是 macOS 的 SIP 保护或者文件被进程占用。先pkill -f openclaw再删如果还不行检查是不是有 LaunchAgent 没停干净。报错三lsof -i :18789一直有输出。说明 Gateway 进程还在。用ps aux | grep 18789找到 PIDkill -9 PID强制结束然后再删服务文件。报错四curl 返回 401。Key 错了或者没带Bearer前缀。检查Authorization: Bearer sk-xxx格式注意 Bearer 和 Key 之间有一个空格。报错五curl 返回 404。base_url路径写错了。正确写法是https://taotoken.net/api后面接/v1/chat/completions不要重复拼/api。报错六Docker 卷删不掉。容器还在运行。先docker stop openclaw再docker rm openclaw最后删卷。8. 清理完之后新通道怎么接残留清干净了接下来就是把新工具接上 TaoToken。如果你只是偶尔对话验证模型直接用模型对话页面最省事 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。如果你要跑长期编码任务或者 Agent走 Coding Plan 更合适 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入过程中遇到参数问题查文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。需要重新生成或管理 Key去控制台 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。我自己的习惯是每次卸载完一个 Agent 类工具都会用一条 curl 打一次新通道确认环境干净、通道可用再开始装下一个。这样能避免“以为是新工具的问题其实是旧残留没清干净”这种排查半天的情况。
