HomeBrowseUpload
← Back to registry
// Skill profile

DingTalk Bitable 技能

name: dingtalk-bitable

by cxwos · published 2026-03-22

数据处理API集成加密货币
Total installs
0
Stars
★ 0
Last updated
2026-03
// Install command
$ claw add gh:cxwos/cxwos-dingtalk-bitable
View on GitHub
// Full documentation

---

name: dingtalk-bitable

description: "钉钉多维表格 API 集成 - 表格管理、数据 CRUD。Use when: user asks about DingTalk bitable, table, database, spreadsheet."

metadata: { "openclaw": { "emoji": "📊", "requires": { "python": ["requests"] } } }

---

# 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)
  • 使用示例

    # 获取表格列表
    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 | 数字 | 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 限流:自动重试
  • 表格不存在:返回明确的错误信息
  • 相关资源

  • 钉钉开放平台文档:https://open.dingtalk.com/document/orgapp/overview-of-dingtalk-tables
  • API 参考:https://open.dingtalk.com/document/orgapp
  • // Comments
    Sign in with GitHub to leave a comment.
    // Related skills

    More tools from the same signal band