飞书集成
注册一个飞书应用，在飞书里和助理对话。支持长连接（WebSocket，推荐）与 HTTP 回调两种接入方式。
两种接入方式
长连接（WebSocket）：扫码即可，平台自动建应用并回填凭证，群里 @ 机器人也能正常识别，桌面端只做这一种。HTTP 回调：需要你去飞书开放平台自建应用、手填凭证并配置事件订阅地址，只能在网页端「频道」页配置。
扫码接入（推荐）
- 1桌面端「设置 → 助理设置 → 集成（Beta）」→「飞书集成」→「配置」→「扫码接入」；网页端是「频道 → 新建 → 飞书 → 长连接（WebSocket，推荐）→ 扫码接入」。
- 2用「飞书 App」（不是 Lark）扫码授权。
- 3飞书会自动创建一个应用并把 App ID / App Secret 交给云端加密保存。
- 4卡片徽章变「已连接」后，在飞书里私聊这个机器人即可；拉进群时默认需要 @ 它才回复。
回调模式（仅网页端）
- 1在飞书开放平台自建应用，取 App ID（cli_ 开头）、App Secret、Encrypt Key、Verification Token。
- 2在「频道 → 新建 → 飞书 → HTTP 回调」里把四项填全并创建。
- 3把卡片上那行「回调 URL」填到飞书开放平台的「事件订阅 → 请求地址」里保存，飞书会来做一次地址校验。
关联你的渠道身份
如果该渠道开了「严格身份模式」，陌生触点的私聊不会为你建会话，只会回一句提示。在网页端「频道 → 我的渠道身份 → 生成关联口令」拿到形如 LK-XXXXXX 的口令，10 分钟内私聊发给机器人即可完成关联（发「link LK-XXXXXX」也认）。同时最多持有 3 个未使用的口令；群里发口令不生效，必须私聊。
停用与解绑
- 1临时不想收消息：在网页端「频道」页把这条应用停用，卡片会显示「已停用」，随时可再启用。
- 2彻底不用了：桌面卡片「配置 → 解绑」或网页端删除该应用，云端保存的凭证会一并删除，本机不留副本。
- 3解绑后需要重新扫码才能恢复；凭证任何时候都不会回传到你的电脑上。
常见失败与处置
用 Lark（国际版）账号扫码直接失败
目前只支持 open.feishu.cn 的飞书租户，Lark 租户会被直接判失败。请用飞书账号接入。
扫码页上点了「拒绝」后提示授权失败
重新取码再扫一次，在授权页点同意。二维码有效期 5 分钟。
飞书后台保存事件订阅地址时校验不过，或消息进来后没反应
Encrypt Key 或 Verification Token 填错（我方会回 401：签名不符 / token 不符 / 解密失败）。回到「频道」页删除重建这条应用并重新填写——凭证不支持在线修改。
回调模式下在群里 @ 机器人它不回
回调模式拿不到机器人自己的身份，群里只能识别「@所有人」。想在群里 @ 它，请改用长连接接入；或者把群策略里的「需要 @ 才回复」关掉。
卡片显示「失败」，错误是 connect failed
应用被停用或凭证被重置了。到飞书开放平台确认应用状态，必要时重新扫码接入。
还是没解决？
在「频道」页用卡片上的「连通性测试」看一眼云端此刻能不能连上； 如果错误信息仍然读不懂，把卡片上那行错误原文一起发给我们。