1. 为什么卸载 OpenClaw 比安装更容易翻车OpenClaw 是一个本地部署的 AI 编码助手通过 pnpm 全局安装后会在系统里留下三类东西全局包本体、~/.openclaw配置目录、以及可能被 install.sh 写进/usr/local/bin的可执行文件。很多人以为pnpm remove -g openclaw一敲就完事了结果重装时发现旧的 TaoToken 统一 Key 通道配置还在模型请求直接打到旧通道上报 401 或者路由错乱。这篇教程解决的就是这个问题不只是把包删掉而是把 TaoToken 统一 Key 通道相关的配置字段、环境变量、缓存全部清理干净让环境回到「从没装过」的状态。适合已经用 pnpm 装过 OpenClaw、现在想彻底卸载或准备重装的人。整个过程不需要你懂 Node 包管理原理照着命令敲就行。我试过在一台 Ubuntu 22.04 上反复装了卸了三遍前两次都因为~/.openclaw/openclaw.json里的taotoken_base_url字段没删干净重装后一直走旧通道。第三次把配置骨架整个清掉才恢复正常。下面把完整流程拆开讲。2. 卸载前先搞清楚 TaoToken 统一 Key 通道写进了哪些文件OpenClaw 接入 TaoToken 的方式通常是在配置文件里写一个统一的 base_url 和 api_key所有模型请求都走这个通道。默认配置目录是~/.openclaw/里面常见两个文件文件作用是否含 TaoToken 字段~/.openclaw/openclaw.json主配置模型路由、通道地址是通常有base_url、api_key~/.openclaw/clawdbot.json机器人/Agent 配置可能有provider指向统一通道~/.openclaw/config.toml部分版本用 TOML 骨架是[provider.taotoken]段~/.openclaw/.env环境变量覆盖可能有TAOTOKEN_API_KEY卸载前先备份万一里面有你自己调好的 prompt 模板还能捞回来cp -r ~/.openclaw ~/.openclaw_backup_$(date %Y%m%d)注意备份目录不要放在~/.openclaw里面否则删原目录时一起没了。放家目录下带日期后缀最稳。如果你不确定配置里有没有 TaoToken 字段可以先 grep 一下grep -ri taotoken\|base_url\|api_key ~/.openclaw/ 2/dev/null有输出就说明确实写了通道配置后面清理时要重点处理。3. 可复制卸载流程pnpm 移除 配置清理 残留删除3.1 用 pnpm 移除全局包先确认安装方式。如果你当初是用 pnpm 全局装的直接移除pnpm remove -g openclaw等价简写pnpm rm -g openclaw如果提示找不到包先列一下全局包确认名字pnpm list -g | grep -i openclaw有些版本包名是openclaw/cli这种 scope 形式那就按实际名字移除pnpm remove -g openclaw/cli标准方法失效时手动删全局目录。先拿到 pnpm 全局根路径pnpm root -g假设输出是/home/user/.local/share/pnpm/global/5/node_modules进去删掉 openclaw 相关文件夹cd $(pnpm root -g) ls | grep -i openclaw rm -rf openclaw openclaw清一下 pnpm 存储缓存避免旧版本残留干扰重装pnpm store prune3.2 清理 TaoToken 统一 Key 通道配置字段这一步是重点。直接删整个配置目录最干净rm -rf ~/.openclaw但如果你想保留其他配置、只删 TaoToken 相关字段就手动编辑。以openclaw.json为例删掉类似这样的段落{ provider: { taotoken: { base_url: https://taotoken.net/api, api_key: sk-xxxxxxxx, models: [claude-3-5-sonnet, gpt-4o] } } }改成{ provider: {} }如果是config.toml骨架删掉对应段[provider.taotoken] base_url https://taotoken.net/api api_key sk-xxxxxxxx整段删除即可。同时检查环境变量文件grep -n TAOTOKEN\|OPENCLAW ~/.bashrc ~/.zshrc ~/.profile 2/dev/null有的话把对应 export 行注释或删掉然后source ~/.bashrc生效。3.3 删除系统路径下的可执行文件install.sh 可能把二进制写到/usr/local/binwhich openclaw which clawdbot如果返回路径用 sudo 删sudo rm -f /usr/local/bin/openclaw sudo rm -f /usr/local/bin/clawdbot找不到就说明没装在那忽略即可。4. 验证卸载是否彻底命令、配置、通道三层检查卸载完别急着关终端按三层验证。第一层命令是否存在which openclaw openclaw --version预期结果是command not found或which: no openclaw in (...)。如果还能跑出版本号说明全局包没删干净回到 3.1 手动删目录。第二层配置目录是否移除ls -la ~ | grep .openclaw预期无输出。如果还有rm -rf ~/.openclaw再来一次。第三层TaoToken 通道字段是否残留grep -ri taotoken ~/.openclaw ~/.config/openclaw 2/dev/null无输出才算干净。这一步很多人漏掉结果重装后 OpenClaw 读到了旧的base_url请求全打到废弃通道上。重启终端后再跑一遍openclaw --version确保 shell 缓存里没有旧路径。5. 本篇常见错排查报错ERR_PNPM_NO_GLOBAL_BIN_DIRpnpm 全局 bin 目录没配置。执行pnpm setup后重启终端再试移除命令。pnpm remove -g提示包不存在但which openclaw还有路径说明当初不是 pnpm 装的可能是 npm 或 install.sh。用npm uninstall -g openclaw试或者直接删/usr/local/bin/openclaw。删了~/.openclaw重装后配置还在检查是否有OPENCLAW_CONFIG环境变量指向了别的路径。env | grep -i openclaw看一下有就 unset 掉。TaoToken 通道字段删了但请求还走旧地址可能是 shell 里 export 了TAOTOKEN_BASE_URL。env | grep -i taotoken确认然后在~/.bashrc里删掉对应行。权限不够删不掉/usr/local/bin下的文件加 sudo。如果 sudo 也报 operation not permitted检查文件是否被 immutable 属性锁了lsattr看一下用chattr -i解锁后再删。重装后模型列表为空说明配置骨架被删得太干净OpenClaw 没有默认 provider。重新配置时到 TaoToken 控制台生成新的 API Key填进openclaw.json的provider段即可。6. 清理完想重装先把 Key 通道准备好环境清干净之后如果你打算重新部署 OpenClaw建议先把 TaoToken 的接入信息准备好避免装完发现没有可用通道又回头折腾。到控制台创建一个新的 API Key然后参考接入文档把 base_url 和 key 写进配置骨架。具体入口生成和管理 Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入配置文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite想先验证模型通不通https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite长期跑编码 Agent 的话看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite重装时把新 Key 填进~/.openclaw/openclaw.json的provider段base_url 写https://taotoken.net/api保存后跑一次openclaw --version确认命令可用再发一条测试请求看通道是否通。这样卸载和重装就形成闭环了。
