1. 为什么要在飞书里跑一个 OpenClaw 机器人OpenClaw 是一个开源的机器人框架能对接多种即时通讯平台把大模型的对话能力塞进你日常用的聊天工具里。飞书作为企业协作平台开放了自建应用的机器人能力两者结合之后你可以在飞书群里直接 机器人问问题、让它查资料、做总结甚至触发内部工作流。适合谁适合想在企业内部快速验证 AI 助手场景的开发者、运维、产品经理不需要从零写一套对话系统。我试过把 OpenClaw 接到飞书整个链路走下来大概 20 分钟但中间有几个坑事件订阅方式选错、权限没开全、模型通道没配好都会导致机器人“装死”。这篇就把完整路径拆开从飞书开放平台建应用到 OpenClaw 侧填凭证再到用 TaoToken 统一 Key 打通模型调用最后发一条消息验证闭环。你跟着做能跑通一个能收能回的飞书企业机器人。核心检索词先明确OpenClaw 接入飞书、飞书企业机器人搭建、OpenClaw 配置教程。这三个词贯穿全文你搜到这篇说明方向对了。飞书这边需要你有一个企业账号个人版也能建自建应用但发布范围受限OpenClaw 需要跑在一台能访问外网的机器上TaoToken 提供统一的模型 API 通道省去你分别申请各家 Key 的麻烦。下面按顺序来。2. TaoToken 前置准备统一 Key 与 API 通道在动飞书之前先把模型通道搞定。OpenClaw 本身不绑定模型它需要一个兼容 OpenAI 接口的 Base URL 和 Key。TaoToken 的作用就是给你一个统一的入口你不用分别去申请不同厂商的 Key一个 Key 走通所有模型调用。先注册并登录 TaoToken 控制台地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。登录之后进控制台找到 API Keys 管理页面创建一个新的 Key。这个 Key 就是后面 OpenClaw 配置里要填的模型凭证。创建 Key 的时候注意两点一是给它起个能认出来的名字比如openclaw-feishu方便后面排查二是创建后立刻复制保存页面刷新后就看不到完整 Key 了。如果你之前已经有 Key也可以直接用但建议为 OpenClaw 单独建一个出问题好定位。TaoToken 的 API 端点固定为 https://taotoken.net/api 这个地址在 OpenClaw 的模型配置里会用到。它兼容 OpenAI 的/v1/chat/completions格式所以 OpenClaw 里选 OpenAI 兼容模式就行。模型 ID 怎么选如果你只是做飞书机器人的日常问答选一个通用对话模型即可比如gpt-4o-mini这类性价比高的。如果你要做代码相关的机器人可以选 coding 专用的模型。TaoToken 控制台的模型列表里能看到当前可用的模型 ID直接复制那个字符串填进去。这里有个容易忽略的点OpenClaw 的模型配置和飞书配置是分开的。很多人飞书那边配好了机器人也上线了但发消息没回复就是因为模型通道没通。所以先把 TaoToken 的 Key 和 Base URL 准备好放在手边下一步直接填。另外TaoToken 的 Coding Plan 适合长期跑编码类 Agent 的场景如果你打算让飞书机器人承担代码审查、自动补全这类任务可以了解一下 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。普通对话场景用按量计费的 API Key 就够了。3. 可复制配置飞书应用 OpenClaw 参数模板这一节是全文的核心操作区分三块飞书开放平台建应用、OpenClaw 侧填凭证、模型通道配置。每一块我都给出可复制的配置片段你照着填。3.1 飞书开放平台创建自建应用打开飞书开放平台 https://open.feishu.cn 登录后进开发者后台。点「创建应用」→「企业自建应用」。应用名称填OpenClaw助手图标随意选一个点创建。进入应用管理页后左侧导航栏找到「添加应用能力」在列表里选「机器人」点添加。这一步是让应用具备收发消息的能力不加的话后面事件订阅里看不到消息相关的事件。接着去「凭据与基础信息」页面复制两个值App ID和App Secret。这两个就是 OpenClaw 连接飞书的凭证。先放在记事本里下面马上要用。3.2 OpenClaw 侧添加飞书 Channel回到你的终端运行openclaw channels add在交互式选项里选择「飞书」然后依次粘贴刚才复制的 App ID 和 App Secret回车确认最后选 Finish。这一步做完之后OpenClaw 的配置文件里会多出一段飞书 channel 的配置。你可以打开配置文件确认一下路径通常在~/.openclaw/config.toml或项目目录下的config.toml。配置片段大概长这样[[channels]] type feishu app_id cli_xxxxxxxxxxxx app_secret xxxxxxxxxxxxxxxxxxxxxxxx注意App ID 通常以cli_开头App Secret 是一串随机字符。如果你填反了后面长连接会建不起来。3.3 配置模型通道TaoToken 统一 KeyOpenClaw 的模型配置在同一个配置文件里找到[model]或[[models]]段落填入 TaoToken 的 Base URL 和 Key[model] provider openai base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model_id gpt-4o-mini如果你用的是 JSON 格式的配置比如某些版本的 OpenClaw 用settings.json对应片段是{ model: { provider: openai, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, modelId: gpt-4o-mini } }三个关键值再强调一遍Base URL 是https://taotoken.net/apiAPI Key 是你从 TaoToken 控制台复制的那个Model ID 按你实际选的填。这三个缺一不可后面验证请求的时候会用到。3.4 飞书事件订阅与权限配置回到飞书开放平台的应用管理页左侧找到「事件与回调」。事件配置里订阅方式选「使用长连接」点保存。如果提示「未建立长连接」说明 OpenClaw 那边的飞书 channel 没配好回去检查 App ID 和 App Secret。然后点「添加事件」在「消息与群组」分类下勾选「接收消息」确定。回调设置同样选「使用长连接」不需要填回调地址长连接模式下飞书会主动推事件到你的 OpenClaw 进程。权限管理页面点「开通权限」至少勾选以下几项im:message收发消息、im:message:send_as_bot以机器人身份发消息、im:chat获取群信息。如果你需要机器人读云文档或多维表格再额外加对应权限。不确定的话可以用「批量导入权限」功能粘贴一段 JSON 权限清单。最后去「版本管理与发布」创建版本填版本号和描述保存并发布。发布后需要企业管理员审批如果是企业账号个人版一般直接生效。3.5 启动 OpenClaw Gateway配置完成后在终端运行openclaw gateway这个命令会启动 OpenClaw 的网关进程保持长连接。不要关掉这个终端窗口关了机器人就掉线了。启动成功后你会在日志里看到飞书 channel 已连接、模型通道已就绪的提示。4. 验证请求发一条消息看机器人是否回复配置全部完成后验证动作很简单打开飞书手机端或桌面端都行登录和开发者平台相同的账号。在飞书首页的聊天列表里应该能看到你刚创建的机器人应用。如果没有去「工作台」里找找到你发布的应用点进去会自动打开私聊窗口。发送任意一条消息比如「你好介绍一下你自己」。如果机器人回复了内容说明整条链路通了飞书事件推送到 OpenClaw → OpenClaw 调用 TaoToken 的模型 API → 模型返回结果 → OpenClaw 通过飞书发回消息。如果没回复先看 OpenClaw 的终端日志。常见的情况是日志里显示收到了飞书事件但调用模型时报错。这时候重点检查模型配置里的 Base URL 和 Key。你可以单独用 curl 测一下 TaoToken 的通道是否通curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: ping}] }如果这个请求返回了正常的 JSON 响应说明 TaoToken 通道没问题问题在 OpenClaw 的配置或飞书事件订阅上。如果这个请求报 401说明 Key 不对报 404说明 Base URL 或路径不对。验证通过后你可以试着把机器人拉进一个群 它提问看群聊场景下是否正常。群聊需要额外确认机器人的可见范围设置在飞书应用管理页的「机器人」配置里可以设置机器人可被哪些群添加。5. 本篇常见错排查401、长连接失败、choices 读取异常这一节列几个真实会撞上的报错对照着排查。报错一401 Unauthorized这是模型通道的认证失败。原因通常是 TaoToken 的 API Key 填错、过期或者 Key 前面少了sk-前缀。检查 OpenClaw 配置文件里的api_key字段确认和 TaoToken 控制台里复制的一致。如果你在控制台重新生成过 Key旧 Key 会失效需要同步更新配置。报错二local proxy failed / 长连接未建立飞书事件配置页面提示「未建立长连接」或者 OpenClaw 日志里显示飞书连接失败。先确认openclaw gateway进程还在跑没有意外退出。然后检查 App ID 和 App Secret 是否填反。飞书的 App ID 以cli_开头App Secret 不是。如果这两个值没错检查你的机器网络是否能正常访问飞书开放平台的接口。长连接模式下不需要公网回调地址但需要能出站访问飞书的服务器。报错三reading choices 或模型返回格式异常OpenClaw 日志里出现类似Cannot read properties of undefined (reading choices)的错误说明模型 API 返回的结构不符合预期。常见原因是 Base URL 填成了https://taotoken.net而漏了/api或者填成了/api/v1导致路径重复。正确的 Base URL 是https://taotoken.net/apiOpenClaw 会自动拼接/v1/chat/completions。如果你在配置里手动加了/v1就会变成/api/v1/v1/chat/completions导致 404 或返回非标准结构。报错四OAuth 相关错误如果你在飞书侧看到 OAuth 授权失败检查应用的权限范围是否包含了需要的 scope。另外飞书自建应用的凭证是 App ID App Secret不需要走 OAuth 授权码流程。如果你在 OpenClaw 配置里填了 OAuth 相关的字段删掉只保留 app_id 和 app_secret。报错五机器人收到消息但不回复日志显示收到了飞书事件但模型调用没有触发。检查 OpenClaw 的模型配置段是否被正确加载。有些版本的 OpenClaw 要求模型配置放在特定的 section 下比如[model]而不是[[models]]。另外确认model_id填的是 TaoToken 支持的模型 ID填了一个不存在的模型名也会导致调用失败。排查顺序建议先 curl 测 TaoToken 通道 → 再确认 OpenClaw 配置文件格式 → 再看飞书事件订阅状态 → 最后看权限和发布状态。按这个顺序大部分问题能定位到。6. 接入之后把机器人用起来的几个方向机器人跑通之后你可以做的第一件事是把它拉进团队群让它承担一些重复性问答。比如把内部文档的常见问题整理成提示词机器人就能在群里自动回复。OpenClaw 支持自定义指令和插件你可以在它的配置里加一些预设的 prompt 模板让机器人针对不同关键词返回不同内容。第二个方向是接内部系统。飞书机器人可以通过事件回调触发外部 API比如查工单状态、查库存、触发部署流水线。OpenClaw 的 channel 层收到消息后你可以写一个简单的 handler 去调用内部接口再把结果返回给飞书。这部分需要一点开发工作但 OpenClaw 的插件机制不算复杂。第三个方向是模型切换。TaoToken 的统一 Key 让你可以在不改代码的情况下切换底层模型。比如日常问答用便宜的模型遇到代码问题自动切到 coding 专用模型。你可以在 OpenClaw 的配置里配多个模型按规则路由。Coding Plan 适合这种需要长期跑、调用量大的场景地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你在配置过程中卡住了TaoToken 的接入文档里有各语言的调用示例地址是 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。API Keys 管理页面在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 需要新建或轮换 Key 的时候去那里操作。想先试试模型对话效果可以直接用 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 快速验证。最后提醒一句openclaw gateway进程需要保持运行生产环境建议用 systemd 或 supervisor 托管避免终端关闭后机器人掉线。飞书应用发布后如果改了权限或事件配置需要重新创建版本并发布才能生效。