【5天实战】从零构建AI-Native组织：飞书+Bot+Gitee全链路自动化实战指南——Day 2：飞书Bot开发配置

2026/7/2 2:09:19

📖系列文章
（一）准备工作
（二）Day 1：飞书基础环境搭建
（三）Day 2：飞书Bot开发配置
（四）Day 3：Gitee和TRAE集成
（五）Day 4：多维表格和自动化工作流
（六）Day 5：完整场景实操验证
（七）FAQ与附录

文章目录

3 Day 2：飞书Bot开发配置
- 3.1 什么是飞书Bot
- 3.2 注册飞书开放平台账号
- 3.3 创建企业自建应用
- 3.4 添加Bot能力
- 3.5 配置应用权限
- 3.6 配置事件订阅
- 3.7 获取App ID和App Secret
- 3.8 发布应用
- 3.9 测试Bot是否正常工作
- 3.10 Day 2 完成清单

3 Day 2：飞书Bot开发配置

Day 2的目标是创建一个企业自建的飞书Bot，让它能够收发消息、读写文档、操作多维表格。这个Bot将是整个AI-Native组织的核心AI成员。

3.1 什么是飞书Bot

飞书Bot（机器人）是运行在飞书平台上的自动化程序，它可以：

接收消息：当用户在群聊或私聊中@Bot时，Bot可以接收到消息内容
发送消息：Bot可以主动向群聊或个人发送文本、富文本、卡片消息
操作文档：Bot可以读取、创建、编辑飞书文档
操作多维表格：Bot可以增删改查多维表格中的记录
管理知识库：Bot可以读取知识库中的文档内容
调用API：Bot可以通过飞书开放API完成几乎所有飞书平台支持的操作

在我们的AI-Native组织中，Bot将承担以下核心职责：

每日自动生成项目早报并推送到群聊
接收Gitee的Webhook通知并转发到代码通知群
自动监控多维表格中的数据变化并发送提醒
响应群聊中的简单指令（如查询任务状态、生成报表等）

3.2 注册飞书开放平台账号

步骤1：访问飞书开放平台

打开浏览器，访问https://open.feishu.cn，使用你的飞书账号登录。

步骤2：进入开发者后台

登录成功后，点击页面右上角的"进入开发者后台"按钮。如果是首次访问，系统会提示你创建一个开发者团队（或使用现有团队）。

步骤3：确认开发者身份

在开发者后台中，确认你的身份是"管理员"或"开发者"。如果不是，需要在飞书管理后台中申请相应权限。

💡提示：
飞书开放平台的开发者后台就是管理所有自建应用的统一入口。
你创建的Bot、配置的权限、查看的API调试工具，都在这里操作。

3.3 创建企业自建应用

步骤1：创建应用

在开发者后台首页，点击"创建企业自建应用"按钮。

应用名称：[团队名]-AI助手（例如"xx科技-AI助手"）
应用描述：团队AI-Native组织的智能协作者，负责信息推送、数据同步和自动化工作流
图标：选择一个机器人图标或上传自定义图标

步骤2：查看应用基本信息

创建成功后，你会进入应用的"凭证与基础信息"页面。在这里你可以看到：

App ID：应用的唯一标识（后续配置TRAE Work需要用到）
App Secret：应用的密钥（请妥善保管，不要泄露）

⚠️注意：
App Secret 是极其敏感的信息！
不要将它提交到代码仓库、不要分享给无关人员、不要在公开的文档中展示。
如果怀疑Secret泄露，请立即在开放平台中重置。

3.4 添加Bot能力

在应用管理页面左侧导航栏中，找到"添加应用能力"→"机器人"，点击"添加"按钮来开启机器人能力。

3.5 配置应用权限

Bot需要获得相应权限才能操作飞书的各种功能。在应用管理页面左侧导航栏中，找到"权限管理"，按照以下表格逐一搜索并开通所需权限：

