接入飞书
面向国内团队的飞书机器人配置要点
本文内容译自 Nous Research 官方文档，技术细节以英文原文为准。对照官方文档
概述
Hermes 网关支持飞书（Feishu/Lark） 等企业 IM，适合在国内团队部署共享助手。
准备
- 在飞书开放平台创建企业自建应用
- 获取 App ID、App Secret
- 开通机器人能力，配置事件订阅与消息权限
- 确保运行 gateway 的机器可被飞书回调访问（公网 URL 或内网穿透）
配置 Hermes
终端
hermes gateway setup
在向导中选择 Feishu / 飞书，按提示填入凭证。也可在 ~/.hermes/config.yaml 的 gateway / platforms 段手动添加（结构见官方文档）。
验证
hermes gateway status显示飞书通道已连接- 在飞书中 @ 机器人发送测试消息
- 确认仅白名单用户可触发（建议先只允许自己）
常见问题
| 问题 | 建议 |
|---|---|
| 收不到消息 | 检查事件订阅 URL、应用已发布、权限已审批 |
| 无回复 | hermes doctor；确认模型与 API Key 在 gateway 进程环境中可用 |
| 多人群聊无响应 | 检查群聊 @ 规则与平台级工具开关 |