一键创建飞书智能体应用

飞书开放平台提供 一键创建飞书智能体应用 能力，帮助 OpenClaw、Hermes 等 AI Agent 快速接入飞书、与用户在飞书中进行交互。

适用场景

当你开发了一个 AI Agent（如基于 OpenClaw、Hermes 构建的智能体），想让它进入飞书、与用户在飞书中进行交互——接收和发送消息、传输文件等。

传统流程中，用户需要进入飞书开发者后台手动创建应用、配置权限与事件订阅，操作繁琐且门槛高。

通过本 SDK，AI Agent 可以帮助用户一键完成飞书应用的创建，自动预置所有必要的权限和事件订阅（参考附录），用户只需扫码确认，即可获取 App ID 和 App Secret，直接投入使用。

使用效果

接入 SDK 后，用户通过以下三步完成飞书应用创建：

第一步：用户打开应用创建链接或二维码

示例链接：

https://open.feishu.cn/page/launcher?user_code=XXXX-XXXX&from=sdk&source=node-sdk&tp=sdk  

链接在十分钟内有效，仅支持一位用户点击或扫码使用。

第二步：创建应用，可选择已有应用/新增应用 支持通过 SDK 参数传入 应用头像、名称、描述，并通过 addons.preset 参数控制是否基于「智能体应用配置清单」 所包含的 权限、事件订阅 与 回调 清单来创建应用。

第三步：创建完成，获取应用凭证

应用创建成功后，自动返回 App ID 和 App Secret，所有权限与事件订阅已预置完毕，可直接用于调用飞书 API。

接入方式

• Node.js SDK：扫码一键创建应用（NodeJS）
• Python SDK：扫码一键创建应用（Python）
• JAVA SDK：扫码一键创建应用（JAVA）
• Go SDK：扫码一键创建应用（Go）

附录：智能体应用配置清单

创建的飞书应用默认包含以下权限和事件订阅，覆盖 AI 智能体的常用场景，包括在单聊、群聊中接受、发送消息；在文档评论中 at 智能体，智能体可回复文档评论。

应用能力

机器人

权限管理

• 应用身份权限

• 用户身份权限

• 开发者后台的权限导入清单参考

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "im:chat:create",
      "im:chat:read",
      "im:chat:update",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.pins:read",
      "im:message.pins:write_only",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "im:message.group_at_msg.include_bot:readonly",
      "application:bot.basic_info:read",
      "application:application:self_manage",
      "cardkit:card:write",
      "cardkit:card:read",
      "application:bot.menu:write",
      "im:chat.members:bot_access",
      "drive:drive.metadata:readonly",
      "docs:document.comment:create",
      "docs:document.comment:delete",
      "docs:document.comment:read",
      "docs:document.comment:update",
      "docs:document.comment:write_only",
      "docx:document:readonly",
      "docx:document:write_only",
      "wiki:node:read",
      "docx:document.block:convert",
      "application:app_slash_command:read",
      "application:app_slash_command:write"
    ],
    "user": [
      "offline_access"
    ]
  }
}

事件订阅

事件与回调默认采用 WebSocket 长连接 订阅方式，详情参考使用长连接接收事件、使用长连接接收回调。

• 事件配置

以下事件均以应用身份订阅。

• 回调配置