Bot 与群组
消息、附件与运行卡
发送图片、文件和语音,查看运行过程,停止任务或领取结果。
Bot 在已连接的飞书群里接收任务。最稳妥的开始方式是在群主区明确 @ Bot,并说清要它做什么;选择「独立话题」(多会话)的群会为这条消息开新话题,后续在话题内继续。是否可以不 @,取决于群的聊天方式和「免 @」设置;智能模式还会判断该不该接话。
发送文字、图片、文件与语音
| 你发送的内容 | Bot 如何处理 | 遇到问题时 |
|---|---|---|
| 文字或富文本 | 把消息正文交给当前会话。引用回复时,会尽力把被引用消息一并交给它。 | 先确认群已连接、Bot 已启用,并明确 @ 到这位 Bot;没有回复时查看「诊断」。 |
| 图片 | 读取直接发送的图片和富文本中的图片,作为图像输入交给 Provider;单条消息最多处理 9 张。 | 图片读不到时重发原图,或用文字描述关键信息。 |
| 文件附件 | 下载直接发送的附件,告诉 Provider 文件名和可读取的位置;单条消息最多 9 个,每个不超过 50 MB。能否读取还受 Provider 和群权限限制;Codex 的受限权限档不能读取该临时附件。 | 若附件下载失败或 Provider 读不到,重发、缩小文件,或粘贴文字;处理文件前先核对执行权限。 |
| 语音 | 开启「语音转文字」且识别可用时,先转成文字再交给 Provider;转写结果会随回复展示。未转写时会尝试把原音频交给 Provider,并说明转写失败。 | 听写不准或读不到音频时,改发文字;超过 20 MB 的语音不会转写。 |
| 合并转发 | 可读取转发消息中的文字;其中的图片会尽力获取。 | 飞书可能拒绝获取合并转发子消息里的图片或文件。需要 Bot 分析附件时,请把原文件或原图直接发到群里。 |
发送附件时,最好在同一条消息里说明任务,例如“请总结这份文件的三个结论”。文件下载与 Provider 读取都需要时间;文件很大时先确认它在上述限制内。
看运行卡、停止与重试
Bot 开始处理后,会在群里更新运行卡,显示正在进行的步骤和输出。任务结束后,卡片显示最终结果。运行卡上的「停止生成」可中止当前运行;只有任务发起人或 Bot 管理员能操作停止。若卡片显示可重试,先核对这一轮是否已产生副作用,再点「重试」;网络瞬断也可能由 Bot 自动重试。
当这位 Bot 的并发运行名额已满,Bot 会先显示「排队中」卡片和排队位置;多个群共用这位 Bot 的并发名额,上限在该 Bot 的「设置 → 运行上限 → 同时处理的任务」调整。在开始前可点「取消排队」。若 Bot 在排队或运行期间停止,未执行的消息会提示重发。要确认是否真的完成,请看最终卡片,而不是只看正在更新的文字。
运行中补充一句话
在同一会话运行时继续发消息,群设置里的「运行中来了消息」会决定处理方式:「插话」尝试把补充交给当前轮,适合纠正方向;「排队」等当前轮结束后再处理,适合下一件事。若当前 Provider 或这次运行无法接收插话,消息会按实际状态进入后续处理。发送后看 Bot 的回执和运行卡,避免因未见即时变化而重复发同一任务。
正在运行 /goal 自治目标的会话不接普通插话或排队任务。要停止目标,用运行卡上的「终止」;想让当前轮完成后结束,用「结束目标」。目标结束后再发新的任务。

- 1聊天方式独立话题对应多会话,连续交谈对应单会话;智能由 Bot 判断何时、在哪里回复。
- 2群内响应决定不 @ 是否也能发起任务,不会替你改变聊天方式或权限。
- 3运行中的新消息Codex 可插话或排队;Claude 使用排队。以当前 Provider 显示的选项为准。
领取 Bot 生成的文件
Bot 在回复里引用可领取的本地文件时,点击文件名称,Bot 会把它作为飞书附件发送到当前会话;发送成功后,该入口会指向附件消息。单个附件须是可读取的普通文件,非空且不超过 30 MB。
只有本群允许使用 Bot 的成员可以领取。领取时还会重新检查群当前的执行权限:如果文件不在当前允许访问的范围内、已移动或已改变,领取会被拒绝。看到「上次发送结果未确认」时先检查会话里有没有附件,再请 Bot 重新引用文件,避免重复发送。
在云文档评论里 @ Bot
拥有者或管理员可以在受支持的飞书文档评论中 @ Bot 并写明问题。Bot 会读取该条评论及其引用内容,在同一评论串里回复;同一评论串中的后续 @ 会接着此前会话。支持文档、电子表格和多维表格的评论。评论回复不是群运行卡,处理时可能只看到飞书的“正在输入”反馈。
评论任务使用单独的「云文档评论」配置,包括 Provider、模型、权限与回复规则,不直接沿用某个群的聊天设置。Bot 需要能读取评论且有对应飞书权限;知识库里的文档还可能需要知识库权限。没有回复时,先确认是管理员本人 @ 了 Bot、文档类型受支持、评论里有实际问题,再查看 Bot 的「诊断」和飞书权限。
私聊的用途
当前版本中,私聊 Bot 会打开管理卡片,供主人和管理员查看或调整设置;普通任务请发到已连接的群。群内不能用 /settings 改设置,相关入口在私聊管理卡片、Vonvon 客户端或命令行。