1. 为什么 OpenClaw 卸载总留尾巴OpenClaw 是一个基于 Node 生态的 Agent 网关工具通过 npm 全局安装后会在系统里留下至少四类痕迹全局 CLI 软链、~/.openclaw工作目录、常驻的 Gateway 服务进程以及散落在settings.json、config.toml里的模型通道配置。很多人卸载时只跑了npm uninstall -g openclaw结果重装后发现旧配置还在、端口还被占用、systemd 服务还在后台自启甚至换机器后环境无法复现。这篇面向三类人想彻底重装换干净环境的、换机器不想带残留的、以及在不同系统上都装过想统一清理的。我会按 Ubuntu、macOS、Windows含 WSL分别给出可复制的卸载命令、残留目录排查清单并顺带把 TaoToken 统一 Key/API 通道在settings.json与config.toml中的配置骨架和验证动作讲清楚——因为卸载后如果你还要继续用同类工具配置通道的清理和重建是绕不开的一步。核心思路就三步停服务、卸全局包、删工作目录。但每一步在不同系统上的坑不一样下面逐个拆。2. 卸载前先搞清楚你装了哪些东西不管哪个平台只要是通过 Node/npm 装的 OpenClaw通常包含这几块全局 CLI 命令一般来自npm install -g openclaw卸载对应npm uninstall -g openclaw。工作目录与配置默认在 Home 下的~/.openclaw里面有workspace/Agent 配置、记忆文件、日志和缓存。系统服务方面Ubuntu 常见是 systemd 的openclaw-gateway.servicemacOS 可能是 launchd 或手动用 tmux/screen 起的进程Windows 可能通过 PowerShell、计划任务或 pm2 常驻。注意如果你之前配置过 TaoToken 这类统一通道配置可能写在~/.openclaw/settings.json或项目里的config.toml卸载时这两处都要检查否则重装后旧 Key 会干扰新环境。先做一次全局体检确认自己到底装了什么# Linux / macOS which openclaw npm ls -g --depth0 | grep -i openclaw ls -la ~/.openclaw# Windows PowerShell where.exe openclaw npm ls -g --depth0 | Select-String openclaw Test-Path $env:USERPROFILE\.openclaw这几条命令的输出决定了你后面要清理的范围。如果which openclaw有输出但npm ls -g里没有说明可能是手动软链或别的包管理器装的得单独处理。3. TaoToken 前置统一 Key 与 API 通道卸载 OpenClaw 后如果你还要继续跑 Agent 或编码类工具建议把模型通道统一到 TaoToken这样换工具时只改一处配置。TaoToken 提供统一的 API 入口兼容 OpenAI 风格的调用方式适合在settings.json和config.toml里做统一配置。官网入口在这里https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基础地址是https://taotoken.net/api这个地址不加 UTM 参数直接用于配置。你需要先在控制台创建 Key然后把它写进配置文件。控制台地址https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteKey 管理页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite如果你主要做长期编码或 Agent 任务可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite想先验证模型是否通用模型对话页面https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewriteClaude Code 相关接入参考https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite拿到 Key 后配置骨架长这样。settings.json用于 JSON 类工具{ api_base: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: claude-sonnet-4-20250514, timeout: 60 }config.toml用于 TOML 类工具[provider] base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model claude-sonnet-4-20250514 [gateway] timeout 60 retry 2提示Key 不要提交到 Git建议用环境变量TAOTOKEN_API_KEY注入配置文件里只留占位符。4. Ubuntu 下彻底卸载 OpenClaw4.1 停止 Gateway 与 systemd 服务先尝试优雅停止openclaw gateway stop如果命令已经不可用直接查 systemdsystemctl list-units | grep openclaw看到openclaw-gateway.service loaded active running就停掉并禁用sudo systemctl stop openclaw-gateway.service sudo systemctl disable openclaw-gateway.service sudo rm /etc/systemd/system/openclaw-gateway.service sudo systemctl daemon-reload如果你自定义过服务名比如ai-gateway.service里跑的 OpenClaw用对应名字替换。删掉 unit 文件后一定要daemon-reload否则 systemd 还缓存着旧定义。4.2 卸载 npm 全局包npm uninstall -g openclaw用 pnpm 或 yarn 的话pnpm remove -g openclaw # 或 yarn global remove openclaw确认卸载which openclaw # 应无输出或提示 not found4.3 删除配置与工作目录# 先备份再删稳妥 cp -r ~/.openclaw ~/openclaw-backup rm -rf ~/.openclaw顺手清 npm 缓存可选npm cache clean --force4.4 检查残留端口与进程ss -tlnp | grep -E 3000|8080|18789 ps aux | grep -i openclaw | grep -v grep如果还有进程占着端口用kill -9 PID清掉。这一步很多人漏掉导致重装时端口冲突。5. macOS 下卸载 OpenClaw含 .app5.1 停止 Gateway 或桌面应用命令行启动的openclaw gateway stop用 OpenClaw.app 的从菜单栏图标选「Quit / 退出」。用 tmux/screen/pm2 起的先停对应会话pm2 stop openclaw pm2 delete openclaw5.2 卸载 npm 全局包npm uninstall -g openclaw # 或 pnpm remove -g openclaw yarn global remove openclaw检查which openclaw5.3 删除配置目录与 .appcp -r ~/.openclaw ~/openclaw-backup rm -rf ~/.openclawGUI 应用单独处理打开 Finder → 应用程序 → 找到 OpenClaw.app → 拖到废纸篓。注意这一步不会碰~/.openclaw所以必须结合上一步一起做。5.4 检查 launchd 与登录项launchctl list | grep -i openclaw ls ~/Library/LaunchAgents | grep -i openclaw有的话卸载launchctl unload ~/Library/LaunchAgents/com.openclaw.gateway.plist rm ~/Library/LaunchAgents/com.openclaw.gateway.plist再去「系统设置 → 通用 → 登录项」里确认没有 OpenClaw 相关条目。6. Windows 与 WSL 下卸载 OpenClaw6.1 纯 Windows 环境先停进程。pm2 方式pm2 stop openclaw pm2 delete openclaw计划任务或服务方式在「任务计划程序」或「服务」里禁用并删除。卸载全局包npm uninstall -g openclaw # 或 pnpm remove -g openclaw yarn global remove openclaw检查可能需要重开终端where.exe openclaw删配置目录# 先备份 Copy-Item $env:USERPROFILE\.openclaw $env:USERPROFILE\openclaw-backup -Recurse # 再删 Remove-Item $env:USERPROFILE\.openclaw -Recurse -Force也可以在资源管理器地址栏输入%USERPROFILE%\.openclaw直接定位。6.2 WSL 内安装的情况WSL 里的卸载和 Ubuntu 那节完全一致在 WSL 终端里操作openclaw gateway stop npm uninstall -g openclaw rm -rf ~/.openclaw如果 WSL 里也配了 systemd 或 pm2一并停掉。注意 WSL 的 Home 和 Windows 的%USERPROFILE%是两套路径别只清一边。6.3 清理环境变量Windows 上如果设过OPENCLAW_HOME之类的变量去「系统属性 → 环境变量」里删掉。WSL 里检查~/.bashrc、~/.zshrc有没有相关 exportgrep -i openclaw ~/.bashrc ~/.zshrc有就手动删掉对应行。7. 验证请求与卸载成功结果卸载完做三步自检。命令是否消失# Linux / macOS which openclaw # Windows where.exe openclaw配置目录是否删除ls ~/.openclaw # 应提示 No such file or directory服务是否还在跑# Ubuntu systemctl list-units | grep openclaw # macOS launchctl list | grep -i openclaw # Windows Get-Process | Where-Object {$_.ProcessName -like *openclaw*}三项都干净说明卸载彻底。如果你卸载后要重建 TaoToken 通道用 curl 验证配置是否生效curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: ping}] }返回正常 JSON 且带choices字段说明 Key 和通道都通了。如果返回 401检查 Key 是否复制完整返回 404检查base_url是否漏了/api。8. 本篇常见错排查卸载后which openclaw还有输出多半是 npm 全局 bin 目录没刷新或者你用的是 nvm 管理的 Node切换版本后旧软链还在。检查npm bin -g指向的目录手动删掉残留的openclaw软链。~/.openclaw删了但重装后配置还在说明配置不止一处。检查项目目录下的config.toml、settings.json以及~/.config/openclaw/这类 XDG 路径。systemd 服务删了 unit 文件还在自启忘了systemctl daemon-reload或者 unit 文件在/lib/systemd/system/而不是/etc/systemd/system/。两个路径都查一下。Windows 上where openclaw报错但 npm 说卸载成功PATH 缓存问题重开一个 PowerShell 窗口再试。还不行就检查%APPDATA%\npm目录下有没有残留。WSL 和 Windows 双份残留这是最常见的坑。WSL 里装过一次、Windows 里又装过一次两边的~/.openclaw和%USERPROFILE%\.openclaw都要清服务也要分别停。TaoToken 配置报 401Key 里可能混入了空格或换行重新从控制台复制。如果用的是环境变量注入确认echo $TAOTOKEN_API_KEY输出正常。端口被占用导致重装失败卸载后ss -tlnp | grep 18789查一下有残留进程直接 kill。macOS 用lsof -i :18789。9. 卸载后重建干净环境如果你这次卸载是为了重装建议顺序是先按上面步骤清到三步自检全过再重新安装。重装前确认 Node 版本符合要求然后npm install -g openclaw首次启动前把 TaoToken 通道配好。settings.json和config.toml的骨架在第 3 节Key 从控制台拿https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite配置完先跑一次验证请求确认通道通了再启动 Gateway。这样即使出问题也能快速定位是配置问题还是工具问题。长期跑编码或 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整个流程走下来核心就一句话停服务、卸包、删目录、验通道。四个动作在三个平台上路径不同但逻辑一致照着对应章节敲命令就行。
