跳到主要内容

飞书 / Lark

日常接入请先使用长连接。它由 Gateway 主动连接平台，不要求公网入站 Webhook。需要飞书/Lark App ID 和 App Secret，并在平台启用机器人、消息权限和事件订阅。

现有设置入口的范围​

v0.1.107 的普通设置界面为未配置的飞书选择默认长连接 Profile。Dashboard、TUI 和 CLI 向导没有连接 Profile 选择/切换控件，不能照着一个未实现的按钮把账号改为 Webhook。

目录中同时声明了 feishu.websocket.v1、feishu.webhook.v1 及切换动作，这是协议能力；它不代表标准设置流程已经提供选择入口。已有 Webhook 账号可按其当前 Profile 更新。Dashboard/TUI 只更新所展示的 App 凭据，CLI 对现有 Webhook Profile 还会展示相应验签凭据。

按长连接完成首次接入​

  1. 在平台为应用启用 Bot，授予收发消息权限，订阅消息事件并选择长连接投递。
  2. 打开 Dashboard 渠道 → 添加 → Feishu / Lark，填写 app_id 与 app_secret。
  3. 默认账号 ID 为 work；保存后看健康观测。
  4. 需要调整访问策略时运行 anyy setup channel，在列表中选飞书。

平台控制台变化请参考飞书官方概览。

配对之后再验证群聊​

默认私聊为 pairing，群聊为 mention。可选私聊策略为 pairing/open/allowlist/disabled，群聊为 mention/open/allowlist/disabled。普通 Dashboard 凭据表单不提供策略或名单编辑；设置限制见消息平台。

anyy channel pairing list --channel feishu
anyy channel pairing approve --request REQUEST_ID
anyy channel reload
anyy channel doctor feishu

批准后先发新私聊，再测试群里明确提及 Bot。长连接在线不代表 Bot 在所有群里都有收发权限。

已有 Webhook 账号​

该 Profile 还要求 Verification Token、Encrypt Key，与平台保持一致。它使用：

/channels/feishu/ACCOUNT_ID/webhook

启用监听与 HTTPS 转发的方法见消息平台。没有公网路由时不会因为保存账号而自动出现回调服务。

若长连接不通，先查出站网络、App 凭据和订阅；若 Webhook 校验失败，分别查 HTTPS、Verification Token、Encrypt Key；若消息已到但未回复，再检查访问策略与 Bot 权限。