飞书 / Lark
Anyy 提供两种飞书/Lark 连接 Profile。默认推荐 Long connection（长连接），不需要公网 Webhook；部署环境要求 HTTP 事件投递时，可以选择 Webhook。
选择连接方式
| Profile | 必需凭据 | 公网 HTTPS |
|---|---|---|
Long connection (feishu.websocket.v1) | App ID、App Secret | 不需要 |
Webhook (feishu.webhook.v1) | App ID、App Secret、Verification Token、Encrypt Key | 需要 |
开放平台控制台的最新设置见 飞书官方平台概览。
平台侧准备
两种方式都要完成：
- 创建应用并启用机器人能力；
- 授予机器人收发消息所需权限；
- 订阅消息事件。
然后按 Anyy 中选择的 Profile，启用长连接投递或 Webhook 投递。
连接账号
打开 Dashboard → Channel → Add account，选择 Feishu / Lark 并填写对应 Profile 的字段。私信默认 pairing，群聊默认 mention。
首次创建以及切换连接 Profile 通过 CLI Setup 完成：
anyy setup channel feishu
Dashboard 和常驻 TUI 可以更新已经存在的 Profile；长连接与 Webhook 之间切换时，重新运行 Setup。
Webhook 路径为：
/channels/feishu/ACCOUNT_ID/webhook
默认账号 ID 为 work。飞书/Lark 和 Anyy 中的 Verification Token、Encrypt Key 必须一致。
访问策略
私信支持 pairing、open、allowlist、disabled；群聊支持 mention、open、allowlist、disabled。
anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID
验证连接
anyy channel doctor feishu
anyy channel reload
先验证私信，再验证群聊 @ 消息。
故障排查
| 现象 | 检查项 |
|---|---|
| 长连接一直未上线 | App 凭据、Bot 能力、事件订阅、出站网络 |
| Webhook 验证失败 | 公网 HTTPS、Verification Token、Encrypt Key |
| 收到事件但不回复 | 私信/群聊策略、配对、是否要求 @ |
| 发信未授权 | Bot 消息权限和应用发布状态 |
| 选错 Profile | 运行 anyy setup channel feishu 明确切换 |