1. 卸载 OpenClaw 后残留服务与配置文件为什么必须手动清理

OpenClaw 这类本地 Agent 工具在安装时通常会做三件事：注册后台服务、写入用户级配置、在项目目录里生成运行时数据。卸载程序往往只删掉主程序目录，服务注册项、~/.config下的配置、日志和 SQLite 数据库会原样留下。这些残留最直接的后果是：重新安装时旧配置被读取，出现端口占用、鉴权失败、模型列表读不出来等奇怪问题。

我试过在一台 macOS 上重装 OpenClaw，结果新版本一直报local proxy failed，排查半小时才发现是旧的 LaunchAgent 还在跑，占着本地端口。所以清理残留不是洁癖，而是保证环境可复用的必要步骤。

这篇内容面向三类人：刚卸载 OpenClaw 想彻底清干净的开发者、准备重装但被旧配置干扰的用户、以及需要把 OpenClaw 换成 TaoToken 做模型接入的团队。核心检索词就是「OpenClaw 残留服务与配置文件手动清理」，覆盖 Linux、macOS、Windows 三平台，每一步都给可复制的命令和路径清单。

清理的目标很明确：服务停掉并删除、配置文件删干净、环境变量摘掉、数据库和日志清空，最后用检测脚本验证没有残留进程和文件。整个过程不需要重装系统，也不需要第三方清理工具，手敲命令就能完成。

需要提前说明的是，OpenClaw 的安装路径和配置目录会因安装方式不同而有差异。npm 全局安装、二进制安装、Docker 安装三种方式留下的残留位置不一样。下面给的路径是常见默认值，如果你改过OPENCLAW_HOME或安装到自定义目录，把命令里的路径替换成你自己的即可。清理前建议先备份~/.config/openclaw里的配置，万一里面有你还想保留的模型参数或 API Key 记录。

另外，清理残留和接入 TaoToken 是两件独立的事。TaoToken 是模型接入层，提供兼容 OpenAI 的 API 端点，OpenClaw 只是调用方之一。把 OpenClaw 清干净之后，你可以用任何兼容 OpenAI 协议的工具重新接入，包括 OpenClaw 本身、Cline、Codex CLI 等。所以这篇的清理流程对「换工具」和「重装同工具」两种场景都适用。

2. TaoToken 前置准备：清理后重新接入需要哪些信息

清理完 OpenClaw 残留后，如果你打算重新接入模型服务，需要先准备好三样东西：Base URL、API Key、Model ID。这三件套是任何兼容 OpenAI 协议的客户端都需要的。TaoToken 的 API 端点是https://taotoken.net/api，注意这个地址不带任何查询参数，直接作为 Base URL 使用。

API Key 需要到控制台创建。打开https://taotoken.net/console，登录后在 API Keys 页面新建一个 Key，复制出来保存好。这个 Key 只在创建时显示一次，关掉页面就看不到了。如果你之前清理 OpenClaw 时把旧 Key 也删了，这里重新建一个即可。

Model ID 取决于你要用哪个模型。TaoToken 支持多种模型，具体列表可以在模型对话页面查看，或者直接调/v1/models接口拉取。常见的比如claude-sonnet-4-20250514、gpt-4o这类。写配置时 Model ID 要和实际调用的模型名一致，写错了会报model not found。

这里要强调一个容易踩的坑：Base URL 的写法。很多客户端要求 Base URL 以/v1结尾，但 TaoToken 的端点设计是https://taotoken.net/api作为根，具体路径由客户端拼接。如果你在配置里写成https://taotoken.net/api/v1，有些客户端会拼成/api/v1/v1/chat/completions导致 404。正确做法是看客户端文档，通常填https://taotoken.net/api即可，客户端会自动补/v1/chat/completions。

如果你用的是 Claude Code 这类工具，它有自己的配置格式。Claude Code 通过~/.claude/settings.json或环境变量读取配置，需要设置ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY。TaoToken 提供 Anthropic 兼容端点，具体配置可以参考接入文档。文档地址在https://taotoken.net/doc，里面有各客户端的详细配置示例。

