openClaw 配置飞书：用 TaoToken 统一 Key 打通 WebSocket 长连接

1. 为什么我选择用 openClaw 接飞书而不是自己写 Webhook飞书机器人接入这件事很多人第一反应是搭一个公网 Webhook 服务然后处理签名校验、事件解密、消息回执。这套流程能跑通但维护成本不低服务器要一直在线回调地址要备案或做内网穿透飞书那边改一次加密策略你就得跟着改代码。我试过用最原始的方式接飞书光是处理im.message.receive_v1的事件体格式和 challenge 校验就花了大半天。openClaw 的 Feishu 插件走的是另一条路——WebSocket 长连接事件订阅。简单说它不是等飞书来敲你的门而是你的程序主动连到飞书的长连接服务上飞书有消息就通过这条已经建立的连接推给你。这意味着你不需要公网 IP不需要 webhook 地址本机启动 OpenClaw Gateway 就能收消息。对于个人开发者或者内网环境来说这个模式省掉了大量网络配置工作。这篇要解决的核心问题是怎么用openclaw channels add把飞书渠道配起来怎么用 TaoToken 统一管理模型 Key以及启动后怎么确认消息真的收发成功了。适合已经在用 openClaw 做 Agent 或自动化、想把飞书作为交互入口的人。整个链路我会给出可复制的config.toml骨架和验证动作照着跑一遍基本能通。2. TaoToken 前置统一 Key 让 openClaw 的模型调用不再散落各处openClaw 本身是一个 Agent 框架它需要调用大模型来完成对话和任务。如果你在飞书里跟机器人聊天背后其实是 openClaw 在调模型。问题在于openClaw 的各个渠道、各个 Agent 可能各自配置了不同的模型端点Key 散落在多个配置文件里换一次 Key 要改好几个地方。TaoToken 在这里的角色是提供一个统一的 API 入口。你可以在 TaoToken 控制台创建一个 Key然后把 openClaw 的模型调用指向 TaoToken 的 API 地址。这样飞书渠道、其他渠道、后台任务用的都是同一个 Key管理起来清爽很多。TaoToken 的 API 地址是https://taotoken.net/api兼容常见的 OpenAI 风格调用格式openClaw 配置里填这个 base URL 就行。具体操作上先去 TaoToken 控制台创建一个 API Key。如果你还没有账号可以从官网进入https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。注册后在控制台左侧找到 API Keys 页面点创建复制出来的 Key 形如sk-xxxx。这个 Key 后面要填到 openClaw 的配置里。需要留意的是TaoToken 的 Key 是给 openClaw 调模型用的不是飞书的 App ID 或 App Secret。飞书那套凭证是飞书开放平台发的两者不要混。很多新手第一次配的时候会把这两个搞混结果 Gateway 起来了但模型调不通。3. 可复制配置openclaw channels add 与 config.toml 骨架先确认 openClaw 版本。较新的版本已经内置 Feishu 插件不需要单独装openclaw/feishu。在终端执行openclaw --version如果版本比较新直接进入下一步。如果提示找不到 feishu 相关命令再考虑手动安装插件。接下来去飞书开放平台创建自建应用。进入开发者后台创建企业自建应用拿到 App ID 和 App Secret。然后在「权限管理」里至少开通这几个权限im:message、im:chat、contact:user.base:readonly。在「事件与回调」里订阅方式选择「使用长连接接收事件」添加事件im.message.receive_v1。最后记得发布应用版本否则权限不生效。回到终端执行渠道添加命令openclaw channels add按提示选择 Feishu然后粘贴 App ID 和 App Secret。这一步会往 openClaw 的配置里写入飞书渠道信息。如果你想直接看配置文件长什么样openClaw 的主配置通常在~/.openclaw/config.toml具体路径以你的安装为准。一个包含飞书渠道和 TaoToken 模型端点的骨架大概是这样# ~/.openclaw/config.toml [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model gpt-4o-mini [channels.feishu] enabled true app_id cli_xxxxxxxxxxxx app_secret xxxxxxxxxxxxxxxxxxxxxxxx connection_mode websocket这里base_url指向 TaoToken 的 APIapi_key填你在控制台创建的那个 Key。connection_mode设为websocket对应飞书的长连接事件订阅模式。如果你用的是向导openclaw onboard它也会引导你填这些字段效果一样。配置写完后重启 Gatewayopenclaw gateway restart4. 验证请求确认飞书消息真的收发成功Gateway 重启后先看日志openclaw logs --follow如果连接正常日志里会出现类似feishu ws connected和feishu provider ready的行。看到这两条说明 WebSocket 长连接已经建立飞书那边的事件能推过来了。然后去飞书里搜索你刚创建的机器人给它发一条消息比如「你好」。如果这是第一次对话机器人可能会回复一个配对码。这时候需要在本机终端执行一次授权openclaw pairing approve feishu 配对码这是一次性操作配对完成后就能正常聊天了。再发一条消息观察机器人是否正常回复。如果回复内容来自模型说明 TaoToken 的 Key 也生效了整条链路——飞书消息 → WebSocket → openClaw → TaoToken → 模型 → 回复——全部打通。你也可以在 TaoToken 控制台的用量页面看到对应的调用记录确认请求确实走了 TaoToken。这一步能帮你区分是模型调用问题还是飞书连接问题。5. 本篇常见错排查飞书消息发不出去先看这两处配完 App ID 和 Secret 但飞书里发消息没反应最常见的原因是事件订阅没配对。去飞书开放平台的「事件与回调」页面确认两件事一是订阅方式选的是「使用长连接接收事件」二是事件列表里有im.message.receive_v1。这两个漏掉任何一个飞书都不会把消息推给 openClaw。社区排查文档里这个被反复提到属于高频坑。第二个常见问题是 Gateway 没在跑。执行openclaw gateway status如果显示未运行就openclaw gateway restart。有时候配置改完忘了重启Gateway 还在用旧配置自然收不到消息。第三个容易忽略的是模型 Key 的问题。如果飞书消息能收到、机器人也有反应但回复是报错或者空内容大概率是 TaoToken 的 Key 或 base URL 填错了。检查config.toml里的base_url是不是https://taotoken.net/apiapi_key有没有多余空格。可以先用一个简单的 curl 测一下 Key 是否有效curl https://taotoken.net/api/v1/models \ -H Authorization: Bearer sk-你的TaoTokenKey如果返回模型列表说明 Key 没问题问题在 openClaw 配置侧。还有一个细节飞书应用发布后权限变更需要重新发布版本才生效。如果你中途加了权限但没重新发布飞书那边仍然按旧权限处理消息可能被拦截。6. 接入之后把 Key 和渠道管理收拢到一处飞书渠道跑通之后你可能会想接更多渠道比如其他 IM 或者自定义入口。这时候 TaoToken 统一 Key 的好处就体现出来了——不管 openClaw 里加多少个渠道模型调用都走同一个 base URL 和 Key不用每个渠道单独配一遍。换 Key 的时候也只改一个地方。如果你后续要做长期编码或者 Agent 任务可以了解一下 TaoToken 的 Coding Plan适合需要持续调用模型的场景。模型对话相关的调试可以在模型对话页面直接试。API Key 的管理和创建在控制台的 API Keys 页面接入文档里有更详细的参数说明。这几个入口按需取用就行模型对话https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content控制台 API Keyshttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content飞书这边配对码授权是一次性的之后机器人就能正常对话。如果哪天消息又断了先openclaw logs --follow看 WebSocket 有没有重连再检查飞书应用版本有没有被下架或权限被回收。长连接模式的好处是不用管公网回调但前提是 Gateway 进程得活着。