需完成飞书开放平台配置、凭证获取、网关对接及事件订阅：一、创建自建应用并启用机器人、勾选交互式卡片、添加核心权限并发布；二、获取App ID与App Secret并安全保存；三、执行hermes gateway setup配置飞书连接；四、在飞书后台订阅im.message.receive_v1事件，启用长连接；五、发布应用并通过搜索机器人、发送消息、运行配对命令完成首次通信测试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望 Hermes Agent 在飞书环境中稳定运行并响应用户消息，则需完成飞书开放平台配置、凭证获取、网关对接及事件订阅等关键环节。以下是实现该目标的具体操作路径：
一、在飞书开放平台创建并配置企业自建应用
此步骤用于注册 Hermes Agent 的身份，使其具备在飞书生态中作为机器人运行的合法资质。应用需启用机器人能力并设定基础访问范围。
1、访问 https://open.feishu.cn，使用具有管理员权限的飞书账号登录。
2、点击“创建企业自建应用”，填写应用名称（如 Hermes AI 助手）与描述，完成创建。
3、进入应用详情页，选择“应用功能” → “机器人” → 点击“启用机器人”。务必勾选「开启交互式卡片」选项，否则后续按钮类交互将无法触发。
4、进入“权限管理”，批量导入或手动添加以下核心权限：
im:message:send_as_bot、im:message:read、im:message.group_at_msg:readonly、im:message.p2p_msg:readonly、contact:user.id:readonly、im:resource。
5、点击“发布”权限变更，确保状态显示为“已发布”。
二、获取并记录 App ID 与 App Secret
该凭证是 Hermes Agent 与飞书服务端建立可信通信的唯一身份密钥，后续所有配置均依赖此组参数。
1、在应用详情页左侧导航栏中，点击“凭证与基础信息”。
2、定位到“App ID”与“App Secret”字段，完整复制并安全保存二者值（App Secret 仅在此处可见一次，丢失需重置）。
3、确认“应用状态”为“已启用”，且“应用可见范围”已设置为所需组织或成员。
三、配置 Hermes Gateway 连接飞书
此步骤将 Hermes Agent 实例与飞书平台进行逻辑绑定，指定通信协议、认证凭据及作用域限制。
1、在部署 Hermes Agent 的服务器上，执行命令：hermes gateway setup。
2、在交互式向导中，选择平台为 feishu。
3、依次输入上一步获取的 App ID 与 App Secret。
4、User IDs 字段可留空（表示对所有用户开放），或填入测试用飞书用户 ID（格式为 ou_xxxxxxxxxxxxxx）。
5、Domain 保持默认 feishu，Connection mode 选择 websocket（推荐低延迟场景）。
四、配置飞书事件订阅以接收消息
飞书通过事件回调机制将用户消息推送至 Hermes Agent，必须正确配置请求 URL 与订阅事件类型，否则消息无法抵达。
1、返回飞书开放平台，进入应用详情页 → “事件与回调” → “事件订阅”。
2、订阅方式选择 长连接（非 HTTP 回调模式）。
3、在“需要订阅的事件”中，搜索并勾选 im.message.receive_v1。
4、若启用加密通信，需同步配置 encrypt_key 并在 Hermes 配置文件中填入对应值。
5、保存配置后，系统将发起验证请求——确保 Hermes Agent 正在运行且监听 /webhook/feishu 路径。
五、发布应用并完成首次配对测试
未发布的应用无法被组织内成员发现和使用，发布是使机器人正式生效的必要动作；首次通信还需完成双向信任建立。
1、进入飞书开放平台 → “版本管理与发布” → “创建版本”。
2、填写版本说明后提交审核，由企业管理员审批通过。
3、审批通过后，在飞书中搜索机器人名称，发送任意文本消息（如“你好”）。
4、首次对话时，Hermes Agent 将在终端输出配对提示，运行提示中的配对命令（如 hermes pair feishu xxxxx）。
5、配对成功后再次发送消息，观察是否收到结构化回复（含代码块、列表等富文本渲染）。
