★ FEATURED ARTICLE 1. 飞书机器人消息通道为什么总配不通从 OpenClaw 插件到 Python 事件订阅的完整链路飞书插件接入 OpenClaw 这件事卡人的地方从来不是某一行代码而是链路太长飞书开放平台建应用、导权限、配事件回调、发版本再到 OpenClaw 侧填 App ID / App Secret、跑 WebSocket 长连接、处理 pairing 审批中间任何一环没对齐表现都是「机器人不回消息」。我试过最典型的一次权限全勾了、脚本也跑起来了手机发消息过去只回一句access not configured折腾半天才发现是 pairing code 没在部署机上执行。这篇聚焦 OpenClaw 接入飞书插件的配置流程面向需要让机器人稳定收发消息的 Python 开发者。核心思路是飞书侧负责应用凭证和事件订阅OpenClaw 侧负责消息路由和模型调用而模型调用的 Key 用 TaoToken 统一管理这样你换模型、加通道都不用改飞书那边的任何配置。OpenClaw 2026.3.13 这个版本自带飞书插件不需要手动装省了一步。适合谁看本地有 Python 运行环境、想让飞书机器人接上大模型做消息回环的开发者已经建好飞书应用但卡在事件订阅或 pairing 环节的人以及想把多个通道的 Key 收敛到一处的团队。下面按「飞书应用 → 权限 → 事件脚本 → OpenClaw 配置 → TaoToken Key → 回环验证 → 排错」的顺序走一遍每一步都给可复制片段。先说清楚整体数据流不然后面容易懵飞书用户发消息 → 飞书开放平台通过事件回调WebSocket 长连接推给你的 Python 脚本或 OpenClaw → OpenClaw 把消息交给配置好的模型通道 → 模型返回 → OpenClaw 调飞书发消息接口回给用户。TaoToken 的位置在「模型通道」这一环它提供统一的 Base URL 和 KeyOpenClaw 里所有需要模型的地方都指向它飞书侧完全无感。2. TaoToken 前置准备统一 Key 在 OpenClaw 飞书插件里的填写位置在动飞书后台之前先把 TaoToken 这边的凭证拿到因为 OpenClaw 配置模型通道时会用到顺序反了容易来回切页面。TaoToken 是一个模型调用聚合入口你拿到一个 Base URL 和一个 API Key就能在 OpenClaw 里配置模型通道不用为每个模型单独申请。第一步打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录。登录后进控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 在控制台里能看到账户余额和用量。第二步创建 API Key。进 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 点新建复制生成的 Key。这个 Key 只显示一次建议先存到本地环境变量或密码管理器里。注意 API 端点本身是 https://taotoken.net/api 不带任何查询参数配置 Base URL 时用这个。第三步确认你要用的模型 ID。进模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 可以看到当前可用的模型列表记下你要在 OpenClaw 里用的那个 Model ID后面配置里要填。这里有个关键点OpenClaw 的飞书插件配置和模型通道配置是两套东西。飞书插件管的是「消息怎么进来、怎么出去」模型通道管的是「消息进来后交给谁处理」。TaoToken 的 Key 填在模型通道那一侧不是填在飞书应用凭证里。很多人第一次配会把 App Secret 和 API Key 搞混记住飞书那对是cli_xxx和xxx开头的TaoToken 的 Key 是另一串。如果你后面要长期跑编码类或 Agent 类任务可以看下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它更适合高频调用场景。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 配置遇到不确定的参数可以对照查。3. 可复制配置飞书权限 JSON、事件订阅 Python 脚本与 OpenClaw 通道片段这一节是全文最实操的部分三块配置按顺序来飞书权限、事件订阅脚本、OpenClaw 通道配置。3.1 飞书应用创建与权限批量导入先到飞书开放平台 https://open.feishu.cn/app 创建应用没有账号用手机号注册。个人账号就能用企业账号会多一道管理员审核自己测试建议先用个人账号。创建完进「权限管理」用「批量导入/导出权限」把下面这段 JSON 粘进去全部覆盖。这段权限覆盖了消息收发、卡片、通讯录读取等飞书机器人常用能力{ scopes: { tenant: [ aily:file:read, aily:file:write, application:application.app_message_stats.overview:readonly, application:application:self_manage, application:bot.menu:write, cardkit:card:read, cardkit:card:write, contact:user.employee_id:readonly, corehr:file:download, event:ip_list, im:chat.access_event.bot_p2p_chat:read, im:chat.members:bot_access, im:message, im:message.group_at_msg:readonly, im:message.p2p_msg:readonly, im:message:readonly, im:message:send_as_bot, im:resource ], user: [ aily:file:read, aily:file:write, im:chat.access_event.bot_p2p_chat:read ] } }导入后记得点保存权限不会自动生效需要发布版本后才起作用。3.2 事件订阅 Python 脚本飞书的事件订阅支持 WebSocket 长连接模式本地跑一个 Python 脚本就能接收事件不用公网地址。先装 SDKpip install lark-oapi然后建一个feishu_event.py下面这段代码有三处要改out_approval是自定义事件名按你实际需求填、cli_a931791629645c11换成你的 App ID、xJnrDB3dewT7BpHJvzX8mg4h4LAD56c5换成你的 App Secret。App ID 和 App Secret 在飞书后台左侧「凭证与基础信息」里。import lark_oapi as lark # P2ImMessageReceiveV1 为接收消息 v2.0CustomizedEvent 内的 message 为接收消息 v1.0 def do_p2_im_message_receive_v1(data: lark.im.v1.P2ImMessageReceiveV1) - None: print(f[ do_p2_im_message_receive_v1 access ], data: {lark.JSON.marshal(data, indent4)}) def do_message_event(data: lark.CustomizedEvent) - None: print(f[ do_customized_event access ], type: message, data: {lark.JSON.marshal(data, indent4)}) event_handler lark.EventDispatcherHandler.builder(, ) \ .register_p2_im_message_receive_v1(do_p2_im_message_receive_v1) \ .register_p1_customized_event(out_approval, do_message_event) \ .build() def main(): cli lark.ws.Client( cli_a931791629645c11, xJnrDB3dewT7BpHJvzX8mg4h4LAD56c5, event_handlerevent_handler, log_levellark.LogLevel.DEBUG ) cli.start() if __name__ __main__: main()跑起来python feishu_event.py脚本运行后回到飞书后台「事件与回调」点保存。注意不运行脚本直接点保存会失败因为飞书要验证长连接是否可达。脚本跑着的时候点保存看到连接建立成功的提示才算过。3.3 OpenClaw 通道配置片段OpenClaw 侧用openclaw configure进入配置流程按提示填。飞书插件部分需要填 App ID 和 App Secret模型通道部分填 TaoToken 的 Base URL、Key 和 Model ID。配置文件的典型结构路径以你本地实际为准通常在~/.openclaw/config.toml或项目目录下[channels.feishu] enabled true app_id cli_你的AppID app_secret 你的AppSecret [models.default] base_url https://taotoken.net/api api_key 你的TaoTokenKey model 你的ModelID如果你用的是 JSON 格式的配置部分版本走settings.json对应片段{ channels: { feishu: { enabled: true, app_id: cli_你的AppID, app_secret: 你的AppSecret } }, models: { default: { base_url: https://taotoken.net/api, api_key: 你的TaoTokenKey, model: 你的ModelID } } }三件套对齐检查Base URL 是https://taotoken.net/apiKey 是 API Keys 页面拿的那串Model ID 是模型对话页面看到的那个。这三个填错任何一个表现都是模型不响应。4. 验证请求一条飞书消息回环确认通道是否生效配置完别急着庆祝先做一次最小回环验证。步骤是发布飞书应用版本 → 手机飞书给机器人发消息 → 看返回。发布版本飞书后台「版本管理与发布」按提示填版本号和说明提交发布。个人账号一般即时生效企业账号要等管理员审核。发消息测试在飞书里找到你的机器人发一句「你好」。正常情况下第一次会收到这样的回复OpenClaw: access not configured. Your Feishu user id: ou_56ddf7e49f46又97ee4a4ddce8013 Pairing code: B76LVF2Q Ask the bot owner to approve with: openclaw pairing approve feishu B76LVF2Q这不是报错是 OpenClaw 的配对机制陌生用户第一次发消息需要 owner 审批。把最后那行命令拿到部署 OpenClaw 的机器上执行openclaw pairing approve feishu B76LVF2Q执行完再发一条消息这次应该能收到模型的实际回复。如果收到回复说明整条链路通了飞书事件 → OpenClaw → TaoToken 模型通道 → 模型返回 → 飞书发消息。验证模型通道是否真的走了 TaoToken可以看 OpenClaw 的日志正常会有指向taotoken.net/api的请求记录。也可以直接在模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 发一条测试确认 Key 本身可用排除是 Key 的问题还是 OpenClaw 配置的问题。回环验证通过后建议再测一次群聊场景把机器人拉进群它发消息确认im:message.group_at_msg:readonly这类权限生效。群聊和单聊走的事件类型不同单聊通了不代表群聊通。5. 本篇常见错排查401、local proxy failed、reading choices 与 OAuth 报错对照配飞书插件踩的坑基本集中在几个固定报错上逐个对照。401 Unauthorized模型通道返回 401说明 TaoToken 的 Key 不对或没带上。检查api_key字段是不是完整复制了有没有多余空格确认 Base URL 是https://taotoken.net/api而不是别的路径。如果 Key 刚创建确认没被删除或禁用。飞书侧的 401 则是 App ID / App Secret 错两边的 401 要分清来源看日志里请求打到了哪个域名。local proxy failed这个报错通常出现在 OpenClaw 尝试走本地代理连模型时。检查配置里有没有残留的 proxy 设置把模型通道的 base_url 直接指向https://taotoken.net/api不要经过任何中间层。同时确认本机网络能正常访问该域名用 curl 测一下curl -I https://taotoken.net/apireading choices 相关报错这类报错一般是模型返回结构不符合预期常见原因是 Model ID 填错或者填了一个当前账户没权限的模型。回模型对话页面确认 Model ID 拼写注意大小写。如果返回体里choices为空多半是模型侧限流或参数问题换一个模型 ID 试。OAuth / 授权类报错飞书侧出现授权失败检查权限 JSON 是否完整导入、版本是否已发布。权限改了不发布版本等于没改。另外确认事件订阅用的是长连接模式脚本在跑。pairing 一直不生效openclaw pairing approve feishu XXX执行了但还提示未配置检查执行的机器是不是部署 OpenClaw 的那台pairing code 有没有过期重新发消息会生成新的。code 区分大小写复制时别漏字符。消息发出去了但机器人不回先看 Python 事件脚本有没有打印事件日志有日志说明飞书推过来了问题在 OpenClaw 到模型这一段没日志说明事件订阅没配好回去检查脚本是否在跑、保存是否成功。排障时优先用接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 对照参数比盲试快。6. 把 Key 收敛到一处飞书插件长期运行的配置建议飞书插件跑通只是开始长期运行要考虑的是 Key 管理和多通道扩展。把模型 Key 统一放在 TaoToken 这一层好处是飞书、其他消息通道、编码工具都指向同一个 Base URL 和 Key换模型只改一个 Model ID不用每个通道改一遍。如果你后面要接 Claude Code 这类编码工具配置逻辑是一样的三件套Base URL 填https://taotoken.net/apiKey 填 API Keys 页面那串Model ID 按需选。相关接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 照着填就行。日常维护上建议把 Key 放环境变量而不是硬编码在配置文件里避免提交到仓库。飞书侧的 App Secret 同理。事件脚本用 systemd 或 supervisor 托管别用前台终端跑断了就收不到消息。最后给一个实用技巧飞书后台的「事件与回调」页面能看到事件推送记录消息没回时先看这里有没有推送记录能快速定位是飞书侧还是 OpenClaw 侧的问题。这个页面比翻日志直观。
阅读完成 · 觉得有帮助？
