飞书平台选项缺失是因向导未加载飞书插件或依赖未就绪，需手动执行hermes gateway setup选择feishu、用uv安装lark-oapi至内置venv、编辑config.yaml启用通道，并验证事件订阅连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在运行 Hermes Agent 配置向导时发现飞书平台选项缺失，无法完成网关配置，则可能是由于当前向导未加载飞书 Gateway 插件或依赖未就绪。以下是解决此问题的步骤：
一、手动执行 gateway setup 命令绕过向导限制
配置向导默认仅展示内置预编译渠道，飞书支持需通过独立命令触发，该方式直接调用网关初始化流程，不依赖向导菜单渲染。
1、打开 PowerShell 或终端，确保已进入 Hermes Agent 运行环境。
2、执行以下命令启动飞书专用配置流程：hermes gateway setup
3、在渠道列表中使用方向键选择 feishu 项（即使向导主菜单未显示，该选项仍存在于底层配置器中）。
4、按回车确认后，依次输入飞书应用的 App ID 与 App Secret。
二、检查并安装缺失的 lark-oapi 依赖
Windows 环境下飞书网关无法启动常因 venv 中缺少 lark-oapi SDK，该依赖未被自动注入，需手动补全至 Hermes 内置 Python 环境。
1、执行命令定位 Hermes 内置 venv 路径：Get-Command hermes | Select-Object -ExpandProperty Source
2、根据输出路径拼接 Scripts 目录，例如：C:\Users\XXX\AppData\Local\hermes\hermes-agent\venv\Scripts
3、使用 uv 工具将 lark-oapi 安装至该 venv：uv pip install lark-oapi --python "C:\Users\XXX\AppData\Local\hermes\hermes-agent\venv\Scripts\python.exe"
三、直接编辑 config.yaml 文件启用飞书网关
当命令行配置失败或需批量部署时，可跳过交互式流程，通过手动修改配置文件强制启用飞书通道，该方法适用于 CI/CD 或容器化场景。
1、打开配置文件路径：~/.hermes/config.yaml
2、在 gateways 节点下添加以下 YAML 块（注意缩进必须为两个空格）：
feishu:
enabled: true
app_id: "cli_xxxxxxxxxx"
app_secret: "xxxxxxxxxxxxxxx"
verification_token: "xxxxx"
encrypt_key: "xxxxx"
四、验证飞书应用事件订阅连通性
飞书开放平台在启用事件订阅后会发送验证请求，若 Hermes Agent 未响应，说明 Webhook 地址不可达或服务未监听对应端口，需确认反向代理与防火墙策略。
1、登录 https://open.feishu.cn，进入对应应用的“事件订阅”页面。
2、检查“请求网址”是否填写为有效的公网 URL，格式为：https://your-domain.com/webhook/feishu
3、确认 Hermes Agent 正在运行且监听 3000 端口（默认），可通过命令验证：curl -v http://localhost:3000/health
4、如使用 Nginx，需确保 proxy_pass 正确转发 /webhook/feishu 路径，并透传 X-Request-ID 与 Content-Type 头。
