飞书开放平台配置清单(一次性,约 10 分钟)

打开飞书开放平台 →「创建企业自建应用」。
「凭证与基础信息」:记下 App ID / App Secret,填入 .env。
「添加应用能力」→ 启用 机器人。
「权限管理」→ 开通:
- im:message.p2p_msg:readonly — 读取用户发给机器人的单聊消息
- im:message.group_msg:readonly — 获取群组中所有消息
- im:message:send_as_bot — 以应用的身份发消息
- cardkit:card:write — 流式卡片(可选,缺失时回复自动降级为非流式)
「事件与回调」→「事件订阅」→ 请求方式选 使用长连接接收事件(WebSocket,无需公网 URL)→ 添加事件 接收消息 im.message.receive_v1。
「版本管理与发布」→「创建版本」→「申请发布」。企业内自建应用通常即时生效;若企业开启审核需管理员通过。
使用方式:
- 私聊:在飞书搜索应用名,发起单聊。
- 群聊:群设置 → 添加机器人 → 把应用加进群,之后 @机器人 才响应。

权限/事件改动需「发布版本」后才生效;若长连接连不上,先检查第 5、6 步。

使用说明

/stop:取消当前会话正在进行的任务
绑定关系持久化在 state/mapping.json(删除该文件可重置绑定)
流式输出(默认开启):STREAMING=false 可关闭;STREAM_UPDATE_INTERVAL_MS 控制卡片刷新节流(默认 500ms)
非流式回复按 REPLY_CHUNK_CHARS(默认 3500 字符)分片,首片以回复形式回在原消息下
暂不支持图片/文件/富文本消息(会提示仅支持文本)