Feishu Bitable API

飞书多维表格(Bitable)技能

用于操作飞书多维表格的完整技能，支持数据表、记录和字段的CRUD操作。

功能特性 ✅ 数据表管理（创建、列表、获取、删除） ✅ 记录管理（创建、读取、更新、删除、批量操作） ✅ 字段管理（创建、列表、更新） ✅ 视图管理（列表、获取） ✅ 应用管理（获取应用信息） 环境变量配置 # 飞书应用ID 导出 FEISHU_应用_ID=命令行工具_xxxxxx

# 飞书应用密钥（或密钥文件路径） 导出 FEISHU_应用_SECRET=your_应用_secret # 或 导出 FEISHU_应用_SECRET_PATH=~/.clawd机器人/secrets/feishu_应用_secret

快速开始

• 安装依赖

cd 技能s/feishu-bitable npm 安装

• 设置环境变量

导出 FEISHU_应用_ID=命令行工具_xxxxxx 导出 FEISHU_应用_SECRET=your_应用_secret

• 使用命令行工具工具

# 获取帮助 node bitable-命令行工具.js --help

# 列出所有数据表 node bitable-命令行工具.js 列出-tables --应用-令牌 basxxxxxx

# 创建新记录 node bitable-命令行工具.js 创建-record --应用-令牌 basxxxxxx --table-id tblxxxxxx --data '{"字段1": "值1", "字段2": "值2"}'

# 查询记录 node bitable-命令行工具.js 列出-records --应用-令牌 basxxxxxx --table-id tblxxxxxx

API端点 数据表相关 获取 /bitable/v1/应用s/{应用_令牌}/tables - 获取数据表列表 POST /bitable/v1/应用s/{应用_令牌}/tables - 创建数据表 获取 /bitable/v1/应用s/{应用_令牌}/tables/{table_id} - 获取数据表详情 删除 /bitable/v1/应用s/{应用_令牌}/tables/{table_id} - 删除数据表 记录相关 POST /bitable/v1/应用s/{应用_令牌}/tables/{table_id}/records - 新增记录 获取 /bitable/v1/应用s/{应用_令牌}/tables/{table_id}/records - 获取记录列表 PUT /bitable/v1/应用s/{应用_令牌}/tables/{table_id}/records/{record_id} - 更新记录 删除 /bitable/v1/应用s/{应用_令牌}/tables/{table_id}/records/{record_id} - 删除记录 POST /bitable/v1/应用s/{应用_令牌}/tables/{table_id}/records/batch_创建 - 批量新增记录 POST /bitable/v1/应用s/{应用_令牌}/tables/{table_id}/records/batch_更新 - 批量更新记录 POST /bitable/v1/应用s/{应用_令牌}/tables/{table_id}/records/batch_删除 - 批量删除记录 字段相关 获取 /bitable/v1/应用s/{应用_令牌}/tables/{table_id}/fields - 获取字段列表 POST /bitable/v1/应用s/{应用_令牌}/tables/{table_id}/fields - 创建字段 PUT /bitable/v1/应用s/{应用_令牌}/tables/{table_id}/fields/{field_id} - 更新字段 视图相关 获取 /bitable/v1/应用s/{应用_令牌}/tables/{table_id}/views - 获取视图列表 获取 /bitable/v1/应用s/{应用_令牌}/tables/{table_id}/views/{view_id} - 获取视图详情 使用示例

• 创建数据表

node bitable-命令行工具.js 创建-table \ --应用-令牌 basxxxxxx \ --name "任务管理" \ --fields '[{"field_name": "任务名称", "type": "text"}, {"field_name": "状态", "type": "select", "property": {"options": [{"name": "待办"}, {"name": "进行中"}, {"name": "已完成"}]}}]'

• 添加记录

node bitable-命令行工具.js 创建-record \ --应用-令牌 basxxxxxx \ --table-id tblxxxxxx \ --data '{"任务名称": "完成API开发", "状态": "进行中", "优先级": "高", "截止日期": "2024-12-31"}'

• 查询记录

node bitable-命令行工具.js 列出-records \ --应用-令牌 basxxxxxx \ --table-id tblxxxxxx \ --过滤器 '{"conjunction": "and", "conditions": [{"field_name": "状态", "operator": "is", "value": ["进行中"]}]}' \ --排序 '["-创建时间"]' \ --page-size 50

• 批量操作

node bitable-命令行工具.js batch-创建 \ --应用-令牌 basxxxxxx \ --table-id tblxxxxxx \ --data-file records.json

字段类型支持

飞书多维表格支持以下字段类型：

text - 文本 number - 数字 single_select - 单选 multi_select - 多选 date - 日期 person - 人员 检查box - 复选框 url - 链接 phone - 电话 emAIl - 邮箱 attachment - 附件 formula - 公式 创建d_time - 创建时间 modified_time - 修改时间 创建d_by - 创建人 modified_by - 修改人 错误处理

技能包含完整的错误处理机制：

网络错误重试 权限验证 参数验证 速率限制处理 注意事项 权限要求：应用需要具备bitable:record:readonly和bitable:record:write权限 速率限制：飞书API有速率限制，建议添加适当的延迟 数据大小：单次请求记录数量建议不超过100条 字段名称：字段名称在表中必须唯一 Clawd机器人集成 在Clawd机器人中使用此技能 确保技能已安装：技能应该位于 技能s/feishu-bitable 目录 设置环境变量：在Clawd机器人配置中设置飞书应用凭证 在对话中调用：Clawd机器人可以调用此技能来操作飞书多维表格 示例对话

用户: "帮我在飞书多维表格中添加一个任务" Clawd机器人:

# 使用技能添加任务 node 技能s/feishu-bitable/bin/命令行工具.js 创建-record \ --应用-令牌 basxxxxxx \ --table-id tblxxxxxx \ --data '{"任务名称": "新任务", "状态": "待办", "优先级": "中"}'

自动化工作流

你可以创建自动化工作流，例如：

每天同步任务状态 从其他系统导入数据到飞书多维表格 根据条件自动更新记录 生成报表并发送到飞书群聊 开发指南

如需扩展功能，请参考：

src/API.js - API客户端 src/命令行工具.js - 命令行接口 src/utils.js - 工具函数 添加新的API端点 在 src/API.js 的 FeishuBitableAPI 类中添加新方法 在 bin/命令行工具.js 中添加对应的命令 更新文档 错误处理最佳实践 使用 try-catch 包装所有API调用 提供有意义的错误消息 实现重试逻辑处理网络错误 验证输入参数