1. 飞书群里 机器人没反应问题多半出在模型通道飞书群聊里拉一个 AI 机器人进来让它帮忙总结讨论、查资料、写周报这个场景听起来很顺。但真正动手之后很多人会卡在同一个地方机器人能被 到飞书那边也显示消息已送达可它就是一声不吭。你翻 Openclaw 的终端日志发现请求确实发出去了然后就没有然后了。这类问题通常不在飞书侧而在模型请求这一环。Openclaw 本身是一个把聊天平台和 AI 能力接起来的网关它负责接收飞书事件、组装上下文、再调用一个大模型接口拿回复。飞书开放平台负责的是「消息怎么进来」而「消息进来之后谁来回答」这件事取决于你在 Openclaw 里配置的模型通道。如果这个通道没配好或者 Key 失效、Base URL 写错、模型 ID 对不上机器人就会安静地待在那里。我试过把模型请求统一指向 TaoToken 的 API 通道好处是飞书机器人、本地脚本、其他工具可以共用同一个 Key不用每个地方都去申请一遍、记一堆不同的凭证。TaoToken 在这里扮演的是一个统一的模型调用入口你拿到一个 Key配好 Base URL就能让 Openclaw 通过它去请求模型。对于「飞书群里让 AI 干活」这个需求来说链路就变成飞书事件 → Openclaw → TaoToken API → 模型 → 回复回群。这篇文章面向的是已经装好 Openclaw、想在飞书群里落地 AI 能力的人。我会从飞书开放平台建应用、拿机器人凭证讲起再到 Openclaw 配置文件里把模型请求指向 TaoToken最后给出群内 机器人触发任务的验证步骤和常见报错排查。全程给可复制的配置片段你照着改就能跑。2. 前置准备飞书应用凭证与 TaoToken 统一 Key在动 Openclaw 配置文件之前有两样东西必须先拿到手飞书的机器人凭证和 TaoToken 的 API Key。这两样缺一个机器人要么收不到消息要么收到了也答不出来。先说飞书这边。你需要登录飞书开放平台进入开发者后台创建一个「企业自建应用」。为什么强调企业自建而不是用飞书官方插件扫码创建的那个私人助手因为私人版助手默认无法开启外部共享只能自己跟自己聊没法拉群。如果你有群聊需求就得走企业自建应用这条路。创建时应用名称和描述随便填能认出是哪个机器人就行。创建完成后进入应用详情页在「添加应用能力」里把机器人能力加上。接着是权限开通这一步最容易漏。飞书给了一份权限 JSON你可以直接批量导入也可以按需裁剪。这里有个关键点接收消息相关的事件权限一定要开尤其是群聊里 机器人的消息事件。很多人机器人不回复排查半天最后发现就是事件回调里没勾「接收消息」。权限导入之后还要去「事件与回调」里配置订阅方式Openclaw 用的是 websocket 长连接模式不需要你提供公网回调地址这点对没有公网服务器的同学很友好。权限配好点击「创建版本」发布应用填版本号和更新说明然后去飞书管理后台走审核。审核通过后回到应用的「凭证与基础信息」页面把 App ID 和 App Secret 复制保存下来。App ID 通常以 cli_ 开头App Secret 是一串随机字符这两个就是 Openclaw 连接飞书的钥匙。再说 TaoToken 这边。打开 https://taotoken.net/api 对应的控制台注册登录后进入 API Keys 页面创建一个 Key。这个 Key 就是你调用模型的总凭证。TaoToken 的 Base URL 是 https://taotoken.net/api模型 ID 按你实际想用的填比如常见的对话模型。创建好 Key 之后先复制保存后面配置里要用。如果你还没想好具体用哪个模型可以先去模型对话页面试一下确认通道能正常返回内容再往 Openclaw 里配。这里提醒一句飞书的 App Secret 和 TaoToken 的 API Key 都属于敏感凭证不要直接提交到公开仓库。配置文件如果放本地注意别误传到 Git。3. 可复制配置Openclaw 里把模型请求指向 TaoTokenOpenclaw 的配置文件一般是 openclaw.json放在你的工作目录或者安装目录下。这个文件同时管两件事飞书渠道怎么连以及模型请求发给谁。下面我给一份可以直接改的片段你把自己的凭证替换进去就行。先看飞书渠道部分。这段配置的作用是启用飞书渠道用 websocket 长连接收消息群聊里必须 机器人才响应私聊和群聊都走白名单。{ channels: { feishu: { enabled: true, appId: cli_你的AppID, appSecret: 你的AppSecret, domain: feishu, connectionMode: websocket, requireMention: true, dmPolicy: allowlist, allowFrom: [ ou_你的用户OpenID ], groupPolicy: allowlist, groupAllowFrom: [ oc_你的群ChatID ], groups: { *: { enabled: true }, oc_你的群ChatID: { requireMention: true } } } } }几个字段解释一下。connectionMode 设为 websocket表示用长连接接收飞书事件不用公网回调。requireMention 设为 true群里必须 机器人才触发避免它在群里乱插话。dmPolicy 和 groupPolicy 都设成 allowlist只有白名单里的用户和群能用。allowFrom 填用户的 open_idgroupAllowFrom 填群的 chat_id。groups 里的通配符 * 是默认规则下面再针对具体群覆盖。然后是模型通道部分。Openclaw 需要知道请求发到哪个 Base URL、用哪个 Key、调哪个模型。把下面这段加到配置里和 channels 同级。{ models: { default: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 你的TaoTokenKey, model: 你的模型ID } } }这里 provider 用 openai-compatible因为 TaoToken 的 API 是兼容 OpenAI 调用格式的Openclaw 按这个协议发请求就能通。baseUrl 固定填 https://taotoken.net/api注意结尾不要多加斜杠。apiKey 填你在 TaoToken 控制台创建的那个 Key。model 填你要用的模型 ID具体有哪些可以看接入文档里的模型列表。如果你用的是 TOML 格式的配置等价写法是这样[models.default] provider openai-compatible baseUrl https://taotoken.net/api apiKey 你的TaoTokenKey model 你的模型ID配置改完保存重启 Openclaw 让新配置生效。重启命令按你的安装方式走一般是先停掉进程再重新启动。启动后看终端有没有报配置解析错误没有的话就进入下一步验证。4. 验证请求群内 机器人看它是否真的干活配置写完不代表就能用得实际发一条消息验证整条链路。验证分两步先确认 Openclaw 能收到飞书事件再确认模型请求能返回内容。第一步把机器人拉进飞书群。在群里 一下机器人随便发句话比如「机器人 你好」。这时候盯着 Openclaw 的终端正常情况下你会看到有日志滚动显示收到了飞书的消息事件。如果终端一点动静都没有说明飞书侧的事件订阅没配好或者 websocket 没连上回到飞书开放平台检查事件回调配置和权限。第二步看机器人有没有回复。如果终端有日志滚动但群里没回复那问题多半在模型请求这一环。这时候去看日志里有没有请求 TaoToken 的记录以及返回的状态码。如果返回 401说明 Key 不对或者没带上如果返回 404可能是 Base URL 或模型 ID 写错了。为了单独验证 TaoToken 通道是否正常你可以先用 curl 直接打一次接口排除 Openclaw 配置的干扰curl https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer 你的TaoTokenKey \ -d { model: 你的模型ID, messages: [ {role: user, content: 你好请回复一句话} ] }如果这条命令能返回正常的 JSON里面有 choices 字段和模型回复内容说明 TaoToken 通道没问题那 Openclaw 里不回复就是配置字段的问题。如果这条命令也报错那就是 Key 或模型 ID 的问题去控制台核对。通道确认没问题后回到群里再 机器人发一条稍微复杂点的指令比如「机器人 帮我总结一下今天群里讨论的三个要点」。这时候机器人应该能正常回复。如果回复内容正常说明整条链路打通了飞书事件进来Openclaw 组装请求TaoToken 转发给模型模型返回Openclaw 再发回群里。验证通过后你可以把 requireMention 的策略按需调整。如果希望机器人在某些群里不用 也能响应可以在 groups 里针对那个群把 requireMention 设为 false。但建议一开始保持 true避免机器人在群里过度活跃。5. 常见报错排查401、local proxy failed 与 OAuth 问题配置过程中最容易撞上的几类报错我按实际遇到的顺序列一下你对照日志排查。第一类是 401 Unauthorized。这个基本就是 TaoToken 的 Key 有问题。可能的原因Key 复制时多了空格或换行Key 被删除或过期请求头里 Authorization 格式写错。正确格式是Bearer 你的KeyBearer 和 Key 之间一个空格。检查配置文件里 apiKey 字段有没有被引号包好有没有混入中文标点。第二类是 local proxy failed 或者连接超时。这类报错说明 Openclaw 发请求时网络层没通。先确认 baseUrl 是不是 https://taotoken.net/api有没有多写路径或者少写。然后确认你的机器能正常访问外网。如果是在公司内网可能有网络策略限制换一个网络环境试试。注意不要用任何非正规的网络工具正常的企业网络或家庭网络即可。第三类是日志里出现 reading choices 相关的解析错误。这通常意味着接口返回了内容但格式不是 Openclaw 预期的。可能原因模型 ID 填错了返回的是错误信息而不是正常回复或者 baseUrl 指向了错误的路径。用上面那条 curl 命令确认返回结构里有没有 choices 数组正常返回应该长这样{ choices: [ { message: { role: assistant, content: 你好我是AI助手 } } ] }如果 curl 返回的结构正常但 Openclaw 还是报解析错误检查一下 Openclaw 版本是否支持 openai-compatible 协议必要时升级到较新版本。第四类是 OAuth 或鉴权相关的报错。飞书这边如果 App ID 或 App Secret 填错websocket 连接会失败日志里会有鉴权失败的字样。回到飞书开放平台核对凭证注意 App Secret 只在创建时完整显示一次如果忘了就重置。TaoToken 这边如果 Key 权限不对也可能返回鉴权错误去控制台确认 Key 状态是启用。第五类是机器人收到消息但不回复日志里连模型请求都没有。这基本是飞书事件订阅的问题。检查「事件与回调」里有没有订阅「接收消息」事件权限里有没有开 im:message 相关的作用域。还有一个容易忽略的点群聊里 机器人时消息事件类型和私聊不一样要确认订阅的是群聊 消息事件。排查的时候养成看日志的习惯。Openclaw 的日志会按级别输出把日志级别调到 debug 能看到更详细的请求和响应内容。定位到具体是哪一环断了再针对性修比盲目改配置快得多。6. 把统一 Key 用起来飞书机器人的后续玩法链路打通之后飞书群里的 AI 机器人能做的事情就多了。你可以让它做会议纪要整理、需求讨论总结、代码片段解释、日报周报生成。因为模型请求走的是 TaoToken 统一 Key你不需要为每个场景单独申请凭证换模型也只需要改配置里的 model 字段。如果你后面还想接更多平台比如把同一个机器人能力扩展到其他聊天工具或者写本地脚本调用模型都可以复用这个 Key 和 Base URL。TaoToken 的接入文档里有不同语言的调用示例照着改就行。想先试试模型效果可以去模型对话页面直接聊几句确认输出质量再往生产配置里用。对于长期跑编码任务或者 Agent 类场景可以考虑用 Coding Plan把模型调用额度规划好避免群里高频使用把额度打满。API Keys 页面可以管理你的 Key需要轮换或新增的时候在那里操作。飞书群里的机器人稳定跑起来之后建议把配置文件做个备份凭证单独存好。后面如果要调整触发策略、加白名单群、换模型改完重启验证一遍就行。整条链路里飞书负责消息进出Openclaw 负责编排TaoToken 负责模型通道三者各司其职哪一环出问题看对应日志就能定位。
