OpenClaw（小龙虾）绑定微信教程：TaoToken 统一 Key 配置与消息通道验证

1. 为什么要把 OpenClaw 接到微信里OpenClaw 这个项目在圈子里被叫成「小龙虾」核心玩法是让一个本地跑的 AI 助手拥有自己的消息通道而微信几乎是国内开发者最顺手的入口。你不需要额外装一个 App也不用切来切去直接在微信里发一句话OpenClaw 就能收到并回你。它适合谁适合想把大模型能力塞进日常聊天流、又不想折腾复杂网关的开发者尤其是已经在用统一 Key 管理多家模型的人。我这次要做的是把 OpenClaw 的微信通道跑通同时把模型调用统一收敛到 TaoToken 的 Key 上。这样做的直接好处是微信侧只负责收发消息模型侧只认一个 Key换模型、换供应商都不用动微信配置。整条链路拆开就是三件事——装插件、绑微信、配 Key然后发一条消息验证闭环。下面按「先讲清楚问题再给可复制配置最后验证和排错」的顺序走。你跟着做基本能在十几分钟内看到微信里弹出 ClawBot 的回复。2. TaoToken 前置准备拿到统一 Key在动 OpenClaw 的配置文件之前先把模型侧的凭证准备好。TaoToken 的定位是统一入口你注册后在控制台创建一个 API Key后面 OpenClaw 的模型请求全部走这个 Key。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录后进控制台。创建 Key 的路径在控制台的 API Keys 页面直接访问 https://taotoken.net/console/api-keys 就能到。点新建复制出来的字符串形如sk-xxxxxxxx只显示一次先存到本地临时文件里。这里有个坑很多人复制完顺手关页面结果 Key 丢了只能重建所以复制后立刻粘贴到你的配置草稿里。接口地址统一用 https://taotoken.net/api 注意这个地址不带任何查询参数配置里填 base_url 时不要自己加斜杠或路径。模型名按你实际要用的填比如claude-sonnet-4-20250514这类具体以控制台模型列表为准。如果你还不确定用哪个模型可以先到模型对话页面 https://taotoken.net/models 试一句确认能出结果再写进配置。注意Key 属于敏感凭证不要提交到 Git 仓库也不要在截图里露出完整字符串。建议用环境变量注入配置文件里只写占位符。3. 可复制的 config.toml 骨架与 Key 配置片段OpenClaw 的配置集中在config.toml微信通道和模型通道是两块独立配置。下面这份骨架你可以直接抄把api_key换成你自己的model换成你要用的模型名。# OpenClaw 主配置 [general] name clawbot log_level info # 模型通道统一走 TaoToken [model] provider openai_compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model claude-sonnet-4-20250514 max_tokens 2048 temperature 0.7 # 微信消息通道 [channel.wechat] enabled true plugin wechat auto_reply true reply_prefix 配置里几个关键点解释一下。provider用openai_compatible是因为 TaoToken 的接口兼容 OpenAI 风格这样 OpenClaw 不需要额外的适配层。base_url必须是https://taotoken.net/api不要写成带/v1的地址否则会 404。api_key建议改成从环境变量读取比如把值写成${TAOTOKEN_API_KEY}然后在启动脚本里 export这样配置文件可以安全地进版本库。微信通道这块plugin wechat对应的是你接下来要装的插件auto_reply true表示收到消息自动触发模型回复。如果你想让 ClawBot 只在被 时回复可以加一行mention_only true这个参数在群聊场景里很有用避免它对着所有消息都插嘴。改完配置先别急着启动用一条命令做个语法检查很多启动失败其实是 TOML 写错了python -c import tomllib; tomllib.load(open(config.toml,rb)); print(config ok)输出config ok就说明格式没问题可以进入下一步。4. 安装微信插件并完成扫码绑定配置写好后回到 OpenClaw 的图形界面操作。打开软件右上角进设置找到「聊天配置」这一栏右侧展开后能看到「安装插件」的入口。点安装等进度条走完插件列表里会出现微信相关的项。这一步如果卡住多半是网络问题重试一次通常就好。插件装完点「开始扫描登录」。界面会在 5 秒左右生成一张二维码用手机微信扫它确认授权。绑定成功后微信里会多出一个叫 ClawBot 的对话框这就是你的消息通道入口。整个过程不需要额外装微信客户端插件扫码授权即可。这里有个细节二维码有时效生成后尽快扫超时了就重新点一次生成。另外如果你之前绑过别的机器人建议先在微信里把旧的会话删掉避免消息路由到旧通道。绑定完成后OpenClaw 侧的状态应该显示「已连接」。如果显示未连接先检查插件是否真的安装成功再看配置文件里enabled是不是true。这两处都对基本就能通。5. 验证消息收发发一句话看闭环现在做最关键的一步——验证。打开微信里的 ClawBot 对话框发一句简单的话比如「你好帮我算一下 12 乘以 8」。正常情况下几秒内会收到回复内容是模型生成的答案。如果没回复先看 OpenClaw 的日志。日志里会打印请求的 base_url 和状态码。常见的情况是 401说明 Key 不对或没生效如果是 404多半是 base_url 写错了。你可以用 curl 单独测一下模型通道排除是 OpenClaw 的问题还是 Key 的问题curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d {model:claude-sonnet-4-20250514,messages:[{role:user,content:ping}]}返回里有choices字段就说明 Key 和地址都没问题问题出在 OpenClaw 的配置或插件上。如果 curl 也报错那就回到控制台确认 Key 是否被禁用、余额是否充足。微信侧还有一个验证点发一条带图片的消息看 ClawBot 是否能识别。目前文本通道最稳图片和文件的支持取决于插件版本如果没反应不用慌先保证文本闭环跑通。6. 本篇常见错排查报错一启动时报invalid api_key。检查配置文件里 Key 有没有多余空格或者环境变量没 export 成功。用echo $TAOTOKEN_API_KEY确认一下。报错二微信扫码后没出现 ClawBot。大概率是插件没装完就点了登录。回到聊天配置里确认插件状态是「已安装」再重新扫码。报错三消息发出去一直转圈。看日志里的 base_url如果是https://taotoken.net/api/v1这种带/v1的改成https://taotoken.net/api。TaoToken 的接口路径不需要额外版本段。报错四模型回复很慢或超时。先确认选的模型是否可用可以到模型对话页面手动试一次。如果那边正常就是 OpenClaw 的max_tokens设太大调小到 1024 试试。报错五群聊里机器人乱回复。加上mention_only true让它只在被 时响应。排查顺序建议固定成先 curl 测 Key再查 config.toml 语法最后看插件状态。这样能最快定位问题在哪一层。7. 下一步把 Key 和通道固定下来跑通之后建议把配置固化。Key 用环境变量管理config.toml 进版本库时只保留占位符。微信通道这边如果你要长期跑可以把 OpenClaw 做成后台服务避免关掉终端就断线。需要长期做编码或 Agent 任务的可以看下 Coding Plan https://taotoken.net/coding-plan 把模型调用和额度统一管理起来。接入过程中遇到 Key 或通道问题直接查接入文档 https://taotoken.net/doc 里面有针对 base_url 和鉴权的说明。模型侧想先试效果模型对话入口在 https://taotoken.net/models 试完再把确认的模型名写回配置。整套流程的核心就一句话微信负责收发TaoToken 负责模型OpenClaw 负责把两边接起来。配置一次后面换模型只改一行model字段微信侧完全不用动。