1. 飞书群里那个“秒回”的 AI 助手到底怎么接进去的飞书集成 AI 助手这件事说穿了就是把「飞书开放平台的事件订阅」和「你自己的 AI 服务」用一条 HTTP 通道连起来。用户在群里 一下机器人飞书把这条消息推给你的服务你的服务调用大模型生成回复再通过飞书 API 把消息发回群里。整条链路里最容易被卡住的不是代码而是三件事飞书应用权限没开全、事件订阅地址填错、以及多模型调用时 Key 散落在各个脚本里没法统一管理。这篇要解决的就是最后那个问题顺带把前两个坑一起填了。场景很具体你所在的企业已经在用飞书团队希望有一个能回答内部知识、能查多维表格、能写文档的 AI 助手而不是每个人各自去某个网页里复制粘贴。OpenClaw 作为集成框架负责把飞书消息路由到 AI 能力TaoToken 负责把多模型调用的 Key 和 API 通道统一收口——你不需要在飞书侧、OpenClaw 侧、脚本侧各维护一套密钥。适合谁看已经会用飞书开放平台建应用、但被多模型 Key 管理搞烦的开发者或者刚接触 OpenClaw、想找一个能跑通的最小闭环的工程师。读完你应该能拿到一份可复制的 config.toml 片段、一条能触发 AI 回复的验证动作以及五个最常见的报错排查路径。2. 前置准备TaoToken 统一 Key 与 OpenClaw 的接入位置在动手配飞书之前先把模型调用这一层理顺。OpenClaw 本身不绑定某一家模型它通过 OpenAI 兼容的接口去调模型。TaoToken 提供的就是这样一个统一入口你拿一个 Key就能在同一个 API 通道里切换不同模型不用为每个模型单独申请账号、单独记 Key。具体操作上先去控制台创建一个 API Key。地址是 https://taotoken.net/api-keys 登录后点创建复制出来的字符串就是后面 config.toml 里要填的api_key。这个 Key 的权限范围建议只勾选模型调用不要给多余的权限。拿到 Key 之后OpenClaw 侧的模型配置就变得很干净。你不需要在飞书应用里配任何模型相关的信息飞书只负责消息进出模型调用全部走 TaoToken 这一层。这样做的好处是以后要换模型、要加一个备用模型、要按部门分配不同的模型额度都只改 OpenClaw 的配置飞书那边完全不用动。如果你还没装 OpenClaw可以先看接入文档 https://taotoken.net/doc 里的环境准备部分把基础运行环境跑起来。装好之后OpenClaw 的配置文件默认在~/.openclaw/config.toml没有的话手动建一个。3. 可复制配置飞书应用骨架 OpenClaw config.toml3.1 飞书开放平台侧应用与事件订阅打开 https://open.feishu.cn/app 创建「企业自建应用」。填应用名称比如OpenClaw Assistant创建完进入应用详情页。第一步在「凭证与基础信息」里拿到两个值App ID形如cli_xxxxxxxx和 App Secret。这两个后面要填进 OpenClaw 配置。第二步在「添加应用能力」里启用「机器人」。这一步不做的话后面发消息会直接报bot is not enabled。第三步在「权限管理」里开通以下权限。少一个都可能在运行时报权限错误权限名称权限标识用途获取与发送单聊、群组消息im:message收发消息读取消息im:message:readonly读取消息内容获取与编辑云文档docx:document操作文档获取与编辑多维表格bitable:app操作表格获取与编辑知识库wiki:space操作 Wiki第四步在「事件订阅」里添加事件im.message.receive_v1。请求地址先留空等 OpenClaw 跑起来拿到公网地址后再回来填。这里有个细节飞书要求请求地址必须是 HTTPS本地开发可以用内网穿透工具临时映射一个域名但生产环境建议直接部署在有公网 IP 的服务器上。第五步在「版本管理与发布」里创建版本并发布把应用添加到目标飞书群或单聊里。只有发布后的应用才能被群成员 到。3.2 OpenClaw 侧config.toml 完整片段下面这份配置可以直接复制把尖括号里的值替换成你自己的# ~/.openclaw/config.toml [model] # TaoToken 统一 API 通道 base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 # 默认模型可按需切换 default_model claude-sonnet-4-20250514 # 备用模型主模型不可用时自动降级 fallback_model gpt-4o-mini [feishu] enabled true app_id cli_你的AppID app_secret 你的AppSecret # 机器人名称用于日志和消息署名 bot_name OpenClaw # 事件订阅回调路径需与飞书后台填写的地址一致 webhook_path /feishu/event # 允许的操作 allowed_actions [ read_message, send_message, read_doc, write_doc, read_bitable, write_bitable ] [server] # OpenClaw 监听端口 port 8080 # 公网地址飞书事件订阅填这个 public_url https://your-domain.com配置里base_url指向 TaoToken 的 API 地址api_key就是你在控制台创建的那把 Key。default_model和fallback_model可以按你实际订阅的模型来改TaoToken 的模型列表在控制台里能看到。改完配置后启动 OpenClawopenclaw start --config ~/.openclaw/config.toml启动日志里会打印监听端口和 webhook 路径。确认没有报错后回到飞书开放平台的事件订阅页面把请求地址填成https://your-domain.com/feishu/event保存并等待飞书发送验证请求。验证通过后事件订阅状态会变成「已启用」。4. 验证请求一条消息触发 AI 回复配置完成后最直接的验证方式是在飞书群里 一下机器人。但为了排除飞书侧的干扰建议先用 curl 直接打 OpenClaw 的 webhook确认服务本身能正常处理消息。curl -X POST https://your-domain.com/feishu/event \ -H Content-Type: application/json \ -d { schema: 2.0, header: { event_id: test_001, event_type: im.message.receive_v1, create_time: 1700000000000, token: test_token, app_id: cli_你的AppID, tenant_key: test_tenant }, event: { sender: { sender_id: {open_id: ou_test_user}, sender_type: user }, message: { message_id: om_test_msg, chat_id: oc_test_chat, chat_type: group, message_type: text, content: {\text\:\OpenClaw 你好帮我总结一下今天的待办\} } } }如果 OpenClaw 正常处理你会看到类似这样的日志[feishu] received message from ou_test_user in oc_test_chat [model] calling claude-sonnet-4-20250514 via taotoken [model] response received, length156 [feishu] message sent to oc_test_chat然后在飞书群里就能看到机器人回复了。如果日志里[model]那行报错说明 TaoToken 的 Key 或 base_url 有问题如果[feishu]那行报错说明飞书应用权限或事件订阅没配对。验证通过后你可以试着在群里发一条更复杂的消息比如「OpenClaw 把这条消息记到多维表格里」看看 OpenClaw 能不能正确路由到feishu_bitable能力。这一步能跑通说明整条链路已经打通。5. 本篇常见错排查5.1 报错bot is not enabled这个报错说明飞书应用没有启用机器人能力。回到开放平台应用详情页点「添加应用能力」找到「机器人」并启用然后重新发布版本。注意启用能力后必须重新发布否则线上应用不会生效。5.2 报错app permission denied多维表格或文档操作时报这个错通常是应用没有被授予对应资源的权限。打开目标多维表格点右上角「...」→「设置」→「权限管理」把 OpenClaw 应用添加进去并授予编辑权限。文档同理需要在文档的分享设置里把应用加为协作者。5.3 消息发送成功但群里看不到先确认机器人已经被添加到目标群。飞书机器人不会自动出现在群里需要群管理员手动添加。其次检查chat_id是否正确群聊的chat_id以oc_开头单聊的open_id以ou_开头两者不能混用。最后检查是否触发了飞书的限流短时间内发送大量消息会被临时拦截。5.4 文档 token 无效飞书文档有两种 token 格式新版云文档的 token 是纯字符串旧版文档的 token 以docx_开头。如果你从旧文档复制链接拿到的可能是旧格式 token直接传给feishu_doc会报无效。解决办法是从新版文档的 URL 里提取 token或者用feishu_doc的list_blocks动作先确认 token 类型。5.5 消息卡片显示不完整飞书卡片有硬性限制最多 20 个元素单个元素内容不超过 2000 字符整个卡片不超过 30KB。如果你的卡片内容超了飞书会截断显示。解决办法是把长内容拆成多条消息或者用折叠面板把次要信息收起来。6. 把 Key 收口之后飞书助手才算真正可维护飞书集成 AI 助手这件事配通一次不难难的是配通之后还能长期维护。我见过太多团队第一版跑通之后模型 Key 散落在三个脚本里换一个模型要改五处配置最后没人敢动。用 TaoToken 统一 Key 和 API 通道之后模型调用这一层被收口到 OpenClaw 的 config.toml 里飞书侧只负责消息进出职责边界清晰。如果你后面要做更复杂的场景比如按部门分配不同模型、给不同群设置不同的系统提示词、或者加一个备用模型做降级都只需要改 OpenClaw 的配置。飞书应用本身不用重新发布事件订阅也不用动。这种「一次配通、后续只改一处」的结构才是企业级助手能持续迭代的前提。下一步可以试试把定时任务接进来让助手每天早上自动推送日报到群里。OpenClaw 的 cron 能力配合飞书消息卡片能做出比手动 更省事的自动化流程。模型调用依然走 TaoToken 这一层你不需要为定时任务单独配 Key。