1. 为什么 OpenClaw 卸载后还会“阴魂不散”OpenClaw 是一款面向自动化任务与本地 Agent 调度的工具安装后会在系统里注册常驻服务、写入多份配置文件、缓存模型通道信息还会在 PATH 里塞进命令行入口。它适合做本地任务编排、定时抓取、以及把外部模型 API 接进工作流的人。但正因为组件多很多人直接删掉安装目录结果发现开机还是慢、端口还被占、终端里敲openclaw居然还能跑。我试过在一台 Windows 机器上只删了Program Files目录重启后Get-Service里依然能看到OpenClawAgent在跑原因就是服务注册项和ProgramData下的配置没动。更隐蔽的是 API 通道残留OpenClaw 会把模型接入信息写进settings.json或config.toml如果你之前用统一 Key 接过多家模型这些字段会留在用户目录里后续装别的 AI 工具时可能读到旧配置出现“明明换了 Key 却还报鉴权失败”的怪现象。所以这篇教程的目标很明确三端完整卸载 配置残留排查 用 TaoToken 统一 Key/API 通道重建一份干净的配置骨架确保卸载干净的同时后续 AI 工具接入不受影响。下面按平台给可复制命令最后统一验证。2. 卸载前先接好 TaoToken 统一通道卸载 OpenClaw 不代表你不用 AI 工具了恰恰相反很多人卸载是为了换更轻量的接入方式。这里建议先把 TaoToken 的 API 通道准备好这样清理完旧配置后能立刻验证新通道是否正常。TaoToken 是一个模型 API 聚合接入服务把多家模型的调用统一到一个 Key 和一套 OpenAI 兼容接口上适合需要频繁切换模型、又不想每个平台单独维护 Key 的开发者。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台创建 Key 即可。具体动作分三步。第一打开控制台页面 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 登录后进入 API Keys 管理页 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 新建一个 Key 并复制保存。第二记下 API 基地址统一用 https://taotoken.net/api 注意这个地址不带任何查询参数配置时直接填。第三如果你想先确认模型能不能通可以去模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 发一条测试消息确认 Key 有效再往下走。注意Key 只在创建时完整显示一次建议存进密码管理器。卸载 OpenClaw 时如果旧配置里也有 Key记得一并清理避免两套凭证混用。对于长期做编码或 Agent 任务的可以了解 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。这些先备着等清理完系统再回来配。3. Windows 平台完整卸载与残留清理Windows 的坑最多因为服务、注册表、环境变量三处都可能留东西。按顺序来别跳步。3.1 停止服务与进程以管理员身份打开 PowerShell先停服务再删文件否则文件被占用删不掉。net stop OpenClaw net stop OpenClawAgent net stop ClawScheduler tasklist | findstr /i openclaw tasklist | findstr /i claw如果net stop报服务名无效说明服务已经不在继续下一步即可。若tasklist还有输出用taskkill /PID 进程号 /F强制结束。3.2 卸载程序本体优先走官方卸载入口比手删干净.\OpenClaw-Setup.exe /uninstall /quiet找不到安装包就去「控制面板 → 程序和功能」里右键卸载。这一步会移除主程序但配置和缓存通常保留。3.3 删除残留目录Remove-Item -Recurse -Force C:\Program Files\OpenClaw -ErrorAction SilentlyContinue Remove-Item -Recurse -Force C:\ProgramData\OpenClaw -ErrorAction SilentlyContinue Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw -ErrorAction SilentlyContinue Remove-Item -Recurse -Force $env:LOCALAPPDATA\OpenClaw -ErrorAction SilentlyContinue Remove-Item -Recurse -Force $env:APPDATA\OpenClaw -ErrorAction SilentlyContinue-ErrorAction SilentlyContinue是为了目录不存在时不中断脚本适合一次性粘贴执行。3.4 清理注册表与服务注册reg delete HKLM\SOFTWARE\OpenClaw /f reg delete HKLM\SOFTWARE\WOW6432Node\OpenClaw /f reg delete HKCU\SOFTWARE\OpenClaw /f sc delete OpenClaw sc delete OpenClawAgent注册表操作前建议先reg export备份对应项。sc delete对已删除的服务会报错忽略即可。3.5 清理 PATH 环境变量OpenClaw 会把bin目录加进 PATH残留会导致终端提示命令找不到但 PATH 里还挂着空目录$old [Environment]::GetEnvironmentVariable(Path, Machine) $new ($old -split ; | Where-Object { $_ -notlike *OpenClaw* }) -join ; [Environment]::SetEnvironmentVariable(Path, $new, Machine)改完要重开终端才生效。用户级 PATH 同理把Machine换成User再跑一次。4. macOS 平台完整卸载与残留清理macOS 的重点是 LaunchDaemon/LaunchAgent 和~/Library下的隐藏配置。4.1 停止并卸载守护进程sudo launchctl unload /Library/LaunchDaemons/com.openclaw.daemon.plist 2/dev/null sudo launchctl unload /Library/LaunchAgents/com.openclaw.agent.plist 2/dev/null sudo pkill -f openclaw sudo pkill -f claw-agentlaunchctl unload对不存在的 plist 会报错加2/dev/null静默掉。4.2 删除应用与命令行工具sudo rm -rf /Applications/OpenClaw.app sudo rm -f /usr/local/bin/openclaw sudo rm -f /usr/local/bin/clawctl如果是 Homebrew 装的用brew uninstall openclaw brew cleanup更规范。4.3 清理系统级与用户级配置sudo rm -rf /etc/openclaw sudo rm -rf /Library/Application Support/OpenClaw sudo rm -f /Library/LaunchDaemons/com.openclaw.* sudo rm -f /Library/LaunchAgents/com.openclaw.* rm -rf ~/.openclaw rm -rf ~/Library/Application\ Support/OpenClaw rm -rf ~/Library/Caches/com.openclaw rm -rf ~/Library/Logs/OpenClaw rm -rf ~/Library/Preferences/com.openclaw.plist~/Library下的目录是残留重灾区尤其是Application Support和Caches很多人只删了~/.openclaw就以为干净了。4.4 验证 LaunchAgent 是否清空launchctl list | grep -i claw没有输出才算干净。如果还有条目说明 plist 没删全回到 4.3 检查。5. Linux 平台完整卸载与残留清理Linux 分发行版处理包管理服务文件要单独删。5.1 停止并禁用服务sudo systemctl stop openclaw openclaw-agent 2/dev/null sudo systemctl disable openclaw openclaw-agent 2/dev/null旧版 SysVinit 系统用sudo service openclaw stop sudo update-rc.d openclaw remove5.2 按发行版卸载软件包# Debian / Ubuntu sudo apt-get remove --purge openclaw -y sudo apt-get autoremove -y # RHEL / CentOS / Fedora sudo dnf remove openclaw -y # Arch sudo pacman -Rns openclaw--purge会连配置一起删比默认 remove 干净。5.3 删除残留文件与服务单元sudo rm -rf /opt/openclaw /usr/share/openclaw /etc/openclaw /var/log/openclaw rm -rf ~/.openclaw ~/.config/openclaw ~/.cache/openclaw sudo rm -f /etc/systemd/system/openclaw* sudo rm -f /usr/lib/systemd/system/openclaw* sudo systemctl daemon-reloaddaemon-reload必须执行否则 systemd 还缓存着已删单元。5.4 清理 Docker 与网络残留如果 OpenClaw 跑在容器里docker stop openclaw 2/dev/null docker rm openclaw 2/dev/null docker rmi openclaw/openclaw:latest 2/dev/null docker volume rm openclaw_data 2/dev/null检查虚拟网卡ip link show | grep -i claw sudo ip link delete claw0 2/dev/null6. 配置残留排查与 TaoToken 通道重建卸载干净后重点来了确认旧配置没留再用 TaoToken 重建一份干净通道。6.1 全局搜索残留关键字三端通用思路是搜openclaw和claw# macOS / Linux grep -ri openclaw ~/.config ~/.openclaw 2/dev/null find / -iname *openclaw* 2/dev/null | head -50# Windows Get-ChildItem -Path C:\ -Filter *openclaw* -Recurse -ErrorAction SilentlyContinue重点看settings.json和config.toml里有没有旧的api_base、api_key字段。6.2 用 settings.json 重建通道如果你后续工具读 JSON 配置骨架如下{ api_base: https://taotoken.net/api, api_key: 你的_TaoToken_Key, model: gpt-4o-mini, timeout: 60 }api_base固定填https://taotoken.net/api不要带斜杠结尾也不要加查询参数。6.3 用 config.toml 重建通道读 TOML 的工具用这份[provider] name taotoken api_base https://taotoken.net/api api_key 你的_TaoToken_Key [model] default gpt-4o-mini timeout 60两份配置二选一即可取决于你的工具读哪种格式。Key 建议用环境变量注入别硬编码进仓库。6.4 验证请求是否打通用 curl 发一条最小请求curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer 你的_TaoToken_Key \ -H Content-Type: application/json \ -d {model:gpt-4o-mini,messages:[{role:user,content:ping}]}返回带choices字段的 JSON 就说明通道正常。如果报 401检查 Key 是否复制完整报 404检查api_base是否写成了带路径的地址。7. 本篇常见错误排查卸载后终端还能敲出 openclaw 命令PATH 没清干净回到 3.5 或检查/usr/local/bin下的软链。Windows 删目录提示“文件正在使用”服务没停先net stop再删或重启后删。macOS 重启后服务又起来LaunchDaemon plist 没删launchctl list | grep claw确认后删 plist 再unload。Linuxsystemctl报 Unit not found 但进程还在可能是用户级 systemd 服务用systemctl --user stop openclaw再处理。配置里旧 Key 导致新工具鉴权失败全局搜api_key字段把旧值替换成 TaoToken 的 Key或直接删掉旧配置文件重建。curl 验证返回 403Key 权限或额度问题去控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 检查 Key 状态和余额。模型名报 not found不同工具对模型名大小写敏感去模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 确认可用模型名再填。8. 清理完继续用 TaoToken 接入卸载 OpenClaw 只是换工具链的一步真正省事的是把模型接入统一到一套 Key 和一套 API 地址上。清理完系统后按你的使用场景选入口需要排障和接入细节的直接去 API Keys 页 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 建 Key再对照接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 配置想先验证模型效果的去模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 发消息长期跑编码或 Agent 任务的看 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后提醒一句卸载脚本跑完后务必用第 6 节的全局搜索再扫一遍确认settings.json和config.toml里没有旧通道残留再写入 TaoToken 的新配置。这样系统干净后续接入也不会被历史配置干扰。