对于长期做编码或 Agent 任务的场景，可以考虑 Coding Plan，它针对高频调用做了额度优化。入口在https://taotoken.net/coding-plan。如果你只是偶尔验证模型效果，用模型对话页面直接测试就行，不需要写配置。

准备好这三件套之后，无论你用哪个客户端，配置逻辑都是一样的：Base URL 填 TaoToken 端点，API Key 填刚创建的 Key，Model ID 填你要用的模型。下面第三节会给出具体的配置文件片段。

3. 三平台可复制配置：服务停止、文件删除与 settings 片段

这一节是操作核心，按平台给出可复制的命令和配置片段。所有命令都假设你有管理员或 sudo 权限。执行前建议先关掉所有 OpenClaw 相关窗口和终端。

3.1 Linux 平台清理命令

Linux 下 OpenClaw 通常以 systemd 服务运行。先停止并禁用服务：

sudo systemctl stop openclaw sudo systemctl disable openclaw sudo rm -f /etc/systemd/system/openclaw.service sudo systemctl daemon-reload sudo systemctl reset-failed

如果服务名不是openclaw，用systemctl list-units --type=service | grep -i claw查找实际名称。删除服务文件后必须执行daemon-reload，否则 systemd 还缓存着旧单元。

清理配置和日志：

sudo rm -rf /etc/openclaw rm -rf ~/.config/openclaw sudo rm -rf /var/log/openclaw sudo rm -rf /opt/openclaw

环境变量清理，编辑~/.bashrc或~/.zshrc，删掉包含OPENCLAW的行：

sed -i '/OPENCLAW/d' ~/.bashrc sed -i '/OPENCLAW/d' ~/.zshrc source ~/.bashrc

npm 全局包和缓存：

npm uninstall -g openclaw npm cache clean --force

3.2 macOS 平台清理命令

macOS 下 OpenClaw 用 LaunchAgent 管理。先停止并卸载：

launchctl stop com.openclaw launchctl unload ~/Library/LaunchAgents/com.openclaw.plist rm -f ~/Library/LaunchAgents/com.openclaw.plist

如果 plist 在/Library/LaunchDaemons/下，需要 sudo：

sudo launchctl unload /Library/LaunchDaemons/com.openclaw.plist sudo rm -f /Library/LaunchDaemons/com.openclaw.plist

清理配置、支持文件、日志和缓存：

rm -rf ~/.config/openclaw rm -rf ~/Library/Application\ Support/OpenClaw rm -rf ~/Library/Logs/OpenClaw rm -rf ~/Library/Caches/OpenClaw rm -rf ~/OpenClaw

查找并删除其他残留文件：

find ~ -iname "*openclaw*" -type f -print find ~ -iname "*openclaw*" -type d -print

先-print确认列表，没问题再把-print换成-delete。直接 delete 有误删风险。

3.3 Windows 平台清理命令

Windows 下服务用sc管理。以管理员身份打开 CMD：

sc stop OpenClaw sc delete OpenClaw

如果提示服务不存在，说明服务名不对，用sc query type= service state= all | findstr /i claw查找。

删除配置目录：

rmdir /s /q "%APPDATA%\OpenClaw" rmdir /s /q "%LOCALAPPDATA%\OpenClaw" rmdir /s /q "%PROGRAMDATA%\OpenClaw"

注册表清理，用 reg 命令删除：

reg delete "HKCU\Software\OpenClaw" /f reg delete "HKLM\SOFTWARE\OpenClaw" /f reg delete "HKLM\SYSTEM\CurrentControlSet\Services\OpenClaw" /f

环境变量清理：

reg delete "HKCU\Environment" /v OPENCLAW_HOME /f

任务计划清理：

schtasks /query /fo LIST | findstr /i claw schtasks /delete /tn "OpenClaw" /f

3.4 清理后重新接入的 settings 片段

清理完成后，如果你要重新接入 TaoToken，以 Cline 为例，它的 MCP 配置在cline_mcp_settings.json中。一个标准的接入片段如下：

