首页/@claw-academy

"创建飞书机器人"

龙虾学堂
龙虾学堂2026年5月7日

"在飞书开放平台创建企业自建应用并开启机器人能力，获取 app_id 和 app_secret"

创建飞书机器人

本文聚焦：飞书开放平台操作 + 机器人能力配置

下一篇：配置 Feishu Provider

知识点 1：创建飞书企业自建应用

是什么

飞书机器人本质上是企业自建应用的一种能力。你需要在飞书开放平台创建一个应用，然后为其开启"机器人"功能，才能获得接入 OpenClaw 所需的凭证。

操作步骤

1. 登录开发者后台

访问 飞书开放平台，使用你的飞书账号登录。

2. 创建企业自建应用

点击页面右上角的**「创建企业自建应用」**按钮：

┌─────────────────────────────────────┐
│  创建企业自建应用  │  创建商店应用   │
└─────────────────────────────────────┘

3. 填写应用信息

在弹出的表单中填写：

  • 应用名称：给你的机器人起个名字（如 "Claw助手"）
  • 应用描述：简短描述用途
  • 应用图标：上传一个图标（可选）

点击**「确定创建」**。

4. 获取凭证信息

创建成功后，自动进入应用详情页。点击左侧菜单**「凭证与基础信息」**，你会看到：

App ID: cli_xxxxxxxxxxxxxxxx     # 应用唯一标识
App Secret: xxxxxxxxxxxxxxxxxxxx # 应用密钥（点击「查看」显示）

⚠️ 重要：App Secret 只显示一次，请务必复制保存！

知识点 2：开启机器人能力并配置权限

为什么需要

创建应用只是第一步。要让这个应用能接收和发送消息，必须显式开启"机器人"能力，并授予相应的权限。

开启机器人能力

1. 添加机器人能力

在应用详情页左侧菜单，找到**「添加应用能力」，点击后选择「机器人」卡片，点击「添加」**。

┌─────────────────────────────────────┐
│  🤖 机器人                           │
│     添加后，应用将以机器人身份       │
│     在群聊中收发消息                 │
│                          [ + 添加 ] │
└─────────────────────────────────────┘

2. 配置机器人信息

添加后点击**「机器人」**进入配置页：

  • 机器人名称：显示在群聊中的名字
  • 机器人描述：用户查看机器人资料时显示
  • 机器人头像：建议使用与应用相同的图标

点击**「保存」**。

配置事件订阅（关键步骤）

为了让 OpenClaw 能接收到飞书消息，需要配置事件订阅：

1. 进入事件与回调

左侧菜单点击**「事件与回调」**。

2. 选择订阅方式

在**「事件配置」**区域，选择：

☑ 使用长连接接收事件（推荐用于开发测试）
   或
☐ 将事件发送至开发者服务器（生产环境推荐）

对于个人使用或开发测试，选择**「长连接」**方式最简单，无需公网服务器。

3. 添加订阅事件

点击**「添加事件」，在「消息与群组」**分类下找到：

  • ✅ 接收消息（im.message.receive_v1）

勾选后点击**「确认」**。

开通必要权限

机器人需要以下权限才能正常工作：

权限名称权限代码用途
获取用户发给机器人的单聊消息im:message.p2p_msg接收私聊消息
以应用的身份发消息im:message:send_as_bot私聊和群聊发消息
获取用户在群组中@机器人的消息im:message.group_at_msg接收群聊中@消息（如果需要）

⚠️ 注意：部分权限为"高级"权限，需要企业管理员审批才能开通。如果权限申请被拒绝，请联系企业管理员协助处理。

操作步骤：

  1. 左侧菜单点击**「权限管理」**
  2. 在搜索框依次输入上面的权限代码
  3. 找到后点击**「开通权限」**
  4. 重复直到所有权限都开通

实践建议

  1. 立即保存凭证：获取到 App ID 和 App Secret 后，立即保存到安全的地方（如密码管理器），Secret 只显示一次

  2. 使用长连接方式：对于个人使用，长连接方式配置最简单，不需要公网服务器和域名

  3. 权限一次开全：在发布应用前，把所有需要的权限都开通，避免后续反复修改

  4. 创建版本才能使用：配置完成后，需要点击**「版本管理与发布」**创建版本并发布，机器人才能在群聊中被搜索到

  5. 测试时先拉入测试群：发布前，先在测试群中添加机器人，验证功能正常后再广泛使用

验证步骤

完成以上配置后，你应该拥有：

✅ App ID: cli_xxxxxxxxxx
✅ App Secret: xxxxxxxxxxx
✅ 机器人能力已开启
✅ 事件订阅已配置（接收消息）
✅ 必要权限已开通
✅ 已创建版本并发布

现在可以将机器人拉入群聊进行测试：

  1. 打开飞书 APP（网页版无法添加机器人）
  2. 进入任意群聊
  3. 点击右上角「···」→「群机器人」→「添加机器人」
  4. 搜索你的机器人名称，点击添加

相关阅读

#["feishu"#"飞书"#"机器人"#"入门"]