OpenClaw 飞书机器人无响应？先查长连接，模型 Key 再走 TaoToken
OpenClaw 接飞书这件事，最让人抓狂的不是配置步骤多，而是明明按教程一步步填完了 App ID 和 App Secret，在飞书里 @ 机器人却像石沉大海，一点反应都没有。这篇不重复贴一遍完整图文教程，而是从排障视角切入：先按飞书侧的事件链路逐项排查，确认消息到底有没有送到 OpenClaw；如果飞书事件已经到达、但模型调用这一步卡住，再打开 TaoToken 官网 创建一个 Key，把 OpenClaw 的模型 Base URL 指向https://taotoken.net/api，补上模型通道这一环。需要先说清楚：TaoToken 在这里只解决模型 Key 和调用通道的问题，它不替代飞书开放平台的应用发布、长连接设置和权限开通——飞书侧该做的动作一个都不能少。
一、先定位：无响应到底卡在哪一段
飞书机器人无响应，链路其实分两段：第一段是「飞书 → OpenClaw」，第二段是「OpenClaw → 模型 → 回复飞书」。很多人一上来就怀疑模型配置，结果折腾半天发现是飞书事件根本没进来。所以排查顺序应该是先飞书、后模型。
飞书这一段，按下面几项逐一核对：
应用是否真的发布成功。在飞书开放平台创建企业自建应用后，必须走完「创建版本 → 保存 → 确认发布」。个人账号一般免审直接上线，企业账号需要管理员审核通过。如果版本还停在草稿状态，机器人能力不会生效，消息自然进不来。
订阅方式是否为长连接接收事件。进入「事件与回调」，点订阅方式右侧的编辑按钮，勾选「使用长连接接收事件」并保存。注意不要选「将事件发送至开发者服务器」，那个模式需要公网回调地址，本地或内网环境根本收不到。
是否添加了
im.message.receive_v1。保存订阅方式后，在已添加事件区域点「添加事件」，搜索「接收消息 v2.0」，勾选im.message.receive_v1添加。少了这个事件，机器人收不到任何用户消息。关联权限是否全部开通。添加事件时飞书会弹出推荐开通权限的提示，点确认开通。之后回到事件列表展开权限说明，确认依赖权限都是「已开通」状态，有没开的点名称手动补开。测试消息收发至少要有
im:message、im:message:send_as_bot这类基础权限。OpenClaw Gateway 是否重启过。改完飞书侧配置、或者在 OpenClaw 里保存了渠道配置之后，建议重启一次 OpenClaw Gateway 服务，让长连接重新建立。有时候配置是对的，但旧连接还挂着，新事件就进不来。
App ID / App Secret 有没有多余空格。从飞书「凭证与基础信息」页复制时，很容易把首尾空格或换行一起带进去。粘贴到 OpenClaw 的 Feishu/Lark 配置项后，肉眼看不出来，但鉴权会失败。建议手动检查一遍，或者重新复制粘贴。
这六项过完，如果飞书侧确认没问题，消息应该能到达 OpenClaw。接下来才轮到模型调用这一段。
二、TaoToken 前置：它补的是模型通道，不是飞书配置
当飞书事件已经到达 OpenClaw，但机器人依然不回复，常见原因是模型调用失败——可能是没配模型 Key，可能是 Base URL 填错，也可能是通道不稳定。这时候 TaoToken 的作用就体现出来了：它提供模型调用的 Key 和统一入口，让 OpenClaw 能正常发起模型请求。
再次强调边界：TaoToken 不碰飞书开放平台的应用发布、长连接、事件订阅和权限，这些必须你在飞书侧自己完成。它只负责「OpenClaw 调用模型」这一段。所以正确的顺序是：飞书侧全部配通 → 确认事件能到 OpenClaw → 再用 TaoToken 补模型 Key → 回飞书发消息验证。
如果你还没创建 Key，打开 TaoToken 官网，注册后在控制台创建 API Key。拿到 Key 之后，OpenClaw 的模型 Base URL 填https://taotoken.net/api，注意不要加/v1，也不要带任何 UTM 参数。这个地址就是 OpenClaw 发起模型请求的入口。
三、可复制配置：OpenClaw 模型侧怎么填
OpenClaw 的模型配置和飞书渠道配置是分开的两块。飞书渠道那边填 App ID 和 App Secret，模型这边填 Base URL 和 API Key。下面给出需要填写的关键项：
模型 Base URL：
https://taotoken.net/apiAPI Key：
YOUR_API_KEY把YOUR_API_KEY替换成你在 TaoToken 控制台创建的真实 Key。填完之后保存配置，建议同样重启一次 OpenClaw Gateway，确保新的模型配置生效。
如果你用的是 OpenClaw 的 Windows 客户端，路径大致是：右上角设置 → 模型配置（或类似名称）→ 填入 Base URL 和 API Key → 保存。不同版本菜单名称可能略有差异，但核心就是这两项。
飞书渠道侧（对照检查，不要和模型配置混在一起）：
App ID: 飞书凭证与基础信息页复制 App Secret: 飞书凭证与基础信息页复制 启用开关: 打开飞书渠道只需要 App ID 和 App Secret 两个参数，采用长连接模式，不需要填 webhook URL，也不需要公网回调地址。这一点和模型配置是完全独立的。
四、验证请求与成功结果
配置完成后，怎么确认真的通了？分两步验证。
第一步：确认飞书事件到达 OpenClaw。在飞书里给机器人发一条消息，然后看 OpenClaw 的日志或运行状态。如果能看到收到im.message.receive_v1事件的记录，说明飞书这一段是通的。如果日志里什么都没有，回到第一节重新检查飞书侧配置。
第二步：确认模型调用成功。事件到达后，OpenClaw 会拿消息内容去调用模型。如果模型配置正确，你应该能在日志里看到模型请求发出并返回结果，随后飞书里收到机器人的回复。如果事件到了但模型调用报错，重点检查 Base URL 是否填成https://taotoken.net/api（不带/v1）、API Key 是否有效、有没有多余空格。
成功的结果很直观：在飞书里 @ 机器人发消息，几秒内收到回复。如果回复正常，说明飞书长连接和模型通道都通了。
五、本篇常见错排查
除了第一节的飞书侧六项，模型侧还有几个高频错误：
Base URL 多写了/v1。OpenClaw 的模型 Base URL 应该填https://taotoken.net/api，不要写成https://taotoken.net/api/v1。多这一截会导致请求路径拼接错误，模型调用直接失败。
API Key 带了空格或换行。和 App Secret 一样，从控制台复制 Key 时容易带上首尾空白。粘贴后手动检查一遍，或者删掉重新粘贴。
飞书配置和模型配置填反了。有人把 API Key 填到飞书渠道的 App Secret 里，或者把 App ID 填到模型配置里。这两块是完全独立的，飞书渠道只认 App ID / App Secret，模型配置只认 Base URL / API Key。
改了配置没重启 Gateway。OpenClaw 的渠道配置和模型配置保存后，建议重启一次 Gateway 服务。旧进程可能还持有旧配置，导致新配置不生效。
飞书应用版本没发布就测试。这是最隐蔽的一个。配置全对，但应用版本还在草稿状态，机器人能力不生效，消息根本进不来。回飞书开放平台确认版本已发布。
权限没开全。只加了im.message.receive_v1事件但没开通关联权限，事件能订阅但消息内容拿不到。回事件列表展开权限说明，确认依赖权限都是已开通。
六、语义一致 CTA
排障的顺序不要乱：先飞书、后模型。飞书侧的应用发布、长连接接收事件、im.message.receive_v1、权限开通、Gateway 重启、App ID/App Secret 空格，这六项确认无误后，如果模型调用还不成功，再走 TaoToken 补通道。
需要创建 Key 或查看接入细节的，走这两个入口：
- 创建 API Key、管理模型通道：TaoToken API Keys
- 查看接入文档和配置说明：TaoToken 接入文档
如果你还在选模型、想先验证通道是否可用，可以直接在 模型对话 里发一条测试消息，确认 Key 和通道正常后，再回 OpenClaw 配置。长期跑编码或 Agent 场景的，可以了解 Coding Plan，按需选择。
最后再提醒一次：TaoToken 补的是模型 Key 和调用通道，飞书开放平台的应用发布、长连接设置、事件订阅和权限开通，仍然需要你在飞书侧完成。两边都配通，飞书机器人才能真正恢复响应。