{ "mcpServers": { "taotoken": { "command": "npx", "args": ["-y", "@taotoken/mcp-server"], "env": { "TAOTOKEN_BASE_URL": "https://taotoken.net/api", "TAOTOKEN_API_KEY": "sk-你的Key", "TAOTOKEN_MODEL": "claude-sonnet-4-20250514" } } } }

如果你用 Codex CLI，配置在~/.codex/auth.json：

{ "base_url": "https://taotoken.net/api", "api_key": "sk-你的Key", "model": "gpt-4o" }

Claude Code 的配置在~/.claude/settings.json：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-你的Key", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" } }

注意三件套必须齐全：Base URL、Key、Model ID。少任何一个都会报错。Base URL 统一用https://taotoken.net/api，不要加/v1后缀，除非客户端文档明确要求。

4. 验证请求与成功结果：确认清理干净且接入可用

清理完成后要做两轮验证：第一轮确认残留清干净了，第二轮确认新接入能跑通。

4.1 残留检测脚本

Linux/macOS 下可以用一段脚本一次性检查服务、进程、文件和端口：

#!/bin/bash echo "=== 检查 systemd/launchd 服务 ===" systemctl list-units --type=service 2>/dev/null | grep -i claw launchctl list 2>/dev/null | grep -i claw echo "=== 检查进程 ===" ps aux | grep -i claw | grep -v grep echo "=== 检查文件 ===" find ~ -iname "*openclaw*" 2>/dev/null | head -20 ls -la /etc/openclaw 2>/dev/null ls -la /opt/openclaw 2>/dev/null echo "=== 检查端口占用 ===" lsof -i :3000 2>/dev/null | grep -i claw lsof -i :8080 2>/dev/null | grep -i claw echo "=== 检查环境变量 ===" env | grep -i claw

Windows 下用 PowerShell：

Write-Host "=== 检查服务 ===" Get-Service | Where-Object {$_.Name -like "*claw*"} Write-Host "=== 检查进程 ===" Get-Process | Where-Object {$_.ProcessName -like "*claw*"} Write-Host "=== 检查文件 ===" Get-ChildItem -Path $env:APPDATA,$env:LOCALAPPDATA,$env:PROGRAMDATA -Filter "*OpenClaw*" -Recurse -ErrorAction SilentlyContinue Write-Host "=== 检查注册表 ===" reg query "HKCU\Software" | Select-String -Pattern "OpenClaw" reg query "HKLM\SOFTWARE" | Select-String -Pattern "OpenClaw"

脚本输出为空或只有 grep 自身进程，说明清理干净。

4.2 验证 TaoToken 接入

用 curl 直接测接口，确认 Key 和端点可用：

curl -s https://taotoken.net/api/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-你的Key" \ -d '{ "model": "claude-sonnet-4-20250514", "messages": [{"role": "user", "content": "回复OK两个字"}], "max_tokens": 10 }'

成功返回类似：

{ "id": "chatcmpl-xxx", "object": "chat.completion", "choices": [ { "index": 0, "message": {"role": "assistant", "content": "OK"}, "finish_reason": "stop" } ], "usage": {"prompt_tokens": 8, "completion_tokens": 2, "total_tokens": 10} }

如果返回choices数组且有内容，说明接入正常。如果报 401，检查 Key 是否正确、有没有多余空格。如果报model not found，检查 Model ID 拼写。如果报连接超时，检查网络和 Base URL 是否写错。

在客户端里验证时，发一条简单消息，看是否能正常返回。Cline 里可以在对话框输入「你好」，观察是否流式返回。Claude Code 里执行claude "你好"，看终端输出。Codex CLI 类似。

验证通过后，你的环境就是干净且可复用的。旧 OpenClaw 的残留不会干扰新配置，TaoToken 的接入也能正常工作。

5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth

清理和接入过程中会遇到几类典型报错，这里逐个对照排查。

