需完成飞书应用创建、权限配置与Hermes网关对接：登录飞书开放平台创建企业自建应用并记录App ID/App Secret；启用机器人能力，配置im:message.send_as_bot等核心权限；执行hermes gateway setup选择feishu，输入凭证并完成配对；事件订阅启用长连接并添加im.message.receive_v1；发布应用后发送/sethome设主频道并测试响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望 Hermes Agent 在企业办公环境中通过飞书接收和响应消息，则需完成飞书应用创建、权限配置与 Hermes 网关对接。以下是实现企业级 IM 消息互通的具体操作步骤：
一、在飞书开放平台创建企业自建应用
该步骤用于获取合法身份凭证，使 Hermes Agent 能被飞书平台识别并授权通信。应用必须为企业自建类型，个人版账号亦可创建，但需确保所属企业已开通开发者权限。
1、访问 https://open.feishu.cn，使用企业管理员或具备开发者权限的飞书账号登录。
2、点击右上角「创建应用」按钮，选择「企业自建应用」。
3、填写应用名称（例如 Hermes 企业助手）、应用描述，并上传图标（可选）。
4、创建完成后，进入「凭证与基础信息」页面，记录下 App ID 与 App Secret，后续 Hermes 配置必需使用。
二、为应用启用机器人能力并配置权限
启用机器人能力是 Hermes Agent 获得发送/接收消息资格的前提；权限配置则决定其可操作的数据边界，缺失关键权限将导致消息无法送达或读取失败。
1、在应用管理页左侧导航栏点击「添加应用能力」，选择「机器人」并点击「添加」。
2、进入「权限管理」→「添加权限」，勾选以下核心权限标识：
• im:message:send_as_bot
• im:message.p2p_msg:readonly
• im:message.group_at_msg:readonly
• contact:user.base:readonly
3、如需支持群聊全量消息，额外添加 im:message.group_msg 权限。
4、点击「批量/导入权限」，粘贴以下 JSON 并提交：
{"scopes": {"tenant": ["im:chat","im:chat:read","im:message","im:message.group_at_msg:readonly","im:message.p2p_msg:readonly","im:message:send_as_bot","contact:user.base:readonly"],"user": []}}
三、配置 Hermes Agent 的飞书网关（WebSocket 模式）
WebSocket 模式无需公网 IP 或端口映射，适用于 WSL2/本地服务器部署，Hermes 主动维持长连接，确保消息低延迟到达。
1、在 WSL2 Ubuntu 终端中确保 Hermes 已正确安装并运行。
飞书CLI一键安装助手功能概述飞书CLI一键安装助手是一项面向实际任务的技能，主要用于一键安装飞书CLI（lark-cli），自动完成环境检测、安装、配置、授权全流程；从15分钟手动操作 → 2分钟自动完成，成功率从60% → 95%；核心要点1. 智能环境检测；✅ 自动检测 Node.js 版本（需要 16.0+）；✅ 自动检测 npm/yarn 环境；使用与执行✅ 自动检测网络连接；✅ 自动检测系统权限；✅ 提供环境问题解决方案；2. 一键自动安装。它将相关步骤、工具调用和结果整理方式集中到统一流程中
2、执行命令：hermes gateway setup
3、在交互式菜单中选择平台：feishu
4、按提示输入此前记录的 App ID 与 App Secret。
5、系统将生成验证 URL 及 Token，此时需在飞书客户端向机器人发送任意消息以触发配对流程。
6、将 Hermes 终端返回的验证信息复制，粘贴至飞书机器人对话框完成双向绑定。
四、配置事件订阅与消息路由
事件订阅定义 Hermes Agent 哪些消息类型会被推送，路由配置则确保消息能被正确分发至对应子 Agent 或执行链路。
1、在飞书开放平台应用详情页，进入「事件订阅」模块。
2、启用「长连接」模式（非回调 URL），避免内网穿透依赖。
3、添加事件类型：im.message.receive_v1
4、确认事件已启用，系统将自动建立 WebSocket 连接通道。
5、在 Hermes 配置文件中检查 gateways:feishu:enabled:true 且 connection_mode: websocket 已生效。
五、发布应用并设置主交互频道
未发布的应用仅限管理员测试使用，企业全员可用需完成发布流程；主频道设定可保障定时任务、跨会话记忆指令等关键功能稳定投递。
1、进入「版本管理与发布」→「创建版本」→「提交审核」。
2、由企业管理员在飞书客户端审批通过后，应用状态变为「已发布」。
3、在飞书客户端搜索机器人名称，进入私聊窗口。
4、发送指令：/sethome，将当前会话设为 Hermes Agent 的主频道。
5、发送测试消息（如“你好”），观察 Hermes 是否返回结构化响应及上下文记忆痕迹。
