1. 为什么 OpenClaw 卸载后还会“阴魂不散”很多人以为把 OpenClaw 的目录一删、进程一杀就算完事了结果过几天发现端口还被占着、终端启动时莫名报错、甚至旧 Key 还在某个配置文件里躺着。我试过在一台开发机上反复装删 OpenClaw最后用find全盘扫了一遍才发现残留远比想象中多。OpenClaw 这类本地 AI 编排工具本质上是一个“网关 插件 配置”的组合体。它为了让你少填几次参数会把 API Key、模型地址、代理端口、日志路径分散写在好几个地方用户主目录下的隐藏文件夹、系统级的 AppData、npm 全局目录、VS Code 扩展目录甚至环境变量里。你只删主程序等于只拆了门面地基还在。这篇指南面向的是曾经用 OpenClaw 做本地 AI 编排、现在想彻底清干净的开发者。核心目标有三个第一用可复制的命令把残留配置、缓存、鉴权文件全部找出来删掉第二逐项验证确认没有残留进程和端口占用第三把清理后仍然需要的模型调用能力统一收口到 TaoToken 的一套 Key 配置上避免以后再被某个工具的私有配置绑死。先说清楚“彻底清除”的判断标准不然你删到一半会心虚。判断标准是全盘搜索不到 openclaw 相关文件、没有相关进程在跑、默认端口 18789 没有被监听、环境变量里没有它的路径、IDE 扩展列表里没有它。这五条全过才算收尾完成。下面按顺序来每一步都给命令和预期结果。需要提醒的是清理前先确认你不再需要 OpenClaw 里的任何本地数据。配置文件里可能存着历史对话、自定义工作流、以及明文 API Key。如果你还想保留某些编排逻辑先把关键配置复制出来再删否则删完就找不回来了。这一步没有后悔药。2. 清理前的准备停进程、备份、确认部署方式动手删文件之前必须先停掉所有相关进程。文件被占用时删除会失败或者删了目录但进程还在内存里跑端口照样占着。这是整个流程里最容易翻车的一步。Windows 下先看进程再杀别上来就taskkill /f /im node.exe那会把你其他 Node 项目一起干掉。正确做法是先定位# Windows PowerShell查找 OpenClaw 相关进程 Get-Process | Where-Object { $_.ProcessName -match node|python } | Select-Object Id, ProcessName, Path # 找到对应 PID 后精准终止 taskkill /f /pid PIDLinux / macOS 下用模式匹配更安全# 查找并终止 OpenClaw 相关进程 pkill -f openclaw pkill -f openclaw-gateway # 确认是否还有残留 ps aux | grep -i openclaw | grep -v grep如果输出为空说明进程清干净了。如果还有记下 PID 用kill -9 PID补刀。接下来确认你的部署方式因为不同方式的清除路径完全不同。用下面这张表对照部署方式主程序位置卸载命令npm 全局安装全局 node_modulesnpm uninstall -g openclawGit 源码克隆克隆的仓库目录直接删仓库目录Docker 容器容器 镜像docker rm -fdocker rmiVS Code 扩展扩展目录code --uninstall-extension确认完部署方式再花两分钟做备份。把~/.openclawLinux/macOS或%USERPROFILE%\.openclawWindows整个目录复制到别处。里面通常有config.json、credentials.json、logs/这几样。备份完再删心里踏实。注意备份文件里如果含明文 API Key别随手丢在桌面或同步盘里。要么加密压缩要么确认不再需要后连同备份一起删掉。准备工作做完下面进入正式清理。顺序是先删主程序再删配置和数据最后清环境变量和扩展。这个顺序能避免“程序还在但配置没了”导致的报错干扰判断。3. 可复制的残留清理清单目录、配置、环境变量这一节是全文的核心操作区命令都可以直接复制。我按“主程序 → 配置数据 → 环境变量 → 扩展 → 端口”的顺序排你照着走一遍基本能清干净。3.1 删除主程序# npm 全局安装的情况 npm uninstall -g openclaw # 确认全局目录里没有残留 npm ls -g --depth0 | grep -i openclaw # Git 源码部署删掉克隆目录 rm -rf ~/openclaw rm -rf /path/to/your/openclaw-repo # Docker 部署容器和镜像都要删 docker stop openclaw-container docker rm openclaw-container docker rmi openclaw-image docker images | grep -i openclaw最后一条docker images如果没输出说明镜像也清掉了。3.2 删除配置和数据目录这是残留最多的地方Windows 和 Linux/macOS 路径不同分开列# Linux / macOS rm -rf ~/.openclaw rm -rf ~/.config/OpenClaw rm -rf ~/.cache/openclaw rm -rf /tmp/openclaw-* # WindowsPowerShell Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw Remove-Item -Recurse -Force $env:APPDATA\OpenClaw Remove-Item -Recurse -Force $env:LOCALAPPDATA\OpenClaw删完做一次全盘搜索确认没有漏网# Linux / macOS 全盘搜索 find / -iname *openclaw* 2/dev/null find / -iname *claw* -type d 2/dev/null # Windows PowerShell 搜索用户目录 Get-ChildItem -Path $env:USERPROFILE -Recurse -Filter *openclaw* -ErrorAction SilentlyContinue搜索时注意排除你备份的目录否则会误报。如果搜出来的都是备份文件说明系统里已经干净了。3.3 清理环境变量OpenClaw 可能往 PATH 或自定义变量里写过东西。检查一下# Linux / macOS echo $PATH | tr : \n | grep -i openclaw grep -i openclaw ~/.bashrc ~/.zshrc ~/.profile 2/dev/null # Windows PowerShell $env:Path -split ; | Select-String -Pattern openclaw [Environment]::GetEnvironmentVariable(OPENCLAW_HOME, User)如果grep或Select-String有输出手动编辑对应文件把那行删掉。Windows 用户变量在“系统属性 → 环境变量”里改改完重启终端生效。3.4 清理 IDE 扩展# VS Code 卸载扩展 code --uninstall-extension openclaw.vscode-openclaw # 手动清理扩展残留目录 rm -rf ~/.vscode/extensions/openclaw* rm -rf ~/.vscode/extensions/*.openclaw-*卸载完在 VS Code 里按CtrlShiftX打开扩展面板搜 openclaw确认列表为空。3.5 释放端口占用OpenClaw 默认用 18789 端口检查是否还被占# Windows netstat -ano | findstr :18789 # Linux / macOS lsof -i :18789如果有输出记下 PID 回到 3.1 的进程终止步骤处理。端口释放后防火墙规则也顺手清一下# Windows 删除防火墙规则 netsh advfirewall firewall delete rule nameOpenClaw # Linux sudo ufw delete deny 18789到这里文件系统和系统配置层面的清理就完成了。下一节做逐项验证确认真的没有残留。4. 逐项验证确认无残留、无报错清理完不验证等于没清。这一节给一套可复制的验证脚本跑完看到全绿才算收工。4.1 文件残留验证#!/bin/bash echo 检查主程序 ls -la ~/.openclaw 2/dev/null echo 残留配置目录还在 || echo OK配置目录已删除 echo 检查全局 npm 包 npm ls -g --depth0 2/dev/null | grep -i openclaw echo 残留npm 包还在 || echo OKnpm 包已删除 echo 全盘搜索 find ~ -iname *openclaw* 2/dev/null | grep -v backup echo 残留发现文件 || echo OK无残留文件Windows 用户把对应命令换成 PowerShell 版本即可逻辑一样。4.2 进程和端口验证echo 检查进程 ps aux | grep -i openclaw | grep -v grep echo 残留进程还在 || echo OK无相关进程 echo 检查端口 lsof -i :18789 2/dev/null echo 残留端口被占 || echo OK端口已释放4.3 环境变量验证echo 检查环境变量 env | grep -i openclaw echo 残留环境变量还在 || echo OK无相关环境变量4.4 验证结果对照表检查项通过标准不通过怎么办配置目录不存在回到 3.2 重删npm 全局包列表无 openclaw重新npm uninstall -g进程ps无输出回到 3.1 杀进程端口 18789无监听查 PID 后终止环境变量env无匹配编辑 shell 配置文件全部通过后重启一次终端再跑一遍ps aux | grep -i openclaw确认重启后也没有自启进程。有些工具会写 systemd 服务或 launchd plist顺手检查一下# Linux systemctl list-units | grep -i openclaw # macOS launchctl list | grep -i openclaw有输出就systemctl disable或launchctl unload掉。5. 常见报错排查401、local proxy failed、OAuth 残留清理过程中或清理后你可能会撞上几个典型报错。这一节按真实报错逐个拆。5.1 401 Unauthorized这个报错通常出现在你清理完 OpenClaw、但某个残留客户端还在用旧 Key 发请求时。旧 Key 可能已经被你在服务端吊销或者配置文件删了但进程缓存还在。排查步骤先确认请求是从哪个进程发出的用lsof -i看连接再检查是否还有残留的credentials.json或环境变量里的OPENCLAW_API_KEY。删掉后重启终端。如果你打算把模型调用统一收口到 TaoToken401 的根治办法是换一套干净的 Key。到 TaoToken 控制台重新生成一个别复用旧的。5.2 local proxy failed这个报错说明有客户端还在尝试连本地代理端口通常是 18789 或类似但 OpenClaw 已经被你删了代理自然起不来。解决办法是找到那个还在配本地代理的客户端把它的 Base URL 改成直连。比如你之前配的是http://127.0.0.1:18789/v1现在要改成 TaoToken 的 API 地址https://taotoken.net/api。改完重启客户端。5.3 OAuth 相关报错OpenClaw 如果接过 OAuth 登录会在本地留 token 缓存。删了主程序但缓存还在客户端启动时会尝试刷新 token 然后失败。清理 OAuth 缓存的位置# 常见 OAuth token 缓存位置 rm -rf ~/.openclaw/oauth* rm -rf ~/.config/openclaw/tokens* rm -rf ~/.cache/openclaw/auth*清完在客户端里重新走一次授权或者直接改用 API Key 方式省掉 OAuth 这一层。5.4 报错对照速查报错根因处理401 Unauthorized旧 Key 残留删配置 换新 Keylocal proxy failed本地代理已删但客户端还配着改 Base URL 为直连OAuth token invalidtoken 缓存残留清 oauth 缓存目录port already in use进程没杀干净查 PID 后终止排查时记住一个原则报错信息里的路径和端口就是你下一步要检查的地方。别急着搜通用答案先看它指向哪个文件。6. 收口到 TaoToken一套 Key 管住所有模型调用清理完 OpenClaw你手里可能还有好几个客户端要调模型VS Code 里的编码插件、命令行工具、自己写的小脚本。与其每个都配一遍 Key不如统一收口到 TaoToken 的一套配置。6.1 获取 Key 和 Base URL先到 TaoToken 控制台生成 API Key。地址是https://taotoken.net/console登录后在 API Keys 页面创建。生成后复制保存页面关了就看不到了。Base URL 统一用https://taotoken.net/api注意不要加 UTM 参数那是给官网链接用的API 地址保持干净。6.2 统一配置示例不同客户端的配置格式不一样但核心三件套是一样的Base URL、API Key、Model ID。下面给几个常见格式。通用 JSON 配置很多工具都吃这套{ base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: claude-sonnet-4-5, timeout: 60 }如果你用 Claude Code 这类工具配置写在 settings 里{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-5 } }Codex 的auth.json格式{ base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: gpt-5 }Cline / MCP 类工具在设置里填三项API Provider 选 OpenAI CompatibleBase URL 填https://taotoken.net/apiAPI Key 填你的 KeyModel ID 填具体模型名。6.3 验证配置是否生效配完别急着用先发一个最小请求验证curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 回复 OK 两个字母}] }返回里能看到choices字段和内容说明 Key 和 Base URL 都对。如果返回 401检查 Key 有没有复制全如果返回 model not found检查 Model ID 拼写。6.4 为什么建议收口收口到一套 Key 的好处很直接以后换工具不用重新配删工具也不用担心 Key 散落各处。OpenClaw 这次清理之所以麻烦就是因为它的配置分散在五六个位置。统一用 TaoToken 之后你只需要管一个 Key、一个 Base URL清理时也只需要删一处。如果你长期做编码或 Agent 类任务可以考虑 TaoToken 的 Coding Plan额度更划算。只是偶尔验证模型效果用模型对话页面就够了。接入文档在https://taotoken.net/doc里面有各客户端的详细配置步骤。6.5 收尾检查最后确认三件事第一OpenClaw 的残留已经按第 4 节验证全过第二新配的 TaoToken Key 能正常发请求第三旧 Key 如果还在任何地方去服务端吊销掉。这三件做完这次清理才算真正收尾。以后再装任何本地 AI 工具建议一开始就把模型调用指向统一的 Base URL别让每个工具自己存一份 Key。这样下次卸载时你只需要删工具本身不用再满盘找配置。