🚀 飞书机器人配置指南

5 分钟完成配置，让你的龙虾在飞书里随时待命

1

创建飞书应用

前往飞书开放平台，创建一个新的企业自建应用。

  1. 访问 飞书开放平台
  2. 点击「创建企业自建应用」
  3. 填写应用名称（如：虾塘）、描述和图标
  4. 点击「创建」
创建飞书应用
💡 提示：应用名称可以自定义，建议使用有辨识度的名字，方便团队成员识别。
2

获取应用凭证

创建成功后，进入应用详情页，获取 App ID 和 App Secret。

  1. 在应用详情页，点击左侧「凭证与基础信息」
  2. 复制 App ID 和 App Secret
  3. 将这两个值保存好，后续配置会用到
App ID: cli_xxxxxxxxxxxxxxxx
App Secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
⚠️ 重要：请妥善保管 App Secret，不要分享给他人。
获取应用凭证
3

配置权限

在权限管理页面，点击「批量导入」按钮，粘贴以下 JSON 配置一键导入所需权限：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}
配置权限
4

配置长连接模式

在事件与回调页面：

  1. 选择使用长连接接收事件（WebSocket 模式），点击保存
  2. 添加事件：搜索并添加 im.message.receive_v1（接收消息）
配置长连接模式
5

发布应用

完成配置后，需要发布应用才能正常使用。

  1. 点击左侧「版本管理与发布」
  2. 点击「创建版本」
  3. 填写版本号（如：1.0.0）和更新说明
  4. 点击「保存并发布」
  5. 联系企业管理员审批通过
💡 提示：如果自己是企业管理员，可以直接在「应用审核」中通过。
发布应用
6

把飞书接入虾塘

把配置好的飞书应用信息接入虾塘，让你的龙虾可以在飞书里响应、协作和持续工作。

  1. 在虾塘后台进入「设置」→「飞书配置」，填写应用信息
  2. 填写 App ID 和 App Secret
  3. 选择要绑定的 Agent（龙虾）
  4. 点击「保存并测试连接」
  5. 测试通过后，在飞书中 @你的机器人 开始对话
🎣 联系管理员协助配置
?

常见问题

Q: 机器人不回复消息？

A: 检查以下几点：
- 事件订阅的请求地址是否正确
- 权限是否全部开通
- 应用是否已发布并通过审核
- App ID 和 Secret 是否填写正确

Q: 如何获取用户 ID？

A: 在飞书中 @用户，右键点击用户头像，选择「复制用户 ID」即可。

Q: 支持群聊吗？

A: 支持！将机器人添加到群组中，@机器人即可对话。群组中的对话同样会记录到养虾日记中。