401 Unauthorized：最常见。原因通常是 API Key 错误、Key 被删除、或者请求头格式不对。检查Authorization: Bearer sk-xxx里的 Key 是否完整，有没有换行或空格。如果 Key 是在清理 OpenClaw 时误删的，去控制台重新建一个。另外注意有些客户端把 Key 存在环境变量里，清理时如果删了环境变量但客户端还在读旧值，也会 401。重启客户端或重新加载配置。

local proxy failed：这个报错通常出现在 OpenClaw 或类似工具里，表示本地代理端口起不来。原因往往是旧服务还占着端口。用lsof -i :端口号查占用，找到进程 kill 掉。如果是 macOS，检查launchctl list | grep claw有没有残留项。清理干净后重启客户端。

reading choices 报错：类似cannot read property 'choices' of undefined，说明接口返回的不是预期结构。常见原因是 Base URL 写错，请求打到了错误路径，返回了 HTML 或 404 页面。检查 Base URL 是不是https://taotoken.net/api，有没有多写/v1。另外确认 Model ID 正确，模型不存在时有些网关会返回非标准结构。

OAuth 相关报错：如果你用的是需要 OAuth 的客户端，报OAuth token expired或invalid_grant，说明认证过期。这类客户端通常有自己的登录流程，重新走一遍授权即可。注意 OAuth 和 API Key 是两套体系，不要混用。TaoToken 的 API Key 方式不需要 OAuth，直接填 Key 就行。

服务删除失败提示「服务不存在」：Windows 下sc delete报这个，说明服务名不对或已经删了。用sc query确认实际名称。macOS 下launchctl unload报Could not find specified service，说明 plist 已经不在或路径不对，检查~/Library/LaunchAgents/下有没有对应文件。

文件被占用无法删除：先确认所有相关进程已停止。Linux/macOS 用ps aux | grep claw查，Windows 用任务管理器。如果还删不掉，重启系统后再删。Windows 下有些文件被系统索引占用，重启后通常能删。

注册表项删除权限不足：Windows 下用管理员身份运行 regedit 或 CMD。如果还是不行，右键注册表项 → 权限 → 给当前用户完全控制，再删。

环境变量清理后仍生效：改完~/.bashrc要source或重开终端。Windows 下改完环境变量要重启 CMD 或注销重登。有些客户端会缓存环境变量，重启客户端。

排查的核心思路是：先确认残留清干净了，再确认配置三件套写对了，最后确认网络和端点可达。大部分报错都出在这三步中的某一步。

6. 清理完成后如何稳定接入 TaoToken 做长期编码

清理残留只是第一步，真正影响体验的是后续接入的稳定性。如果你只是偶尔用一下，按第三节的配置片段填好三件套就能跑。但如果你要长期做编码或 Agent 任务，有几个点值得注意。

首先是 Key 的管理。不要把 Key 硬编码在会提交到 Git 的文件里。用环境变量或本地配置文件，并确保.gitignore排除了这些文件。TaoToken 控制台可以创建多个 Key，建议按用途分开，比如一个用于本地开发，一个用于 CI，方便单独吊销。

其次是模型选择。不同模型在编码任务上的表现差异明显。Claude 系列在长上下文和代码理解上比较稳，GPT 系列在某些工具调用场景更顺。你可以在模型对话页面快速对比效果，再决定长期用哪个。Coding Plan 适合高频调用场景，额度策略对持续编码更友好。

第三是客户端配置的持久化。Cline 的 MCP 配置、Claude Code 的 settings.json、Codex 的 auth.json，这些文件建议纳入 dotfiles 管理，换机器时直接同步。但注意 Key 不要明文提交，可以用模板加环境变量替换的方式。

第四是验证习惯。每次换环境或重装后，先用 curl 测一下接口，再在客户端里发一条消息。两步都通过再开始正式任务。这样能把配置问题挡在开始之前，而不是写到一半报错。

最后，如果你在清理或接入过程中遇到本文没覆盖的报错，可以去接入文档查各客户端的详细说明，或者在模型对话页面直接测试接口连通性。文档地址是https://taotoken.net/doc，API Keys 管理在https://taotoken.net/api-keys。把残留清干净、三件套配对、验证跑通，环境就是可复用的，下次换工具或重装都不用再折腾一遍。