1. OpenClaw 2.7.9 对接飞书机器人到底解决什么问题OpenClaw 2.7.9 是一个可以在本地运行的 AI 客户端它本身支持多渠道接入飞书机器人就是其中一个渠道。把 OpenClaw 2.7.9 和飞书机器人对接起来本质上是让飞书群聊里多一个能理解自然语言、能调用大模型能力的机器人成员。你在飞书群里 它它就能回复你给它发一段需求它能帮你整理成结构化内容。适合谁适合那些团队日常沟通已经在飞书里完成、又希望把 AI 能力直接嵌进群聊工作流的开发者和小团队。我试过把 OpenClaw 2.7.9 的飞书渠道跑通整个链路其实不复杂核心就三件事飞书开放平台建一个企业自建应用、拿到 App ID 和 App Secret、把这两组凭证填进 OpenClaw 的渠道配置里。真正容易卡住的地方不在 OpenClaw 本身而在飞书开放平台的事件订阅方式和权限配置。很多人第一次配的时候选了服务器回调模式结果本地没有公网地址消息根本推不过来。OpenClaw 2.7.9 的飞书渠道用的是长连接接收事件不需要你部署 webhook 回调地址本地电脑开着客户端就能稳定收消息。这篇文章会按完整落地流程走一遍先讲安装包怎么拿、OpenClaw 2.7.9 怎么确认 Gateway 在线再讲飞书开放平台从创建应用到发布版本的每一步然后给出一份可以直接复制的权限 JSON 配置接着是 OpenClaw 客户端里填 App ID 和 App Secret 的具体位置最后用一条真实消息验证收发链路并把常见的 401、长连接失败、事件订阅不生效等问题逐个排查。你跟着做基本能一次跑通。需要提前说明的是OpenClaw 2.7.9 的飞书渠道配置里除了飞书自己的 App ID 和 App Secret如果你希望机器人背后调用的是稳定的大模型能力还需要在 OpenClaw 里配置模型侧的 Base URL、API Key 和 Model ID。这部分我会在第三节给出可复制的配置片段方便你直接对照填写。2. OpenClaw 2.7.9 安装包获取与飞书开放平台前置准备2.1 安装包获取与客户端启动确认OpenClaw 2.7.9 的安装包按系统分两个渠道下载后解压即可部署压缩包整体约 45.8MB内置运行依赖。建议用浏览器自带下载工具避免第三方下载器把压缩包下坏。安卓版本安装包地址https://xiake.yun/api/download/package/18?promoCodeIV4E9B04A80C苹果系统版本安装包地址https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C下载完成后先核对文件大小是否在 45.8MB 左右如果明显偏小说明下载中断重新下。解压后启动 OpenClaw 2.7.9 客户端确认主界面能正常打开并且 Gateway 服务显示在线。Gateway 是 OpenClaw 接收和转发消息的核心服务如果它没起来后面飞书的消息推过来也没人处理。2.2 飞书开放平台账号与企业空间准备飞书机器人对接需要一个能登录飞书开放平台的开发者账号以及一个可用的飞书企业或组织空间。个人开发者可以用个人空间创建自建应用企业主体发布应用版本时需要管理员审核。如果你是在公司飞书空间里操作提前确认自己有创建企业自建应用的权限否则走到发布版本那一步会被卡住。飞书开发者后台地址是https://open.feishu.cn/app登录后能看到应用列表右上角有创建企业自建应用的入口。这里不需要你提前准备公网域名或服务器因为 OpenClaw 2.7.9 走的是长连接模式本地电脑就能跑。2.3 模型侧凭证准备Base URL API Key Model IDOpenClaw 2.7.9 的飞书渠道负责消息收发但机器人回复的内容需要由大模型生成。所以除了飞书的 App ID 和 App Secret你还需要准备模型侧的接入信息。这里以 TaoToken 为例它提供兼容 OpenAI 风格的接口配置时三件套是Base URLhttps://taotoken.net/apiAPI Key在 TaoToken 控制台创建Model ID按你实际使用的模型填写API Key 的创建入口在控制台的 API Keys 页面模型对话调试入口在模型对话页面。如果你打算长期跑编码类或 Agent 类任务可以看 Coding Plan 页面它更适合持续调用场景。这些入口我都会在第三节的配置片段里对应标注。注意飞书开放平台的 App ID 和 App Secret 是飞书侧的凭证TaoToken 的 API Key 是模型侧的凭证两者不要混填。飞书凭证填在 OpenClaw 的 Feishu/Lark 渠道配置里模型凭证填在 OpenClaw 的模型配置里。3. 飞书开放平台应用配置与 OpenClaw 渠道填写全流程3.1 创建企业自建应用并开启机器人能力进入飞书开发者后台后选择创建企业自建应用支持空白创建和智能体模板创建两种方式。空白创建更干净后面按需加能力就行。创建时填写机器人名称、应用描述上传头像。头像支持 JPEG、PNG、SVG、BMP 格式文件体积控制在 2MB 以内分辨率不低于 240×240px。创建完成后进入应用详情页左侧菜单找到【添加应用能力】在能力列表里检索机器人并添加。这一步是消息收发的基础没有机器人能力后面的事件订阅配了也不会生效。3.2 事件订阅切换为长连接并添加消息接收事件左侧导航栏打开【事件与回调】在事件配置栏目点击订阅方式后面的编辑按钮。订阅方式选择【使用长连接接收事件】不要选服务器回调模式。OpenClaw 2.7.9 的飞书渠道就是按长连接协议适配的选错模式会导致消息推不过来。保存订阅规则后点击添加事件检索关键词【接收】勾选im.message.receive_v1接收消息 v2.0并确认添加。这个事件是机器人实现消息交互的必备配置项少了它机器人收不到任何群聊消息。弹出权限推荐弹窗时一键确认开通然后核对事件绑定权限列表所有权限状态必须显示已开通。如果有缺失手动补充开启。3.3 批量导入权限 JSON 配置打开权限管理页面选择批量导入/导出权限清空页面原有默认 JSON 内容粘贴下面这份完整权限配置{ scopes: { tenant: [ aily:message:read, aily:message:write, base:app:copy, base:app:create, base:app:read, base:app:update, base:collaborator:create, base:collaborator:delete, base:collaborator:read, base:dashboard:copy, base:dashboard:read, base:field:create, base:field:delete, base:field:read, base:field:update, base:form:read, base:form:update, base:record:create, base:record:delete, base:record:read, base:record:retrieve, base:record:update, base:role:create, base:role:delete, base:role:read, base:role:update, base:table:create, base:table:delete, base:table:read, base:table:update, base:view:read, base:view:write_only, bitable:app, bitable:app:readonly, board:whiteboard:node:create, board:whiteboard:node:delete, board:whiteboard:node:read, board:whiteboard:node:update, cardkit:card:write, contact:contact.base:readonly, contact:user.base:readonly, contact:user.employee_id:readonly, contact:user.employee_number:read, contact:user.id:readonly, docs:doc, docs:doc:readonly, docs:document.comment:create, docs:document.comment:read, docs:document.comment:update, docs:document.comment:write_only, docs:document.content:read, docs:document.media:download, docs:document.media:upload, docs:document.subscription, docs:document.subscription:read, docs:document:copy, docs:document:export, docs:document:import, docs:event.document_deleted:read, docs:event.document_edited:read, docs:event.document_opened:read, docs:event:subscribe, docs:permission.member, docs:permission.member:auth, docs:permission.member:create, docs:permission.member:delete, docs:permission.member:readonly, docs:permission.member:retrieve, docs:permission.member:transfer, docs:permission.member:update, docs:permission.setting, docs:permission.setting:read, docs:permission.setting:readonly, docs:permission.setting:write_only, docx:document, docx:document.block:convert, docx:document:create, docx:document:readonly, drive:drive, drive:drive.metadata:readonly, drive:drive.search:readonly, drive:drive:readonly, drive:drive:version, drive:drive:version:readonly, drive:export:readonly, drive:file, drive:file.like:readonly, drive:file.meta.sec_label.read_only, drive:file:download, drive:file:readonly, drive:file:upload, drive:file:view_record:readonly, event:ip_list, im:app_feed_card:write, im:chat, im:chat.members:read, im:chat:read, im:message, im:message.group_msg, im:message:send_as_bot, im:message:readonly, im:message:update, sheets:spreadsheet, sheets:spreadsheet:create, sheets:spreadsheet:read, space:folder:create, wiki:node:create, wiki:node:read, wiki:node:update, wiki:space:read ], user: [] } }粘贴完成后点击下一步确认新增权限权限数据访问范围保持默认【与应用的可用范围一致】确认保存。如果你只需要基础收发消息可以只保留im:message、im:message:send_as_bot、im:message:readonly这几个如果要联动飞书文档、多维表格、云盘、白板就完整导入上面这份。3.4 创建版本并发布复制 App ID 与 App Secret进入版本管理与发布页面新建应用版本版本号自定义比如 1.0.0。移动端、桌面端默认能力统一选择机器人更新备注填写更新事件订阅、更新权限。保存后提交发布。个人空间通常免审核直接上线企业主体提交后需要管理员审批通过。发布完成后返回【凭证与基础信息】栏目完整复制 App ID 与 App Secret。这两组参数就是 OpenClaw 2.7.9 飞书渠道配置里要填的内容。3.5 OpenClaw 2.7.9 渠道配置与模型配置片段打开运行中的 OpenClaw 2.7.9 客户端点击右上角设置按钮进入聊天配置分类找到 Feishu/Lark飞书专属配置项。把复制的 App ID、App Secret 依次填入对应输入框开启渠道启用开关点击保存渠道配置。如果你用的是配置文件方式可以参考下面这份 TOML 片段路径和字段名按你本地 OpenClaw 2.7.9 的实际结构对照填写[channels.feishu] enabled true app_id cli_xxxxxxxxxxxxxxxx app_secret xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx connection_mode websocket [models.default] base_url https://taotoken.net/api api_key sk-xxxxxxxxxxxxxxxxxxxxxxxx model_id gpt-4o-mini模型侧的 Base URL 填https://taotoken.net/apiAPI Key 在 TaoToken 控制台的 API Keys 页面创建Model ID 按你实际使用的模型填。如果你更习惯用 JSON 格式对应的 settings 片段如下{ channels: { feishu: { enabled: true, app_id: cli_xxxxxxxxxxxxxxxx, app_secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx, connection_mode: websocket } }, models: { default: { base_url: https://taotoken.net/api, api_key: sk-xxxxxxxxxxxxxxxxxxxxxxxx, model_id: gpt-4o-mini } } }保存配置后点击右上角重启 Gateway 服务让飞书渠道和模型配置同时生效。4. 消息收发联调验证与成功结果确认4.1 在飞书群聊中触发第一条消息配置保存并重启 Gateway 后打开飞书找到你刚发布的应用机器人。如果应用已经发布上线机器人会出现在飞书的机器人列表里。把机器人拉进一个测试群或者直接和机器人单聊。在群里 机器人发一句简单的话比如「你好帮我列三个今天要做的事」。如果链路正常机器人会在几秒内回复。第一次回复可能稍慢因为模型侧需要建立连接。4.2 用日志确认长连接和事件接收状态如果机器人没回复先看 OpenClaw 2.7.9 客户端的日志面板。正常的长连接状态会显示 WebSocket 已连接事件订阅会显示im.message.receive_v1已注册。如果日志里出现local proxy failed或connection refused说明 Gateway 没起来或者端口被占用重启 Gateway 再试。如果日志显示消息事件已收到但模型侧报错重点看模型配置。常见的报错是401 Unauthorized说明 API Key 填错了或者过期了还有reading choices相关的报错通常是模型返回格式和 OpenClaw 预期不一致检查 Model ID 是否填对。4.3 验证消息发送与权限是否生效机器人能回复说明接收事件和模型调用都通了。再验证一下发送方向在群里发一条需要机器人主动发消息的指令比如「把刚才的内容整理成表格发到群里」。如果机器人能发出新消息说明im:message:send_as_bot权限生效了。如果机器人能收不能发回到飞书开放平台权限管理页面确认im:message:send_as_bot和im:message都已开通并且应用版本已经发布上线。权限变更后需要重新发布版本才会生效。4.4 成功结果对照清单跑通后你可以对照下面这份清单确认每一步都到位飞书自建应用已成功添加机器人应用能力事件订阅方式切换为长连接接收事件消息接收事件im.message.receive_v1添加完成配套权限全部开通全量权限 JSON 导入完毕应用版本已提交发布上线App ID、App Secret 准确录入 OpenClaw 2.7.9 并保存渠道配置模型侧 Base URL、API Key、Model ID 填写正确Gateway 重启后在线飞书群聊 机器人能收到回复机器人能主动发送消息5. OpenClaw 2.7.9 对接飞书常见报错排查5.1 401 Unauthorized 与 App Secret 填错这是最常见的一类报错。飞书侧返回 401通常是 App ID 或 App Secret 填错或者复制时带了多余空格。回到飞书开放平台【凭证与基础信息】页面重新复制粘贴到 OpenClaw 时注意不要带首尾空格。如果确认凭证没错检查应用是否已经发布上线未发布的应用凭证在部分接口上会返回未授权。模型侧返回 401则是 TaoToken 的 API Key 问题。到控制台 API Keys 页面确认 Key 是否有效、是否被删除重新创建一个填进去。5.2 local proxy failed 与 Gateway 未启动local proxy failed通常出现在 OpenClaw 2.7.9 启动阶段说明 Gateway 服务没有正常监听本地端口。先确认客户端主界面 Gateway 状态是否在线如果不在线点击重启 Gateway。如果重启后仍然报错检查本地端口是否被其他程序占用换一个端口再试。这个报错和飞书配置无关是本地服务层面的问题先解决 Gateway 再排查飞书。5.3 reading choices 与模型返回格式不匹配reading choices这类报错一般出现在模型调用返回阶段说明 OpenClaw 解析模型响应时没找到预期的choices字段。原因通常是 Model ID 填错或者 Base URL 指向的接口不是兼容 OpenAI 格式的。确认 Base URL 填的是https://taotoken.net/apiModel ID 按实际模型填写不要填成飞书侧的凭证。如果换了模型仍然报错到模型对话页面单独测一下这个模型能否正常返回排除模型本身的问题。5.4 OAuth 与事件订阅不生效如果日志里出现 OAuth 相关报错检查飞书应用的权限范围是否包含当前操作需要的 scope。事件订阅不生效的典型表现是机器人完全收不到消息回到【事件与回调】页面确认订阅方式是长连接并且im.message.receive_v1已添加。修改事件订阅后需要重新发布版本否则变更不会生效。5.5 机器人无应答的完整排查顺序按这个顺序走一遍基本能定位问题确认 OpenClaw 2.7.9 客户端 Gateway 在线确认飞书应用已发布上线机器人能力已添加确认事件订阅为长连接im.message.receive_v1已添加确认 App ID、App Secret 填写正确且无空格确认模型侧 Base URL、API Key、Model ID 正确重启 Gateway 后重新在飞书发消息测试6. 把飞书机器人接入稳定模型能力的后续配置飞书机器人跑通之后真正决定体验的是背后模型的能力和稳定性。OpenClaw 2.7.9 的飞书渠道负责消息通道模型侧负责生成内容两者分开配置。如果你希望机器人长期稳定响应建议把模型侧的 Base URL、API Key、Model ID 固定下来不要频繁更换。模型侧的 API Key 在 TaoToken 控制台的 API Keys 页面管理创建后填进 OpenClaw 的模型配置里。如果你需要调试不同模型的效果可以用模型对话页面单独测试确认返回正常后再填进 OpenClaw。对于需要长期跑编码类或 Agent 类任务的场景Coding Plan 页面提供了更适合持续调用的方案配置方式和普通 API Key 一致只是计费和调用策略不同。接入文档页面有完整的接口说明和配置示例遇到字段不确定的时候可以对照查。整个链路里飞书侧负责消息进出OpenClaw 负责调度模型侧负责生成三部分各司其职。把这三部分的凭证和配置都固定好飞书机器人就能在群聊里稳定工作了。