权限类别	权限Scope	权限说明	使用场景
消息	`im:message:send_as_bot`	以机器人身份发送消息	Bot向群聊发送日报、通知等
文档	`docx:document:readonly`	读取飞书文档内容	读取知识库中的文档
`docx:document:create`	创建飞书文档	自动创建会议纪要等文档
`docx:document:write_only`	编辑飞书文档内容	向文档中写入数据
多维表格	`bitable:app`	查看、评论、编辑和管理多维表格	读写敏捷项目管理和CRM表格
知识库	`wiki:wiki:readonly`	只读访问知识库	读取知识库中的文档内容
用户信息	`contact:user.base:readonly`	读取用户基本信息	获取@Bot的用户身份信息

步骤3：搜索和开通权限

在"权限管理"页面的搜索框中，逐一输入上述scope名称或描述关键字，找到对应权限后点击"开通"按钮：

在搜索框中输入im:message，找到消息相关权限，点击开通
搜索docx:document，找到文档相关权限，点击开通
搜索bitable，找到多维表格权限，点击开通
搜索wiki，找到知识库权限，点击开通
搜索contact:user，找到用户信息权限，点击开通

⚠️注意：
1、权限开通后，部分权限需要管理员审批才能生效。
如果你不是飞书管理员，请联系管理员审批权限。审批通过后，权限才会真正生效。

2、完整权限列表可在链接（BOT完整权限）中下载，直接批量导入即可。

3.6 配置事件订阅

事件订阅让Bot能够实时感知飞书中发生的事情（如收到消息）。我们需要配置Bot使用长连接方式接收事件。

步骤1：启用长连接

在应用管理页面左侧导航栏中，找到"事件与回调"→"事件配置"：

选择使用长连接接收事件（推荐方式，无需公网IP，无需配置Webhook地址）
点击"添加事件"按钮

步骤2：添加消息事件

在事件列表中搜索并添加以下事件：

im.message.receive_v1—— 接收消息事件（当有人在群聊中@Bot或私聊Bot时触发）

💡提示：
长连接方式的优势是不需要公网服务器，Bot通过飞书开放的WebSocket长连接实时接收事件。
这对于个人开发者和中小团队非常友好，无需配置Nginx、域名和SSL证书。

3.7 获取App ID和App Secret

步骤1：获取凭证

在应用管理页面，点击左侧导航栏的"凭证与基础信息"：

App ID：以cli_开头的字符串，例如cli_a5xxxxxxxxxxxxxx
App Secret：一串字母数字组合，例如abc123def456ghi789

步骤2：安全保存凭证

请将这两个值安全地保存起来。建议：

保存在密码管理器中（如1Password、Bitwarden）
或保存在本地加密文件中
不要保存到代码仓库或公开文档中

⚠️注意：
App ID和App Secret在后续章节（TRAE Work配置、自动化工作流）中会频繁使用，请确保你能够随时找到它们。

3.8 发布应用

步骤1：创建版本

在应用管理页面左侧导航栏中，找到"版本管理与发布"：

点击"创建版本"按钮
版本号：1.0.0
更新说明：初始版本：支持消息收发、文档读写、多维表格操作
点击"保存"

步骤2：申请发布

创建版本后，点击"申请发布"。根据你的组织设置：

如果需要管理员审批，请通知管理员审批
如果不需要审批，应用会立即发布上线

步骤3：确认发布成功

在飞书客户端的消息页面，搜索你的Bot名称。如果能够搜索到，说明Bot已成功发布。

3.9 测试Bot是否正常工作

步骤1：添加Bot到群聊

打开昨天创建的"[团队名]-AI-Bot通知"群聊，点击群设置（右上角"…“）→"群机器人"→"添加机器人”，搜索并添加你的Bot。

步骤2：测试消息

在群聊中输入@[你的Bot名称] 你好，然后发送。由于我们还没有编写Bot的回复逻辑，Bot不会自动回复，但你可以在飞书开放平台的"事件订阅"页面看到事件已收到（如果开启了长连接调试）。

步骤3：使用Webhook测试消息发送

如果你已经配置了自定义机器人Webhook（在"机器人"配置页面可以找到），可以使用以下curl命令测试Bot能否发送消息：

curl-XPOST\'https://open.feishu.cn/open-apis/bot/v2/hook/YOUR_WEBHOOK_URL'\-H'Content-Type: application/json'\-d'{ "msg_type": "text", "content": { "text": "Hello from AI-Native Bot! 测试消息发送成功。" } }'