1. OpenClaw 多平台消息通道接入微信、QQ、飞书鉴权差异到底卡在哪OpenClaw原 Clawdbot是一个开源、本地优先的 AI 代理网关能让大模型在你自己的电脑或服务器上 7×24 小时运行支持操作电脑、浏览网页、执行命令还能把微信、QQ、飞书这些聊天平台接进来当消息入口。很多人第一次配多端时卡点不在 OpenClaw 本身而在三端鉴权模型完全不同微信走的是扫码登录 本地插件通道QQ 走的是 Bot 开放平台的 AppID/Token 回调飞书走的是自建应用的 App ID/App Secret 事件订阅回调。三套东西混在一起配最容易出现「微信能收不能回、飞书回调 401、QQ 一直转圈」这类问题。这篇就按「统一 Key 分平台回调」的思路把 OpenClaw 接入微信、QQ、飞书的正确方法拆成可复制的步骤。核心思路是模型侧统一走 TaoToken 的 Key通道侧各平台按自己的鉴权方式填回调地址最后用三步验证动作本地发消息、看通道日志、确认回复到达一次跑通多端。适合已经在本地或服务器跑起 OpenClaw、想把它接进日常聊天工具的人也适合被多平台鉴权差异绕晕、想找一份对照配置的读者。先说清楚三端差异的本质。微信个人号接入靠的是 ClawBot 插件本质是本地起一个通道进程扫码后拿到会话凭证消息通过本地网关转发不涉及公网回调所以它最省事但也最依赖本机在线。QQ 和飞书都是标准的 Bot 开放平台模式需要你在平台后台创建应用、拿到凭证、配置回调 URL平台把用户消息 POST 到你的 OpenClaw 网关网关处理后调平台 API 回复。也就是说微信是「本地拉取式」QQ 和飞书是「公网回调式」。理解这一点后面配置就不会乱。我实测下来最容易踩的坑是把三端凭证混着填。比如把飞书的 App Secret 填到 QQ 的 Token 字段或者微信插件没启用就去配回调。正确做法是先在 TaoToken 侧拿到统一 Key再逐个平台配通道每配完一个就单独验证不要三端一起上。下面按顺序来先讲 TaoToken 统一 Key 的前置准备再给可复制的配置片段然后是各平台回调地址填写示例最后是三步验证和常见报错排查。2. TaoToken 统一 Key 前置准备一次配置三端共用模型出口OpenClaw 本身不绑定某一家模型服务它通过 OpenAI 兼容接口调用大模型。所以你要做的第一件事是准备一个统一的模型出口让微信、QQ、飞书三个通道都走同一个 Key。这样做的直接好处是换模型、调额度、看用量只在一个地方操作不用三端各配一遍。TaoToken 提供的就是这种 OpenAI 兼容的统一接入Base URL 和 Key 拿到后OpenClaw 的模型配置只写一份。先拿 Key。打开 TaoToken 控制台的 API Keys 页面https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content新建一个 Key命名建议带上用途比如openclaw-multi-channel方便后面区分。复制出来的 Key 只显示一次先存到安全的地方。如果你还没注册官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后进控制台即可。拿到 Key 之后OpenClaw 的模型配置有两种写法环境变量或配置文件。推荐用配置文件因为多通道共用时更清晰。OpenClaw 的配置目录一般在~/.openclaw/Windows 是%USERPROFILE%\.openclaw\主配置文件是config.json或config.toml具体看你安装版本。下面给一份可复制的 JSON 片段把模型出口指向 TaoToken{ models: { default: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: claude-sonnet-4-5, maxTokens: 4096 } } }注意 Base URL 填https://taotoken.net/api不要带多余路径。模型 ID 按你实际要用的填比如claude-sonnet-4-5、gpt-4o这类TaoToken 的模型列表在文档里能查到https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你更习惯 TOML等价写法是[models.default] provider openai-compatible baseUrl https://taotoken.net/api apiKey sk-你的TaoToken密钥 model claude-sonnet-4-5 maxTokens 4096配完先别急着接通道单独验证模型出口通不通。用 curl 打一发curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 只回复两个字通了}] }返回里能看到choices数组和内容就说明模型出口没问题。这一步很关键因为后面三端通道报错时你要能区分是「模型出口挂了」还是「通道鉴权挂了」。如果这里就 401先检查 Key 有没有复制全、有没有多余空格。模型出口通了再往下配通道。3. 可复制配置微信、QQ、飞书三端通道与回调地址填写这一节是全文的核心给可直接复制的配置片段。先说微信。微信个人号接入靠 ClawBot 插件iOS 微信 8.0.70 及以上支持。安装命令npx -y tencent-weixin/openclaw-weixin-clilatest installWindows 用户如果 npx 报「未找到 openclaw」是因为 npx 用 Linux 的 which 检测Windows 没有 which。改用 OpenClaw 插件命令openclaw plugins install tencent-weixin/openclaw-weixin openclaw config set plugins.entries.openclaw-weixin.enabled true openclaw channels login --channel openclaw-weixin最后一条会出二维码手机微信扫码授权。扫完重启网关openclaw gateway restart微信通道的配置片段config.json里 channels 部分{ channels: { openclaw-weixin: { enabled: true, type: weixin-plugin, model: default } } }微信不需要公网回调地址它是本地通道所以配置里没有 callback 字段。这也是它和 QQ、飞书最大的区别。再说 QQ。QQ 走 Bot 开放平台你需要先在 QQ 开放平台创建机器人应用拿到 AppID 和 Token。然后在 OpenClaw 里配通道{ channels: { qq-bot: { enabled: true, type: qq-openapi, appId: 你的QQ AppID, token: 你的QQ Token, model: default, callbackPath: /channels/qq/callback } } }QQ 的回调地址要填到开放平台后台格式是https://你的域名/channels/qq/callback。注意 QQ 平台要求回调必须是 HTTPS且要能公网访问。如果你在本地跑需要用内网穿透把本地端口暴露出去或者直接部署在有公网 IP 的服务器上。飞书走自建应用先在飞书开放平台创建企业自建应用拿到 App ID 和 App Secret开启「事件订阅」和「机器人」能力。OpenClaw 配置{ channels: { feishu: { enabled: true, type: feishu-openapi, appId: 你的飞书 App ID, appSecret: 你的飞书 App Secret, model: default, callbackPath: /channels/feishu/callback, verificationToken: 你的飞书 Verification Token } } }飞书回调地址填https://你的域名/channels/feishu/callback同时在飞书后台的「事件订阅」里填这个 URL并把 Verification Token 抄到配置里。飞书会先发一个 challenge 验证请求OpenClaw 网关要能正确响应否则事件订阅保存不了。三端配置对照表平台鉴权方式回调地址是否需公网关键字段微信扫码登录无否插件启用 扫码QQAppID Token/channels/qq/callback是appId、token飞书App ID App Secret/channels/feishu/callback是appId、appSecret、verificationToken配完三端后统一重启网关让配置生效openclaw gateway restart openclaw channels listchannels list能看到三个通道都是 enabled 状态就说明配置加载成功。如果某个通道显示 disabled 或 error先看它的日志别急着改模型配置。4. 三步验证本地发消息、看通道日志、确认回复到达配置写完不代表通了必须验证。我习惯用三步法每端都走一遍这样出问题能快速定位是哪一层。第一步本地发起消息。微信直接在聊天窗口给绑定的 ClawBot 发一句「你好」QQ 在机器人所在的群或私聊里 机器人发消息飞书在机器人会话里发消息。这一步验证的是「平台到网关」的链路。如果消息发出去没反应先看第二步的日志。第二步查看通道日志。OpenClaw 的日志按通道分开命令openclaw logs --channel openclaw-weixin --tail 50 openclaw logs --channel qq-bot --tail 50 openclaw logs --channel feishu --tail 50正常收到消息时日志里会出现类似received message from user xxx的记录。如果日志里什么都没有说明平台的消息没到网关问题在回调地址或平台后台配置。如果日志里有收到消息但没有后续的模型调用记录说明模型出口有问题回去检查第 2 节的 curl 验证。第三步确认回复到达。日志里出现sending reply to xxx且平台聊天窗口收到回复才算真正跑通。如果日志显示已发送但窗口没收到多半是平台侧的发送权限没开比如 QQ 机器人没在群里、飞书机器人没被拉进会话。三端验证时有个细节微信是本地通道日志里不会有 HTTP 回调记录而是插件进程的日志QQ 和飞书是回调式日志里能看到POST /channels/qq/callback这类记录。如果你在 QQ 日志里看到401或invalid signature说明 Token 填错了飞书日志里看到challenge failed说明 Verification Token 不对。实测下来三步验证能覆盖 90% 的接入问题。剩下 10% 多半是网络和权限问题比如服务器防火墙没放行回调端口、飞书应用没发布版本、QQ 机器人没通过审核。这些在平台后台都有明确提示按提示处理即可。5. 常见报错排查401、local proxy failed、reading choices、OAuth接入过程中最常见的几类报错这里逐个对照。401 Unauthorized。分两种模型出口 401 和通道 401。模型出口 401 是 TaoToken Key 问题检查 Key 是否复制完整、是否过期、Base URL 是否写成https://taotoken.net/api。通道 401 是平台凭证问题QQ 检查 Token飞书检查 App Secret微信检查插件是否启用。区分方法看报错出现在哪个日志里模型调用日志里的 401 是前者回调日志里的 401 是后者。local proxy failed。这个多半出现在微信通道原因是本地网关进程没起来或端口被占。先确认openclaw gateway status是 running再看端口有没有冲突。如果是 Windows检查防火墙有没有拦本地回环。重启网关通常能解决openclaw gateway restartreading choices或cannot read property choices of undefined。这是模型返回体解析失败通常是模型出口返回了非预期结构。原因可能是 Base URL 写错比如多写了/v1导致路径重复或者模型 ID 不存在。回去用第 2 节的 curl 验证确认返回体里有choices字段。如果 curl 正常但 OpenClaw 报这个错检查配置文件里baseUrl有没有被重复拼接。OAuth相关报错。飞书和 QQ 的开放平台都涉及 OAuth 流程常见的是invalid redirect_uri或scope not granted。前者是回调地址和后台填的不一致注意 HTTPS 和路径大小写后者是应用权限没开去平台后台把「机器人」「事件订阅」「发送消息」这些权限勾上然后重新发布版本。飞书改权限后必须重新发布应用版本才生效这点很容易漏。还有一个隐蔽的坑三端同时启用时如果模型配置里model字段写的是某个通道专属的模型名会导致其他通道调用失败。正确做法是模型配置里用default通道配置里引用model: default这样三端共用同一个出口。如果你确实想给不同通道配不同模型就在 models 里定义多个通道里分别引用。排查时有个通用技巧先把其他两个通道禁用只留一个单独跑通后再逐个启用。这样能把问题隔离到单个通道避免三端互相干扰。日志级别可以临时调高openclaw config set log.level debug openclaw gateway restartdebug 级别会打印完整的请求和响应体对定位reading choices这类解析错误特别有用。排查完记得调回 info不然日志会很大。6. 多端跑通之后统一 Key 的长期维护与 Coding Plan 选择三端跑通后日常维护其实很轻。因为模型出口统一走 TaoToken你只需要在一个地方管 Key 和额度。如果某个通道突然不回消息先看openclaw channels list状态再看对应通道日志最后用 curl 验证模型出口三步就能定位。建议把第 2 节的 curl 命令存成一个脚本出问题时先跑一遍能省很多时间。如果你打算把 OpenClaw 长期挂在服务器上跑尤其是接多个通道、跑 Agent 任务模型调用量会上去。这时候可以看下 TaoToken 的 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它更适合长期编码和 Agent 场景额度模型和按量调用不一样具体在页面里对照自己的用量选。如果只是偶尔用按量付费的 API Key 就够了。另外OpenClaw 的通道配置支持热重载改完config.json后不一定非要重启网关部分版本执行openclaw channels reload即可。但涉及插件启用/禁用时还是建议openclaw gateway restart避免状态不一致。微信插件升级后也要重启网关否则新版本可能不生效。最后提醒一点QQ 和飞书的回调地址依赖公网域名如果你用内网穿透域名变了要同步改平台后台和 OpenClaw 配置两边必须一致。微信因为是本地通道不受这个影响但要求本机一直在线。三端混用时建议把微信当「随身入口」QQ 和飞书当「团队入口」各司其职配置上也更清晰。模型对话入口在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 想先试模型效果可以直接在网页里对话确认没问题再接通道。