需完成飞书开放平台配置、权限申请、凭证获取及hermes服务端适配：一、创建企业自建应用；二、启用机器人并配置im:message:send_as_bot等权限；三、获取app id与app secret；四、通过交互式向导或yaml配置hermes gateway；五、订阅im.message.receive_v1事件并设置回调；六、发布应用后测试响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将 Hermes Agent 接入飞书机器人以实现自动消息响应与团队协作增强，则需完成飞书开放平台配置、权限申请、凭证获取及 Hermes 服务端适配等关键环节。以下是具体操作步骤：
一、在飞书开放平台创建企业自建应用
该步骤用于注册一个合法的飞书应用身份，为后续启用机器人能力提供基础载体。只有通过此方式创建的应用，才能被 Hermes Agent 正确识别并绑定。
1、访问 https://open.feishu.cn，使用具备管理员权限的飞书账号登录。
2、点击右上角「创建应用」，选择「企业自建应用」。
3、填写应用名称（例如 Hermes AI 助手）和简要描述，可选上传图标，点击「创建」。
二、启用机器人能力并配置权限
启用机器人功能是使应用具备收发消息能力的前提；而精确配置权限则决定了 Hermes Agent 能否读取消息、发送回复及获取用户上下文信息。
1、进入刚创建的应用详情页，点击「应用功能」→「机器人」→「启用机器人」。
2、务必勾选「开启交互式卡片」选项，否则无法支持按钮点击、表单提交等高级交互。
3、进入「权限管理」→「申请权限」，添加以下必需权限：
• im:message:send_as_bot（以机器人身份发送消息）
• im:message:read（读取收到的消息）
• contact:user:readonly（读取用户基本信息）
• im:message.group_at_msg:readonly（接收群聊中 @ 机器人的消息）
4、点击「保存」并执行「发布」操作，使权限变更生效。
三、获取并记录应用凭证
App ID 与 App Secret 是 Hermes Agent 与飞书平台建立可信身份认证的核心密钥，必须准确无误地填入配置文件或交互式向导中。
1、在应用详情页左侧菜单中，点击「凭证与基础信息」。
2、复制并安全保存以下两项值：
• App ID（格式如 cli_xxxxxxxxxx）
• App Secret（一串随机字符串）
3、切勿将 App Secret 泄露至公开代码仓库或聊天工具中。
四、配置 Hermes Gateway 接入飞书通道
此步骤将 Hermes Agent 实例与飞书应用进行逻辑绑定，支持两种主流方式：命令行交互式配置或手动编辑 YAML 配置文件。
方式一：使用交互式向导
1、在运行 Hermes Agent 的服务器终端中执行：hermes gateway setup。
飞书任务管理工具，支持任务的创建、查询、更新、删除及清单的管理。适用场景：创建/管理任务与清单、查看任务列表或清单中的任务、用户提及任务、待办、to‑do、清单、task时、设置负责人和关注等。
2、按提示依次选择：feishu → 输入已复制的 App ID 和 App Secret → User IDs 留空（允许全员访问）或填入测试用户 ID → Domain 保持默认 feishu → Connection mode 选择 websocket。
方式二：手动编辑配置文件
1、打开配置文件路径：~/.hermes/config.yaml。
2、在 gateways 下添加如下内容（注意缩进与冒号后空格）：
feishu:
enabled: true
app_id: "cli_xxxxxxxxxx"
app_secret: "xxxxxxxxxxxxxxx"
verification_token: "your_verification_token"
encrypt_key: "your_encrypt_key"
五、配置事件订阅与回调地址
飞书通过事件订阅机制主动将用户消息推送给 Hermes Agent，因此必须在开放平台中正确设置事件类型与通信通道，否则消息无法到达服务端。
1、返回飞书开放平台，在应用详情页点击「事件与回调」→「事件订阅」。
2、订阅方式选择「长连接」（推荐）或「HTTP 回调」。
3、在「需要订阅的事件」中，至少勾选：im.message.receive_v1。
4、若使用 HTTP 回调方式，需填写 URL：https://你的服务器IP:3000/webhook/feishu，并确保该端口对外可达且 HTTPS 有效。
5、系统将发起验证请求，请确认 Hermes Agent 已处于运行状态并监听对应路径。
六、发布应用并完成测试
未发布的应用仅限开发者本人调试使用，发布后方可被组织内成员发现、添加并实际交互，是接入流程的最终确认环节。
1、进入飞书开放平台「版本管理与发布」页面。
2、点击「创建版本」，填写版本说明后提交审核。
3、等待管理员在飞书客户端完成审批操作。
4、审批通过后，在飞书中搜索应用名称，点击「添加」，即可在私聊或群聊中发送测试消息。
5、向机器人发送任意文本，观察 Hermes Agent 是否返回合理响应；若无反应，检查服务日志中是否出现 feishu webhook received 或 connection refused 类错误。
