类型	说明	示例值
Text	文本	"张三"
Number

DingTalk Bitable 技能

钉钉多维表格（Bitable）API 集成，提供表格管理、数据增删改查等功能。

功能

📊 表格管理

- 获取表格列表
创建新表格
获取表格结构（字段/列）
删除表格

📝 数据操作

- 查询记录（支持筛选、排序）
新增记录
更新记录
删除记录
批量操作

🔍 高级功能

- 字段管理（添加/修改/删除字段）
视图管理
数据导入导出

配置

钉钉应用权限

需要在钉钉开放平台申请以下权限：

- 多维表格权限
应用访问权限

凭证配置

技能自动从 openclaw.json 的钉钉 channel 配置中读取凭证，无需额外配置。

工具

bitable_list

获取表格列表

参数：

- space_id (可选): 空间 ID
limit (可选): 返回数量限制，默认 20

bitablegetmeta

获取表格元数据

参数：

- app_token (必需): 表格应用 token（从 URL 获取）

bitablelistfields

获取表格字段列表

参数：

- apptoken (必需): 表格应用 token
tableid (必需): 表格 ID

bitablelistrecords

查询记录

参数：

- apptoken (必需): 表格应用 token
tableid (必需): 表格 ID
filter (可选): 筛选条件
sort (可选): 排序字段
pagesize (可选): 每页数量，默认 100
pagetoken (可选): 分页 token

bitablegetrecord

获取单条记录

参数：

- apptoken (必需): 表格应用 token
tableid (必需): 表格 ID
record_id (必需): 记录 ID

bitablecreaterecord

新增记录

参数：

- apptoken (必需): 表格应用 token
tableid (必需): 表格 ID
fields (必需): 字段值（JSON 对象）

bitableupdaterecord

更新记录

参数：

- apptoken (必需): 表格应用 token
tableid (必需): 表格 ID
record_id (必需): 记录 ID
fields (必需): 要更新的字段值

bitabledeleterecord

删除记录

参数：

- apptoken (必需): 表格应用 token
tableid (必需): 表格 ID
record_id (必需): 记录 ID

bitablecreatefield

添加字段

参数：

- apptoken (必需): 表格应用 token
tableid (必需): 表格 ID
fieldname (必需): 字段名称
fieldtype (必需): 字段类型（Text/Number/Date/SingleSelect/MultiSelect/Checkbox/User/Phone/URL）

使用示例

获取表格列表

bitable_list limit=10

获取表格元数据（从 URL /base/XXX 或 /wiki/XXX 获取 app_token）

bitablegetmeta app_token=Stbqxxxxxxxxxxxxxx

查看表格字段

bitablelistfields apptoken=Stbqxxxxxxxxxxxxxx tableid=tblxxxxxxxxxxxxxx

查询记录

bitablelistrecords apptoken=Stbqxxxxxxxxxxxxxx tableid=tblxxxxxxxxxxxxxx page_size=50

新增记录

bitablecreaterecord apptoken=Stbqxxxxxxxxxxxxxx tableid=tblxxxxxxxxxxxxxx fields={姓名:张三,部门:研发部,入职日期:2026-03-19}

更新记录

bitableupdaterecord apptoken=Stbqxxxxxxxxxxxxxx tableid=tblxxxxxxxxxxxxxx record_id=recxxxxxxxxxxxxxx fields={部门:产品部}

删除记录

bitabledeleterecord apptoken=Stbqxxxxxxxxxxxxxx tableid=tblxxxxxxxxxxxxxx record_id=recxxxxxxxxxxxxxx

添加字段

bitablecreatefield apptoken=Stbqxxxxxxxxxxxxxx tableid=tblxxxxxxxxxxxxxx fieldname=手机号 fieldtype=Phone

字段类型说明

类型	说明	示例值
Text	文本	张三
Number

数字 | 123 | | Date | 日期 | 1710835200000 (毫秒时间戳) | | SingleSelect | 单选 | 选项 A | | MultiSelect | 多选 | [选项 A, 选项 B] | | Checkbox | 复选框 | true | | User | 成员 | [{id:zhangsan}] | | Phone | 手机号 | 13800138000 | | URL | 链接 | {text:显示文本,link:https://...} |

实现位置

技能实现位于：/volume1/openclaw/workspace/skills/dingtalk-bitable/

包含文件：

- SKILL.md - 技能定义
dingtalk_bitable.py - API 实现
run.py - 工具执行入口
manifest.json - 工具定义

错误处理

- 凭证无效：返回认证错误
权限不足：提示需要申请的权限
API 限流：自动重试
表格不存在：返回明确的错误信息

dingtalk-bitable钉钉多维表