1. 飞书群聊里跑通 OpenClaw 机器人到底难在哪飞书 AI 机器人 OpenClaw 安装与使用这件事卡人的地方从来不是「装不上」而是装完之后群里发消息没反应。我见过太多人把 OpenClaw 部署好了Gateway 也显示在线结果在飞书里 机器人半天对话框安静得像没人值班。问题基本都出在飞书开放平台那一侧的配置链路应用没发布、权限没批量导入、事件订阅没切成 长连接、App ID 和 App Secret 复制时带了空格。这四件事任意一件没做对机器人就是个摆设。OpenClaw 本身是一个能操控电脑的 AI 智能体飞书只是它的一个「遥控入口」。你在飞书聊天窗口发一句「帮我整理 D 盘下载文件夹」OpenClaw 收到消息后拆解任务、调用本机能力去执行再把结果回传到飞书。所以整条链路是飞书消息 → 长连接推送 → OpenClaw Gateway → 任务执行 → 飞书回复。任何一环断了表现都是「机器人不回话」。这篇教程面向的是已经在 Windows 上部署好 OpenClaw、想把它接进飞书群聊的人。如果你还没部署先去把一键部署包跑起来确认 Gateway 在线再往下看。下面我会按「飞书开放平台配置 → 凭证回填 OpenClaw → 群聊验证 → 报错排查」的顺序走一遍每一步都给可复制的配置片段和验证动作。适合个人账号快速试跑也适合企业账号走审核流程。需要说明的是OpenClaw 的模型调用能力可以对接 TaoToken 这类兼容 Anthropic 接口的服务后面配置环节我会给出对应的 Base URL 和 Key 填写位置。飞书侧只负责消息通道模型侧负责「大脑」两边分开配置排障时才能快速定位是哪一头的问题。2. 飞书开放平台配置与 OpenClaw 凭证对接前置这一节把飞书开放平台的操作一次性讲透因为后面所有报错几乎都能在这里找到根因。你需要一个飞书账号个人或企业都行企业账号要确认自己有应用开发权限否则创建应用那一步会灰掉。进入飞书开放平台开发者后台后创建「企业自建应用」。应用类型一定选企业自建应用不要选商店应用商店应用需要上架审核个人账号根本走不通。基础信息里应用名称随便起比如「OpenClaw 机器人」描述控制在 120 字以内图标传一张 240×240 以上的 PNG 就行。创建完进入应用配置页左侧菜单找到「添加应用能力」把「机器人」能力加上。加完之后左侧会多出机器人相关配置项这说明能力生效了。这一步很多人漏掉结果后面事件订阅里根本搜不到消息事件。接下来是权限管理这是最关键的一步。OpenClaw 要读消息、发消息、访问文档和表格权限必须提前开。手动一个个勾容易漏用「批量导入/导出权限」最稳。选择应用身份权限把下面这段 JSON 完整粘进去点格式化再提交{ scopes: { tenant: [ im:message, im:message:send_as_bot, im:message.group_at_msg:readonly, im:message.p2p_msg:readonly, im:resource, docx:document, sheets:spreadsheet, bitable:app ], user: [] } }提交后个人账号免审核立即生效企业账号要等管理员点通过。权限列表里每一项都要显示「已开通」只要有一项是「未开通」机器人收到消息也可能因为权限不足而静默失败。然后是事件订阅。左侧进「事件与回调」→「事件配置」订阅方式改成「使用长连接接收事件」。这一点对个人账号尤其重要长连接不需要公网域名也不用配内网穿透OpenClaw 主动连飞书消息直接推过来。改完保存再点「添加事件」搜索「接收消息」勾选im.message.receive_v1接收消息 v2.0。这个事件 ID 记牢后面排查「机器人不回话」时第一个要核对的就是它。配置完进「版本管理与发布」创建版本版本号写 1.0.0更新说明随便写移动端和桌面端默认能力都选机器人保存后确认发布。个人未认证账号发布即生效企业认证账号要去管理后台走审核。最后进「凭证与基础信息」复制 App ID 和 App Secret。这两个值建议手动选中复制不要用右键「复制链接」之类的方式很容易带上不可见字符。拿到之后回到 OpenClaw 主界面右上角设置 → 左侧「聊天渠道」→ 找到 Feishu → 把 App ID 和 App Secret 分别粘进去 → 保存渠道配置。OpenClaw 会自动重启等 Gateway 重新显示在线飞书这一侧的对接就算完成了。如果你在 OpenClaw 里还要配模型模型侧的 Base URL 填https://taotoken.net/apiKey 在控制台生成Model ID 按你选的模型填。飞书通道和模型通道是两套独立配置别混在一起填。3. 可复制的 OpenClaw 飞书渠道配置片段这一节给你可以直接抄的配置结构。OpenClaw 的渠道配置在不同版本里落盘位置略有差异但字段名基本一致。下面这份是飞书渠道的配置片段你可以对照自己 OpenClaw 的配置文件结构填{ channels: { feishu: { enabled: true, appId: cli_xxxxxxxxxxxxxxxx, appSecret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx, connectionMode: websocket, eventSubscription: long_connection, receiveEvent: im.message.receive_v1, replyAsBot: true, gateway: { host: 127.0.0.1, port: 18789 } } }, model: { provider: anthropic-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-xxxxxxxxxxxxxxxx, modelId: claude-sonnet-4-5 } }几个字段解释一下。connectionMode必须是websocket对应飞书那边的「长连接」如果你填成webhook就需要公网回调地址个人环境基本跑不通。eventSubscription和receiveEvent要和飞书后台完全一致大小写都不能错。gateway.port默认 18789如果你本机这个端口被占用改成别的但改完要同步检查 OpenClaw 启动日志里 Gateway 实际监听的端口。模型段的baseUrl填https://taotoken.net/api注意结尾不要多加斜杠。apiKey在 TaoToken 控制台的 API Keys 页面生成生成后只显示一次记得存好。modelId按你实际要用的模型填不确定就先填一个通用对话模型跑通链路再换。如果你用的是 TOML 格式的配置等价写法是这样[channels.feishu] enabled true appId cli_xxxxxxxxxxxxxxxx appSecret xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx connectionMode websocket eventSubscription long_connection receiveEvent im.message.receive_v1 replyAsBot true [channels.feishu.gateway] host 127.0.0.1 port 18789 [model] provider anthropic-compatible baseUrl https://taotoken.net/api apiKey sk-xxxxxxxxxxxxxxxx modelId claude-sonnet-4-5改完配置后不要直接热改OpenClaw 的渠道配置建议走界面保存触发重启或者手动重启 Gateway。手动重启的方式是在 OpenClaw 主界面点右上角「重启 Gateway」等状态从「重启中」变回「在线」。这里有个容易踩的坑App Secret 里可能包含、/、这类字符如果你用脚本或环境变量注入注意转义。最稳的方式还是在 OpenClaw 界面里手动粘贴避免编码问题。配置保存后OpenClaw 日志里应该能看到类似feishu channel connected和websocket established的字样。如果只看到feishu channel enabled但没有connected说明长连接没建起来回去检查 App ID/Secret 和事件订阅方式。4. 群聊消息收发验证与成功结果确认配置保存、Gateway 在线之后进入验证环节。打开飞书 PC 端或手机端顶部搜索你创建的应用名称比如「OpenClaw 机器人」进入和机器人的单聊窗口。先发一句最简单的「你好」观察回复。如果机器人回了内容说明消息通道和模型通道都通了。如果没回先别急着改配置按下面的顺序做一次快速自检。第一步看 OpenClaw 日志。Gateway 在线不代表飞书通道在线日志里搜feishu确认有message received记录。如果没有这条记录说明飞书的消息根本没推过来问题在飞书侧的事件订阅或应用发布状态。第二步确认应用已发布。回飞书开放平台「版本管理与发布」看当前版本状态是不是「已发布」。个人账号如果只点了「保存」没点「确认发布」应用处于未发布状态消息不会推送。第三步确认权限全部开通。进「权限管理」逐项核对任何一项显示「未开通」都要重新批量导入并申请。第四步确认事件订阅是长连接。进「事件与回调」→「事件配置」订阅方式必须是「使用长连接接收事件」并且im.message.receive_v1在已订阅列表里。第五步确认 OpenClaw 已重启。改完凭证后如果 OpenClaw 没自动重启手动点「重启 Gateway」等在线后再测。验证通过后你可以试一条稍微复杂点的指令比如在群里 机器人发「帮我打开记事本写一段今天的待办」。正常表现是飞书里机器人先回一句「收到正在处理」然后本机记事本被打开内容写入最后飞书收到执行结果。这个过程能跑通说明 OpenClaw 的任务拆解、本机操控、结果回传整条链路都正常。群聊场景还要注意一点默认情况下机器人只响应 它的消息。如果你希望它在群里响应所有消息需要在飞书开放平台的机器人配置里调整但建议保持 触发避免机器人在群里刷屏。成功的结果长这样飞书聊天窗口里你的消息下面跟着机器人的回复回复内容里包含任务执行状态或结果摘要。OpenClaw 主界面的任务列表里能看到对应的任务记录状态是「已完成」。两边对得上才算真正跑通。5. 飞书机器人无响应与常见报错排查这一节按真实报错来对。你在飞书里发消息没反应或者 OpenClaw 日志里报错基本逃不出下面几种。报错一401 Unauthorized / invalid app credentials这是 App ID 或 App Secret 不对。最常见的原因是复制时带了空格或者 App Secret 复制不全。回飞书开放平台「凭证与基础信息」重新复制粘贴到 OpenClaw 时手动检查首尾有没有空格。如果确认凭证没问题还是 401检查应用是否已发布未发布的应用凭证调用接口会返回 401。报错二local proxy failed / connection refused这个报错通常出现在 OpenClaw 尝试连飞书长连接时。原因可能是本机网络策略拦截了 WebSocket或者 Gateway 端口被占用。先确认 OpenClaw 的 Gateway 端口默认 18789没有被其他程序占用用netstat -ano | findstr 18789查一下。如果端口正常检查本机是否有安全软件拦截了 OpenClaw 的出站连接把 OpenClaw 加入白名单。报错三reading choices / model response parse error这个报错说明飞书消息已经推到了 OpenClawOpenClaw 也调用了模型但模型返回的内容解析失败。常见原因是模型侧的 Base URL 或 Model ID 填错。检查baseUrl是不是https://taotoken.net/api结尾不要带斜杠modelId是不是你账号下有权限的模型。如果用的是兼容接口确认请求格式和模型侧要求一致。报错四OAuth / token expired飞书侧的 tenant access token 过期或获取失败。这种情况一般重启 OpenClaw 重新拉取 token 就能恢复。如果频繁出现检查 App Secret 是否被重置过重置后旧 token 会失效需要重新填 Secret 并重启。报错五机器人收到消息但不回复消息推过来了日志里有message received但没有reply sent。这通常是模型调用失败或任务执行超时。先看模型侧日志确认 API Key 有效、余额充足。如果模型侧正常看任务执行日志可能是本机操控权限不足比如 OpenClaw 没有文件写入权限。排查时记住一个原则先看 OpenClaw 日志定位是「消息没进来」还是「回复没出去」。消息没进来查飞书侧回复没出去查模型侧和本机执行侧。两边分开查比盲目改配置快得多。如果你在配置模型侧时需要生成新的 Key去 TaoToken 控制台的 API Keys 页面操作生成后直接填到 OpenClaw 的apiKey字段。接入细节可以参考接入文档里面有各语言的调用示例。6. 把飞书机器人用起来的几个实用方向跑通之后飞书机器人能做的事比你想的多。除了前面说的文件整理、浏览器搜索还可以接文档和表格。比如在飞书群里发「把今天的会议纪要整理成表格发到群里」OpenClaw 可以调用飞书表格接口创建表格并回传链接。如果你想让机器人长期在群里待命建议把 OpenClaw 部署在一台常开的机器上Gateway 保持在线。飞书侧的长连接是主动外连不需要公网 IP家用宽带也能稳定跑。模型侧如果调用量大可以考虑用 Coding Plan 这类套餐适合长期编码和 Agent 场景比按次调用更划算。配置方式不变还是 Base URL 加 Key 加 Model ID 三件套。最后提醒一句飞书机器人的权限给到「发消息、读消息、文档、表格」就够了不要图省事把管理权限也开上。权限越小出问题时影响面越小。配置改完记得重启 Gateway很多「改了没生效」都是因为没重启。