推荐
扫码自动创建机器人
用飞书手机端扫码授权，系统自动获取 App ID、App Secret 与机器人信息，保存时默认启用 WebSocket。
无需公网回调地址
№ 023INTEGRATION能力 / 消息平台 / 飞书 · Lark
把飞书接到
Hermes。
将命令行里的 hermes gateway setup 拆成桌面端纯 UI 向导：创建机器人、写入当前 profile、重启 Gateway、再用真实消息验证闭环。
✓选择方式扫码或手动
2授权配置创建应用并验证 bot
3安全策略私聊、群聊与频道
4保存验证重启 Gateway 并检查
[ STEP 01 ]
选择接入方式
高级
手动输入已有应用
适合企业已有自建应用，需在开发者后台启用机器人能力并订阅接收消息事件。
可切换 Webhook 模式
[ STEP 02A ]
扫码授权并自动创建应用
QR ONBOARDING
请使用飞书手机端扫码
扫码成功后会自动创建名为 Hermes Agent 的机器人应用，并返回脱敏凭据。若企业策略禁止自动创建，可切换到手动模式。
状态等待管理员确认device_code 仅存在于后端内存
[ STEP 02B ]
手动输入已有飞书应用
区域
选择飞书中国或 Lark 国际。
飞书中国 · feishu
连接模式
桌面端默认 WebSocket，无需公网地址。
WebSocketWebhook
App ID
来自飞书开发者后台的应用凭证。
App Secret
不会在前端持久化，只展示脱敏结果。
Webhook Endpoint
仅在 Webhook 模式下需要公网回调。
[ STEP 03 ]
设置谁可以使用机器人
私聊配对审批
未知用户可发起请求，由管理员在 Hermes 中批准一次、会话或永久访问。
指定 open_id 白名单
只允许列表中的成员私聊和群聊触发，适合小范围企业试点。
允许所有私聊
最快试用，但所有能找到机器人的用户都能唤起 Agent。
群聊策略
减少群聊噪声，默认仅 @Hermes 时响应。
启用群聊，仅 @Hermes 时响应
通知 Home Channel
可稍后在飞书中发送 /set-home。
[ STEP 04 ]
保存配置并验证 Gateway
凭据已保存
完成FEISHU_APP_SECRET 已脱敏写入 .env。等待 Gateway 重启重启后读取新环境变量并加载 FeishuAdapter。
30s机器人消息测试在飞书私聊发送“你好 Hermes”。
待测交互卡片检查若按钮报 200340，需要配置卡片回调。
可选 [ REVIEW ]
保存前配置摘要
| 产品项 | 将写入的配置 | 状态 |
|---|---|---|
| 连接模式 | FEISHU_CONNECTION_MODE=websocket | 推荐 |
| 区域 | FEISHU_DOMAIN=feishu | 已确认 |
| 私聊策略 | FEISHU_ALLOW_ALL_USERS=false | 配对审批 |
| 群聊策略 | FEISHU_GROUP_POLICY=open | 仅 @ 响应 |
| 首页频道 | FEISHU_HOME_CHANNEL= | 稍后设置 |