DingTalk Bitable 技能#

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

功能#

📊 表格管理#

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

📝 数据操作#

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

🔍 高级功能#

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

配置#

钉钉应用权限#

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

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

凭证配置#

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

工具#

bitable_list#

获取表格列表

参数：

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

bitable_get_meta#

获取表格元数据

参数：

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

bitable_list_fields#

获取表格字段列表

参数：

• app_token (必需): 表格应用 token
• table_id (必需): 表格 ID

bitable_list_records#

查询记录

参数：

• app_token (必需): 表格应用 token
• table_id (必需): 表格 ID
• filter (可选): 筛选条件
• sort (可选): 排序字段
• page_size (可选): 每页数量，默认 100
• page_token (可选): 分页 token

bitable_get_record#

获取单条记录

参数：

• app_token (必需): 表格应用 token
• table_id (必需): 表格 ID
• record_id (必需): 记录 ID

bitable_create_record#

新增记录

参数：

• app_token (必需): 表格应用 token
• table_id (必需): 表格 ID
• fields (必需): 字段值（JSON 对象）

bitable_update_record#

更新记录

参数：

• app_token (必需): 表格应用 token
• table_id (必需): 表格 ID
• record_id (必需): 记录 ID
• fields (必需): 要更新的字段值

bitable_delete_record#

删除记录

参数：

• app_token (必需): 表格应用 token
• table_id (必需): 表格 ID
• record_id (必需): 记录 ID

bitable_create_field#

添加字段

参数：

• app_token (必需): 表格应用 token
• table_id (必需): 表格 ID
• field_name (必需): 字段名称
• field_type (必需): 字段类型（Text/Number/Date/SingleSelect/MultiSelect/Checkbox/User/Phone/URL）

使用示例#

text

# 获取表格列表
bitable_list limit=10

# 获取表格元数据（从 URL /base/XXX 或 /wiki/XXX 获取 app_token）
bitable_get_meta app_token="Stbqxxxxxxxxxxxxxx"

# 查看表格字段
bitable_list_fields app_token="Stbqxxxxxxxxxxxxxx" table_id="tblxxxxxxxxxxxxxx"

# 查询记录
bitable_list_records app_token="Stbqxxxxxxxxxxxxxx" table_id="tblxxxxxxxxxxxxxx" page_size=50

# 新增记录
bitable_create_record app_token="Stbqxxxxxxxxxxxxxx" table_id="tblxxxxxxxxxxxxxx" fields='{"姓名":"张三","部门":"研发部","入职日期":"2026-03-19"}'

# 更新记录
bitable_update_record app_token="Stbqxxxxxxxxxxxxxx" table_id="tblxxxxxxxxxxxxxx" record_id="recxxxxxxxxxxxxxx" fields='{"部门":"产品部"}'

# 删除记录
bitable_delete_record app_token="Stbqxxxxxxxxxxxxxx" table_id="tblxxxxxxxxxxxxxx" record_id="recxxxxxxxxxxxxxx"

# 添加字段
bitable_create_field app_token="Stbqxxxxxxxxxxxxxx" table_id="tblxxxxxxxxxxxxxx" field_name="手机号" field_type="Phone"

字段类型说明#

类型说明示例值Text文本"张三"Number数字123Date日期1710835200000 (毫秒时间戳)SingleSelect单选"选项 A"MultiSelect多选["选项 A", "选项 B"]Checkbox复选框trueUser成员[{"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 限流：自动重试
• 表格不存在：返回明确的错误信息

相关资源#

• 钉钉开放平台文档： https://open.dingtalk.com/document/orgapp/overview-of-dingtalk-tables
• API 参考： https://open.dingtalk.com/document/orgapp