1. 微信里翻遍插件页也找不到 ClawBot问题出在顺序上微信生态里接入 OpenClaw 这件事最近问得最多的一句话就是ClawBot 插件到底在哪我微信更新到最新版了插件页面翻到底也没有。这个现象非常普遍但答案往往让人有点意外——不是微信没给你而是你把顺序做反了。先把核心检索词讲清楚。ClawBot 是微信侧用来连接 OpenClaw 的官方插件入口OpenClaw 是跑在你自己设备或云主机上的智能体运行时两者之间靠一次扫码绑定建立通道。适合谁适合已经在本地或云端跑着 OpenClaw、想用微信直接对话的人也适合还没装 OpenClaw、但想按正确路径一次走通的人。它解决的问题是把过去需要企业微信自建应用、内网穿透、固定 IP 才能做到的微信接入压缩成装插件 → 扫码 → 用三步。那为什么在微信里找不到因为 ClawBot 图标不是微信原生自带的它是 OpenClaw 侧安装openclaw-weixin插件、完成扫码绑定之后才回写到微信插件页的。你还没装、还没绑微信自然没有东西可显示。这就像你先去收件箱找快递但快递还没发货——顺序错了怎么刷新都刷不出来。我见过太多人卡在这一步看到新闻 → 打开微信插件页 → 搜不到 → 怀疑版本 → 更新 → 还是没有 → 放弃。整个链条里唯一没做的就是先在 OpenClaw 那侧把插件装上。所以这篇不按微信怎么找插件写而是按真实可跑通的顺序写先有 OpenClaw再装微信插件再扫码绑定最后才回到微信里用。中间还会把 TaoToken 统一 Key 的配置片段、OpenClaw 侧 Base URL 与 auth.json 的填写示例、以及绑定后一次最小对话验证动作全部给全让你照着做就能出结果。需要提前说明一点OpenClaw 的安装命令是公开开源的网上教程很多也有厂商做了一键安装工具和托管平台。但在动手前先确认自己是不是真的需要——付费安装又付费卸载的人不在少数别盲目跟风。如果你已经有 OpenClaw 在跑那直接跳到插件安装那节即可。2. TaoToken 统一 Key 前置准备Base URL、Key 与模型 ID 三件套在装微信插件之前得先把 OpenClaw 背后的模型通道理顺。很多人 OpenClaw 装好了、插件也装了扫码也绑了结果一发消息就报错根子就在模型通道没配好。这里用 TaoToken 做统一入口把 Base URL、API Key、Model ID 三件套一次配齐后面微信侧才能真正跑通对话。TaoToken 在这里的角色是统一 Key 网关你不需要在 OpenClaw 里分别填各家模型的地址和密钥而是统一走一个 Base URL用一把 Key 管理多个模型。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 这个不加 UTM。注意API 地址是给程序调用的不是给你在浏览器里点开的填错地方会直接 404。三件套具体是Base URLhttps://taotoken.net/apiOpenClaw 或任何 OpenAI 兼容客户端都填这个。API Key在控制台创建形如sk-开头的一串。创建入口在 API Keys 页面建议单独建一把给 OpenClaw 用方便日后吊销。Model ID填你要用的模型标识比如claude-sonnet-4-5这类具体以控制台模型列表为准。为什么强调单独建一把 Key因为 OpenClaw 会把它写进auth.json一旦这个文件被同步到别处或误提交单独 Key 可以随时在控制台吊销不影响你其他项目。这是踩过坑之后的习惯。如果你还没创建 Key流程是进控制台 → API Keys → 新建 → 复制保存。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。创建完先别关页面下一步配置马上要用。这里要提醒一个常见误区有人把 Base URL 填成官网首页https://taotoken.net/结果请求全部打到网页上返回一堆 HTML然后报reading choices之类的解析错误。记住程序调用只认https://taotoken.net/api官网是给人看的API 是给机器调的两者不能混。配好三件套之后OpenClaw 侧就有了稳定的模型出口。接下来才是装微信插件、扫码绑定。顺序依然是通道先通插件后装绑定最后。这样一旦出问题你能快速判断是模型通道的问题还是插件绑定的问题而不是一团乱麻。3. 可复制配置OpenClaw 侧 auth.json 与 settings 片段这一节给可直接复制的配置片段。OpenClaw 的配置分两块一块是模型通道Base URL Key Model ID通常落在auth.json或环境变量里一块是微信插件本身的安装与网关配置。两块都配好扫码绑定才有意义。先看模型通道。OpenClaw 支持 OpenAI 兼容格式所以auth.json可以这样写。文件路径一般在 OpenClaw 配置目录下Linux/macOS 常见是~/.openclaw/auth.jsonWindows 在用户目录下的.openclaw文件夹里。内容示例{ providers: { taotoken: { baseURL: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, models: { default: claude-sonnet-4-5 } } }, defaultProvider: taotoken }注意baseURL结尾不要多加/v1也不要写成官网首页。apiKey换成你在控制台创建的那把。default换成你实际要用的 Model ID。保存后OpenClaw 启动时会读取这个文件。如果你更习惯用环境变量也可以这样export OPENCLAW_BASE_URLhttps://taotoken.net/api export OPENCLAW_API_KEYsk-你的TaoToken密钥 export OPENCLAW_MODELclaude-sonnet-4-5Windows PowerShell 对应$env:OPENCLAW_BASE_URLhttps://taotoken.net/api $env:OPENCLAW_API_KEYsk-你的TaoToken密钥 $env:OPENCLAW_MODELclaude-sonnet-4-5环境变量优先级通常高于auth.json两者选其一即可别同时配又填了不同值否则排查起来很痛苦。再看微信插件安装。已有 OpenClaw 的情况下在 OpenClaw 设备上运行npx -y tencent-weixin/openclaw-weixin-clilatest install插件安装成功后会自动重启网关。当前openclaw-weixin插件版本是 1.0.2首次启动命令行会显示一个二维码。这里就是扫码绑定的入口。如果你还没有 OpenClawmacOS / Linux / WSL2 用curl -fsSL https://openclaw.ai/install.sh | bashWindows PowerShell 用iwr -useb https://openclaw.ai/install.ps1 | iex装完再回到上面的插件安装命令。整个顺序是装 OpenClaw → 配 TaoToken 三件套 → 装微信插件 → 扫码绑定 → 微信里用。任何一步跳过去后面都会以报错的形式还回来。关于 settings 片段如果你用的是带图形界面的 OpenClaw 发行版模型设置里通常有 Base URL、API Key、Model 三个输入框分别填https://taotoken.net/api、你的 Key、Model ID。填完点保存再重启一次网关确保配置生效。这一步做完模型通道就算通了可以进入扫码绑定环节。4. 扫码绑定与最小对话验证一次请求确认全链路配置就绪后进入扫码绑定。首次启动openclaw-weixin插件命令行会显示二维码。这里有个很多人踩的坑第一次扫码后微信会提示你更新微信更新完需要再扫一次。也就是说第一次扫码是触发更新第二次扫码才是真正激活插件。别扫一次没反应就以为失败了。绑定成功后你的微信插件页面就会出现 ClawBot 图标点击即可开始对话。注意是绑定成功后才出现不是先出现再绑定。这也再次印证了开头的结论顺序反了怎么找都找不到。接下来做一次最小对话验证确认从微信 → OpenClaw → TaoToken → 模型 → 返回 这条链路是通的。验证动作很简单在 ClawBot 对话框里发一句你好请回复链路正常。如果一切配置正确你会收到模型返回的链路正常。如果你想在命令行侧也验证一次模型通道可以单独发一个请求排除微信插件本身的干扰curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 回复链路正常}] }如果这条 curl 能返回正常 JSON说明 TaoToken 通道没问题如果微信里发消息报错但 curl 正常那问题就在 OpenClaw 或微信插件侧。这种分层验证能帮你快速定位而不是一上来就怀疑 Key 填错。实测下来最容易出问题的是三个点一是auth.json里 Base URL 写成了官网首页二是 Key 复制时带了空格或换行三是 Model ID 写了一个控制台里不存在的名字。这三个都会导致请求失败但报错信息各不相同下一节专门对照。绑定完成后你还可以在微信插件右上角设置里修改头像和名称改成你自己给 OpenClaw 起的名字。这个不影响功能纯属个性化。改完再发一条消息确认没把配置改坏就收工。5. 常见报错对照排查401、local proxy failed、reading choices、OAuth这一节按真实报错逐条对照。这些错误我在配置过程中基本都遇到过写出来帮你省时间。401 Unauthorized最常见。原因通常是 Key 错了、Key 过期、或者 Key 前面多了Bearer又重复加了一次。检查auth.json里apiKey是不是完整的sk-开头字符串前后有没有空格。如果你在 curl 里手动加了Authorization: Bearer sk-xxx那auth.json里就不要再带Bearer只放sk-xxx。另外确认这把 Key 是在 TaoToken 控制台创建的且没有被吊销。local proxy failed / connection refused这个多半是 Base URL 填错或网络出口问题。先确认填的是https://taotoken.net/api不是官网首页也不是带/v1的地址。如果地址没错检查本机是否能正常访问该域名公司网络或某些环境可能对出站有限制。还有一种情况是 OpenClaw 网关没重启旧配置还在内存里重启一次即可。reading choices / cannot read property choices这个报错说明请求发出去了但返回的不是标准 OpenAI 格式程序在解析choices字段时失败。根因通常是 Base URL 打到了网页上返回了 HTML自然没有choices。把 Base URL 改回https://taotoken.net/api就能解决。少数情况是 Model ID 写错服务端返回了错误结构同样检查 Model ID。OAuth / 授权相关报错如果你用的是需要 OAuth 的客户端比如某些 Codex 类工具报 OAuth 错误通常意味着你走了 OAuth 流程而不是 API Key 流程。OpenClaw 接 TaoToken 走的是 API Key不需要 OAuth。检查配置里是不是误开了 OAuth 模式关掉改用apiKey字段。如果你同时装了多个 provider确认defaultProvider指向的是taotoken。扫码后微信没出现 ClawBot 图标先确认插件安装命令是否执行成功、网关是否重启。然后确认是不是只扫了一次码——第一次扫码触发微信更新更新后要再扫一次。两次都完成图标才会出现。如果还是没有检查openclaw-weixin插件版本当前是 1.0.2版本过旧可能有兼容问题用latest重装一次。发消息一直转圈无响应链路某一段卡住。先用上一节的 curl 验证 TaoToken 通道通了再查 OpenClaw 日志。常见原因是 Model ID 不存在导致服务端长时间无返回或者 Key 额度问题。换一个确认可用的 Model ID 再试。排查的核心思路是分层微信插件层、OpenClaw 层、TaoToken 通道层一层层用最小请求验证。别一上来就重装所有东西那样只会把问题搅得更乱。排障相关的入口我放在 API Keys 和接入文档API Keys 在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 遇到配置细节可以直接对照。6. 按正确顺序接入从模型对话到长期 Coding Plan把顺序再捋一遍这次带上具体入口方便你直接点进去操作。第一步确认模型通道。如果你只是想先验证模型能不能用直接进模型对话页面发一句话试试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。这一步不涉及 OpenClaw纯粹确认 Key 和模型是活的。第二步创建并保存 Key。进 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 新建一把给 OpenClaw 专用。复制好填进auth.json的apiKey字段。第三步配 OpenClaw 三件套。Base URL 填https://taotoken.net/apiKey 填上一步的Model ID 填你要用的。保存后重启网关。第四步装微信插件并扫码绑定。运行npx -y tencent-weixin/openclaw-weixin-clilatest install首次启动出二维码扫两次第一次触发更新第二次激活。绑定成功后微信插件页出现 ClawBot。第五步发一条最小消息验证全链路。收到正常回复接入完成。如果你不只是想偶尔对话而是要把 OpenClaw 当成长期编码或 Agent 助手来用那建议直接上 Coding Plan额度和管理方式更适合持续调用https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。长期跑 Agent 的场景统一 Key 加套餐的方式比每次单独配要省心得多。最后说一个真实经验这套流程里真正花时间的不是扫码而是前面模型通道的配置。把auth.json写对、Base URL 填准、Key 存好后面扫码绑定基本一次过。反过来如果通道没通就急着扫码绑上了也发不出消息然后你会以为是微信插件的问题绕一大圈回到原点。顺序对了事情就顺了。