飞书多维表格 (Bitable) 接入与自动化指南
TL
本文是 AI 课堂场景下飞书多维表格的接入配置与自动化实现指南，指导完成多维表格结构创建、飞书开放平台配置、自动化流程搭建，以及必要参数的获取，最终实现学生信息管理、自动邀请、自动发证等 AI 课堂自动化功能。
目录
要点
- 需要先创建指定结构的多维表格，再通过表单视图收集学生报名信息，新报名自动生成表格记录
- 飞书开放平台需要申请 3 个指定权限，订阅新记录创建事件，才能实现自动化监听和操作
- 支持两个核心自动化场景：新报名自动生成课程邀请链接并私聊推送、成绩达标后自动发放证书
- 从浏览器地址栏提取飞书多维表格的
App Token和Table ID，填入OpenClaw配置即可完成对接
1. 飞书多维表格设置
要实现 AI 课堂的统计与自动化，需要按照以下步骤配置飞书多维表格。
1.1 创建数据表 (Table Schema)
创建一个名为「AI 课堂学生成绩统计」的多维表格，需要包含以下关键字段：
| 字段名 | 类型 | 说明 |
|---|---|---|
| 学生姓名 | 文本 | - |
| 飞书 OpenID | 文本 | 用于私聊推送 (通过 OpenClaw 自动填入) |
| 课程名称 | 选项 | - |
| 测验得分 | 数字 | 由 OpenMAIC 回传 |
| 签到状态 | 复选框 | - |
| 学习进度 | 百分比 | - |
| 最后活跃时间 | 日期 | - |
1.2 创建报名表单 (Form)
- 在多维表格中添加一个「表单视图」
- 发布表单，学生填写后，新记录会自动添加到表格中
2. 飞书开放平台配置
- 权限申请:
bitable:app(查看和管理多维表格)im:message(发送消息)contact:user.employee:readonly(读取员工信息)
- 事件订阅:
- 订阅
bitable.app.record.created_v1事件，以便 OpenClaw 能监听到新报名。
- 订阅
3. 自动化场景示例
3.1 报名成功自动邀请
- 触发器: 多维表格中有新纪录
- 操作: OpenClaw 调用 OpenMAIC 接口生成链接，并私聊发送
文字歧义提示：原始资料原文写为「新纪录」，应为「新记录」笔误，此处保留原文未修改
3.2 成绩达标自动发证
- 触发器: 测验得分字段更新且大于 80 分
- 操作: 飞书原生自动化流发送一份精美的证书图片
4. 获取 App Token 和 Table ID
- 在浏览器地址栏中获取：
https://feishu.cn/base/[APP_TOKEN]?table=[TABLE_ID] - 将这两个 ID 填入 OpenClaw 的
feishu插件配置中
引用证据
原始来源路径：
raw/BITABLE_GUIDE.md
飞书多维表格 (Bitable) 接入与自动化指南 (BITABLE_GUIDE.md)
1. 飞书多维表格设置
要实现 AI 课堂的统计与自动化，你需要按照以下步骤配置飞书多维表格。
1.1 创建数据表 (Table Schema)
创建一个名为“AI 课堂学生成绩统计”的多维表格，包含以下关键字段：
| 字段名 | 类型 | 说明 |
|---|---|---|
| 学生姓名 | 文本 | - |
| 飞书 OpenID | 文本 | 用于私聊推送 (通过 OpenClaw 自动填入) |
| 课程名称 | 选项 | - |
| 测验得分 | 数字 | 由 OpenMAIC 回传 |
| 签到状态 | 复选框 | - |
| 学习进度 | 百分比 | - |
| 最后活跃时间 | 日期 | - |
1.2 创建报名表单 (Form)
- 在多维表格中添加一个“表单视图”。
- 发布表单，学生填写后，新记录会自动添加到表格中。
2. 飞书开放平台配置
- 权限申请:
bitable:app(查看和管理多维表格)im:message(发送消息)contact:user.employee:readonly(读取员工信息)
- 事件订阅:
- 订阅
bitable.app.record.created_v1事件，以便 OpenClaw 能监听到新报名。
- 订阅
3. 自动化场景示例
3.1 报名成功自动邀请
- 触发器: 多维表格中有新纪录。
- 操作: OpenClaw 调用 OpenMAIC 接口生成链接，并私聊发送。
3.2 成绩达标自动发证
- 触发器: 测验得分字段更新且大于 80 分。
- 操作: 飞书原生自动化流发送一份精美的证书图片。
4. 获取 App Token 和 Table ID
- 在浏览器地址栏中获取：
https://feishu.cn/base/[APP_TOKEN]?table=[TABLE_ID] - 将这两个 ID 填入 OpenClaw 的
feishu插件配置中。