1. 卸载 Openclaw 后为什么还要清理 gateway 残留Openclaw 这个 CLI 工具在圈子里被叫成“龙虾”装的时候一条命令就完事卸的时候却经常留一堆尾巴。我见过太多人执行完openclaw uninstall就以为干净了结果过几天发现后台还有个 gateway 进程在跑或者~/.openclaw目录里躺着几百 MB 的 Agent 运行时文件。更麻烦的是如果你之前已经把 Openclaw 接入了 TaoToken 的统一 Key/API 通道残留的config.toml或settings.json里可能还留着旧的 base_url 和 api_key 字段下次装别的工具或者重新装 Openclaw 时通道配置就会打架。这篇内容聚焦的就是这个场景你已经用 TaoToken 的 API 通道跑过 Openclaw现在要彻底卸载它需要把 CLI 本体、gateway 服务、状态目录、配置文件、workspace 全部清掉并且确认 TaoToken 那边的配置不会和新环境冲突。适合已经装过 Openclaw、正在做环境清理的开发者也适合那些 CLI 已经找不到但服务还在后台跑的情况。先说清楚一个前提Openclaw 的卸载分两条路。CLI 还在的走简易路径一条命令带参数就能清完CLI 已经找不到但服务还在跑的走手动清理路径按操作系统分别处理。下面我会把两条路都写清楚并且给出 TaoToken 配置清理的骨架。2. TaoToken 前置统一 Key 与 API 通道的配置位置在动手卸载之前先确认你当初是怎么把 Openclaw 接到 TaoToken 的。TaoToken 提供的是统一的 API 通道官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点固定为 https://taotoken.net/api 。Openclaw 作为 CLI 工具接入方式通常是在它的配置文件里写 base_url 和 api_key。Openclaw 的配置一般落在两个位置一个是状态目录下的config.toml默认在~/.openclaw/config.toml另一个是settings.json可能在状态目录或者 workspace 里。如果你当时用了OPENCLAW_CONFIG_PATH环境变量把配置指到了别的地方那个文件也要单独找出来。TaoToken 侧的 Key 管理在控制台里你可以先登录 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 看一眼当前有哪些 Key 在活跃。如果这个 Key 只给 Openclaw 用过卸载完之后可以考虑在控制台里把它禁用或删除避免旧 Key 留在环境里被其他工具误读。API Keys 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。这里要强调一点卸载 Openclaw 不会自动清理 TaoToken 侧的 Key也不会自动改你环境变量里的OPENAI_BASE_URL之类的东西。所以清理分两层一层是 Openclaw 本体的残留一层是通道配置的残留。两层都清完才算真的干净。3. 可复制配置config.toml 与 settings.json 清理骨架先给一份可以直接抄的清理骨架。不管你走简易路径还是手动路径最后都要落到这几个文件上。3.1 定位配置文件# 查看状态目录默认位置 echo ${OPENCLAW_STATE_DIR:-$HOME/.openclaw} # 查看是否自定义了配置路径 echo ${OPENCLAW_CONFIG_PATH:-未设置} # 列出状态目录下所有配置文件 ls -la ${OPENCLAW_STATE_DIR:-$HOME/.openclaw} 2/dev/null如果OPENCLAW_CONFIG_PATH有值说明你的config.toml不在默认状态目录里需要单独处理。3.2 config.toml 清理骨架Openclaw 的config.toml里跟 TaoToken 相关的字段通常长这样# ~/.openclaw/config.toml 片段示例 [provider] base_url https://taotoken.net/api api_key sk-xxxxxxxx [gateway] port 8787 profile default清理的时候如果你打算彻底删掉 Openclaw直接删整个文件就行。但如果你只是想断开 TaoToken 通道、保留 Openclaw 其他配置就把[provider]段里的base_url和api_key注释掉或删掉# [provider] # base_url https://taotoken.net/api # api_key sk-xxxxxxxx3.3 settings.json 清理骨架settings.json里可能存着环境变量覆盖或者通道别名{ env: { OPENAI_BASE_URL: https://taotoken.net/api, OPENAI_API_KEY: sk-xxxxxxxx }, gateway: { profile: default } }清理时把env里跟 TaoToken 相关的两个键删掉保留其他设置{ env: {}, gateway: { profile: default } }注意如果你在 shell 的.zshrc或.bashrc里也 export 了OPENAI_BASE_URL和OPENAI_API_KEY那部分不在 Openclaw 配置文件里需要单独去 shell 配置文件里删。这一步很多人会漏。4. 简易路径与手动路径的完整卸载步骤4.1 简易路径CLI 仍然可用最省事的方式是用它自带的卸载命令openclaw uninstall想一键清除所有配置、跳过所有确认提示加参数openclaw uninstall --all --yes --non-interactive如果你习惯用 npx也可以npx -y openclaw uninstall --all --yes --non-interactive如果想手动一步步来效果完全一样按顺序执行# 第一步停止网关服务 openclaw gateway stop # 第二步卸载网关服务本身 openclaw gateway uninstall # 第三步删除本地状态与配置文件 rm -rf ${OPENCLAW_STATE_DIR:-$HOME/.openclaw} # 第四步删除 workspace可选但建议执行 rm -rf ~/.openclaw/workspace # 第五步卸载 CLI 本体根据安装方式选择 npm rm -g openclaw # npm 安装的 pnpm remove -g openclaw # pnpm 安装的 bun remove -g openclaw # bun 安装的如果还装了 macOS 桌面版记得一并处理rm -rf /Applications/OpenClaw.app4.2 手动路径CLI 已不可用但服务仍在运行如果 CLI 已经找不到了但网关服务还在后台默默跑着就需要根据操作系统分别处理。macOS 用户默认服务标签为ai.openclaw.gatewaylaunchctl bootout gui/$UID/ai.openclaw.gateway rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist如果你当时用了--profile参数需要把命令里的标签和 plist 文件名替换为ai.openclaw.profile名。此外老版本 OpenClaw 遗留的com.openclaw.*格式 plist 如果还存在也一并删除。Linux 用户默认服务单元名为openclaw-gateway.servicesystemctl --user disable --now openclaw-gateway.service rm -f ~/.config/systemd/user/openclaw-gateway.service systemctl --user daemon-reload使用了--profile的对应单元名为openclaw-gateway-profile名.service命令里替换即可。Windows 用户默认任务名为OpenClaw Gatewayschtasks /Delete /F /TN OpenClaw Gateway Remove-Item -Force $env:USERPROFILE\.openclaw\gateway.cmd使用了--profile的任务名对应为OpenClaw Gateway (profile名)同时删除~\.openclaw-profile名\gateway.cmd。4.3 多 profile 与远程模式的额外处理如果你当时用--profile参数创建了多个配置每个 profile 都有独立的状态目录默认路径是~/.openclaw-profile名需要逐一找出来逐一删除。一个都不能漏否则残留数据还在。# 列出所有 profile 状态目录 ls -d ~/.openclaw-* 2/dev/null # 逐个删除 rm -rf ~/.openclaw-profile名如果你用的是远程模式状态目录不在本机而是在网关主机上。这意味着上面停止服务、删除状态目录这几步需要登录到网关主机上去执行本机操作是不够的。源码方式安装的情况卸载顺序很重要必须先卸载网关服务走上面的简易路径或手动清理路径再删除仓库目录最后清理状态和 workspace。顺序不能反否则服务还挂着删了仓库反而清理不干净。5. 验证请求与成功结果确认通道已断开卸载完不算完得验证一下。验证分两个层面一是 Openclaw 本体确实没了二是 TaoToken 通道配置不再被引用。5.1 验证 Openclaw 本体# 检查 CLI 是否还在 which openclaw # 预期输出空 # 检查 gateway 进程 ps aux | grep -i openclaw | grep -v grep # 预期输出空 # 检查状态目录 ls -la ~/.openclaw 2/dev/null # 预期输出No such file or directory # macOS 检查 launchd 服务 launchctl list | grep -i openclaw # 预期输出空 # Linux 检查 systemd 服务 systemctl --user list-units | grep -i openclaw # 预期输出空5.2 验证 TaoToken 通道配置# 检查 shell 环境变量 env | grep -i -E openai|taotoken|openclaw # 预期输出空或者只剩你其他工具在用的变量 # 检查 shell 配置文件 grep -n -i -E openai|taotoken|openclaw ~/.zshrc ~/.bashrc 2/dev/null # 预期输出空如果这里还有输出说明 shell 配置文件里还留着 export 语句需要手动删掉。5.3 用 TaoToken 模型对话做一次通道验证如果你想确认 TaoToken 通道本身是通的可以走模型对话页面发一条测试请求https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content在对话里发一句简单的话能正常返回就说明 TaoToken 侧的 Key 和通道没问题。这一步跟 Openclaw 卸载是独立的只是帮你确认通道本身没被误伤。6. 本篇常见错排查6.1 卸载后which openclaw还有输出大概率是全局包管理器没清干净。检查一下你当时用的是哪个包管理器npm ls -g --depth0 | grep openclaw pnpm ls -g --depth0 | grep openclaw bun pm ls -g | grep openclaw哪个有输出就用对应的 remove 命令再删一次。有时候 npm 和 pnpm 都装过需要两个都删。6.2 gateway 进程杀了又起来这是典型的服务没注销。macOS 上检查~/Library/LaunchAgents/下有没有ai.openclaw.*.plistLinux 上检查~/.config/systemd/user/下有没有openclaw-gateway*.service。光 kill 进程没用得把服务定义文件删掉再daemon-reload。6.3 状态目录删了但配置还在如果你设过OPENCLAW_CONFIG_PATH配置文件就不在状态目录里。用echo $OPENCLAW_CONFIG_PATH找出来单独删。另外多 profile 的情况下~/.openclaw-profile名这些目录也要逐个检查。6.4 TaoToken 通道配置冲突重新装 Openclaw 或者其他工具时如果发现 base_url 被改回了旧地址检查三个地方~/.openclaw/config.toml、~/.openclaw/settings.json、shell 的.zshrc/.bashrc。这三个地方任意一个留着旧的https://taotoken.net/api和旧 Key都可能导致新工具读到旧配置。6.5 远程模式本机删了但网关主机没删远程模式下本机只是客户端真正的 gateway 跑在网关主机上。你需要 SSH 到那台主机按第 4 节的手动路径再执行一遍。本机删干净不代表远程干净。7. 清理完之后的通道复用建议卸载 Openclaw 之后如果你还要继续用 TaoToken 的统一 Key 跑其他工具建议在控制台里重新生成一个 Key而不是复用旧 Key。旧 Key 在 Openclaw 的配置文件里躺过虽然文件删了但 Key 本身如果没在控制台禁用理论上还是有效的。重新生成一个旧的在控制台里禁用掉环境更干净。控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content如果你接下来要跑长期编码任务或者 Agent 类工作负载可以看一下 Coding Plan 的配置方式https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档里有完整的 base_url 和 api_key 配置示例照着填就行https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Keys 管理页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后提醒一句卸载 Openclaw 的时候先把 gateway 服务停掉再删文件顺序反了容易留残留。多 profile 和远程模式是两个最容易漏的点清理的时候多花两分钟检查一下比事后排查省事得多。