OpenMAIC 飞书多维表格 (Bitable) 接入与自动化指南
TL;DR
本指南用于为 AI 课堂配置飞书多维表格接入，实现报名自动化、成绩统计、自动邀请/发证等业务流程，核心步骤分为多维表格创建、飞书开放平台权限配置、获取对应ID填入系统即可启用自动化。
目录
配置总览
| 配置项 | 说明 |
|---|---|
| 依赖服务 | 飞书多维表格、飞书开放平台、OpenMAIC、OpenClaw |
| 核心能力 | AI 课堂报名、签到统计、成绩回传、自动化触发业务动作 |
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/Openmaic/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插件配置中。
冲突标注
当前来源无其他交叉来源，未发现内容矛盾。