飞书自建应用 · 创建步骤清单（2026-10-17）

目标：拿到 App ID + App Secret，使 Exia 可调用飞书开放 API（发消息、后续收消息与卡片交互）。预计 10–15 分钟，全部在飞书开放平台开发者后台完成。

步骤

1. 打开飞书开放平台 open.feishu.cn → 开发者后台 →「创建企业自建应用」，填名称（如 Exia 助理）、描述、图标，创建。
2. 进入应用 →「凭证与基础信息」：记下 App ID（cli_ 开头）与 App Secret（先留在页面，最后一步交接）。
3. 左侧「添加应用能力」→ 添加「机器人」，机器人名称与应用同名即可。
4. 左侧「权限管理」→ 开通以下权限（应用身份/tenant 级，最小集）： - im:message:send_as_bot（以机器人身份发送消息，核心） - im:message（发送/更新消息） - im:chat:readonly（读取群信息、列机器人所在群） - im:message.p2p_msg:readonly（读取发给机器人的单聊消息，第二期用） - im:message.group_at_msg:readonly（读取群聊中 @ 机器人的消息，第二期用）
5. 左侧「事件与回调」→ 订阅方式选 「长连接」（不要选请求网址——我们没有公网回调地址，长连接由我方主动外连即可）；添加事件 im.message.receive_v1（接收消息）。此步可与第二期一起配好，免得再走一次发布。
6. 左侧「版本管理与发布」→「创建版本」→ 填版本号与说明 → 提交发布。个人/自有租户一般管理员在管理后台批准即可；未发布，权限不生效。
7. 发布通过后：在目标飞书群「设置 → 群机器人」中添加该应用机器人；也可直接在飞书里搜索应用名与它单聊。

交接（最后一步）

把 App ID 与 App Secret 给我（老规矩：只落盘本机 ~/workspace/tools/feishu-app.env、600 权限，不复述、不进记忆）。我随后：换取 tenant_access_token 验活 → 写 API 发送脚本 → 向群/单聊各发一条测试消息确认。

注意

• 第 4 步权限若增删，须重新创建版本发布才生效。
• App Secret 泄露等于应用被冒用：只经上述通道交接，不要发到任何群里。
• 现有 webhook 群机器人保留不动作回滚通道，API 通道验活后再议是否切换推送主力。