运行时依赖
安装命令
点击复制技能文档
DingTalk Bitable 技能
钉钉多维表格(Bitable)API 集成,提供表格管理、数据增删改查等功能。
功能 📊 表格管理 获取表格列表 创建新表格 获取表格结构(字段/列) 删除表格 📝 数据操作 查询记录(支持筛选、排序) 新增记录 更新记录 删除记录 批量操作 🔍 高级功能 字段管理(添加/修改/删除字段) 视图管理 数据导入导出 配置 钉钉应用权限
需要在钉钉开放平台申请以下权限:
多维表格权限 应用访问权限 凭证配置
技能自动从 OpenClaw.json 的钉钉 channel 配置中读取凭证,无需额外配置。
工具 bitable_列出
获取表格列表
参数:
space_id (可选): 空间 ID limit (可选): 返回数量限制,默认 20 bitable_获取_meta
获取表格元数据
参数:
应用_令牌 (必需): 表格应用 令牌(从 URL 获取) bitable_列出_fields
获取表格字段列表
参数:
应用_令牌 (必需): 表格应用 令牌 table_id (必需): 表格 ID bitable_列出_records
查询记录
参数:
应用_令牌 (必需): 表格应用 令牌 table_id (必需): 表格 ID 过滤器 (可选): 筛选条件 排序 (可选): 排序字段 page_size (可选): 每页数量,默认 100 page_令牌 (可选): 分页 令牌 bitable_获取_record
获取单条记录
参数:
应用_令牌 (必需): 表格应用 令牌 table_id (必需): 表格 ID record_id (必需): 记录 ID bitable_创建_record
新增记录
参数:
应用_令牌 (必需): 表格应用 令牌 table_id (必需): 表格 ID fields (必需): 字段值(JSON 对象) bitable_更新_record
更新记录
参数:
应用_令牌 (必需): 表格应用 令牌 table_id (必需): 表格 ID record_id (必需): 记录 ID fields (必需): 要更新的字段值 bitable_删除_record
删除记录
参数:
应用_令牌 (必需): 表格应用 令牌 table_id (必需): 表格 ID record_id (必需): 记录 ID bitable_创建_field
添加字段
参数:
应用_令牌 (必需): 表格应用 令牌 table_id (必需): 表格 ID field_name (必需): 字段名称 field_type (必需): 字段类型(Text/Number/Date/SingleSelect/MultiSelect/检查box/User/Phone/URL) 使用示例 # 获取表格列表 bitable_列出 limit=10
# 获取表格元数据(从 URL /base/XXX 或 /wiki/XXX 获取 应用_令牌) bitable_获取_meta 应用_令牌="Stbqxxxxxxxxxxxxxx"
# 查看表格字段 bitable_列出_fields 应用_令牌="Stbqxxxxxxxxxxxxxx" table_id="tblxxxxxxxxxxxxxx"
# 查询记录 bitable_列出_records 应用_令牌="Stbqxxxxxxxxxxxxxx" table_id="tblxxxxxxxxxxxxxx" page_size=50
# 新增记录 bitable_创建_record 应用_令牌="Stbqxxxxxxxxxxxxxx" table_id="tblxxxxxxxxxxxxxx" fields='{"姓名":"张三","部门":"研发部","入职日期":"2026-03-19"}'
# 更新记录 bitable_更新_record 应用_令牌="Stbqxxxxxxxxxxxxxx" table_id="tblxxxxxxxxxxxxxx" record_id="recxxxxxxxxxxxxxx" fields='{"部门":"产品部"}'
# 删除记录 bitable_删除_record 应用_令牌="Stbqxxxxxxxxxxxxxx" table_id="tblxxxxxxxxxxxxxx" record_id="recxxxxxxxxxxxxxx"
# 添加字段 bitable_创建_field 应用_令牌="Stbqxxxxxxxxxxxxxx" table_id="tblxxxxxxxxxxxxxx" field_name="手机号" field_type="Phone"
字段类型说明 类型 说明 示例值 Text 文本 "张三" Number 数字 123 Date 日期 1710835200000 (毫秒时间戳) SingleSelect 单选 "选项 A" MultiSelect 多选 ["选项 A", "选项 B"] 检查box 复选框 true User 成员 [{"id":"zhangsan"}] Phone 手机号 "13800138000" URL 链接 {"text":"显示文本","link":"https://..."} 实现位置
技能实现位于:/volume1/OpenClaw/workspace/技能s/dingtalk-bitable/
包含文件:
技能.md - 技能定义 dingtalk_bitable.py - API 实现 运行.py - 工具执行入口 manifest.json - 工具定义 错误处理 凭证无效:返回认证错误 权限不足:提示需要申请的权限 API 限流:自动重试 表格不存在:返回明确的错误信息 相关资源 钉钉开放平台文档:https://open.dingtalk.com/document/org应用/overview-of-dingtalk-tables API 参考:https://open.dingtalk.com/document/org应用