飞书群绑定

绑定能做什么

飞书绑定让某个 agent 通过飞书应用在群里回复消息。一个 agent 可以绑定一个或多个飞书应用。

常见用法：

• 在群里 @ agent，让它根据配置的模型、MCP、记忆和知识库回答。
• 把工作流诊断结果推送到指定飞书群。
• 让同一个 agent 面向不同群使用不同飞书应用配置。

绑定入口

管理员进入 Agents，在 agent 卡片上打开 Feishu binding。

绑定时需要填写：

字段	说明
App ID	飞书应用的 App ID。
App Secret	飞书应用密钥。
Encrypt Key	可选，飞书事件加密使用。
Verification Token	可选，飞书事件校验使用。
Reply policy	回复策略。

App Secret、Encrypt Key 和 Verification Token 都属于敏感信息，保存后不会在普通列表里明文展示。

回复策略

默认策略是 On @-mention only：只有群里 @ 到机器人时，agent 才会回复。

All messages 会让 agent 处理更多群消息，需要飞书侧额外消息权限。除非你明确要做群消息监听，否则建议先使用 @-mention only。

飞书侧配置

飞书应用侧通常需要完成这些步骤：

1. 给应用开通消息读取、发消息和群信息相关权限。
2. 发布应用版本，让权限生效。
3. 把机器人加入目标群。
4. 在 EthanKit 绑定完成后，把页面提供的 callback URL 配到飞书事件订阅。
5. 在群里 @ 机器人测试。

如果使用飞书文档读取能力，还需要把目标文档共享给应用本身。群成员可读不代表应用可读。

常见问题

如果群里没有回复，先检查：

• 绑定状态是否是 ACTIVE。
• 飞书事件订阅 URL 是否配置正确。
• 飞书应用权限是否发布生效。
• 机器人是否已经加入目标群。
• 当前回复策略是否要求必须 @ 机器人。
• Agent 是否已经配置可用模型。