feishu-bitable

Q: How do I install feishu-bitable?

Run npx skills add https://github.com/larksuite/openclaw-lark --skill feishu-bitable in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/feishu-bitable/ (personal) or .claude/skills/feishu-bitable/ (project).

by larksuiteProductivity & Automation

飞书多维表格（Bitable）的创建、查询、编辑和管理工具。包含 27 种字段类型支持、高级筛选、批量操作和视图管理。当以下情况时使用此 Skill： (1) 需要创建或管理飞书多维表格 App (2) 需要在多维表格中新增、查询、修改、删除记录（行数据） (3) 需要管理字段（列）、视图、数据表 (4) 用户提到"多维表格"、"bitable"、"数据表"、"记录"、"字段" (5) 需要批量导入数据或批量更新多维表格

Installs: 580
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/larksuite/openclaw-lark --skill feishu-bitable

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads feishu-bitable automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Feishu Bitable (多维表格) SKILL

🚨 执行前必读

✅ 创建数据表：支持两种模式 — ① 明确需求时，在 create 时通过 table.fields 一次性定义字段（减少 API 调用）；② 探索式场景时，使用默认表 + 逐步修改字段（更稳定，易调整）
⚠️ 默认表的空行坑：app.create 自带的默认表中会有空记录（空行）！插入数据前建议先调用 feishu_bitable_app_table_record.list + batch_delete 删除空行，避免数据污染
✅ 写记录前：先调用 feishu_bitable_app_table_field.list 获取字段 type/ui_type
✅ 人员字段：默认 open_id（ou_...），值必须是 [{id:"ou_xxx"}]（数组对象）
✅ 日期字段：毫秒时间戳（例如 1674206443000），不是秒
✅ 单选字段：字符串（例如 "选项1"），不是数组
✅ 多选字段：字符串数组（例如 ["选项1", "选项2"]）
✅ 附件字段：必须先上传到当前多维表格，使用返回的 file_token
✅ 批量上限：单次 ≤ 500 条，超过需分批（批量操作是原子性的）
✅ 并发限制：同一数据表不支持并发写，需串行调用 + 延迟 0.5-1 秒

📋 快速索引：意图 → 工具 → 必填参数

用户意图	工具	action	必填参数	常用可选
查表有哪些字段	feishu_bitable_app_table_field	list	app_token, table_id	-
查记录	feishu_bitable_app_table_record	list	app_token, table_id	filter, sort, field_names
新增一行	feishu_bitable_app_table_record	create	app_token, table_id, fields	-
批量导入	feishu_bitable_app_table_record	batch_create	app_token, table_id, records (≤500)	-
更新一行	feishu_bitable_app_table_record	update	app_token, table_id, record_id, fields	-
批量更新	feishu_bitable_app_table_record	batch_update	app_token, table_id, records (≤500)	-
创建多维表格	feishu_bitable_app	create	name	folder_token
创建数据表	feishu_bitable_app_table	create	app_token, name	fields
创建字段	feishu_bitable_app_table_field	create	app_token, table_id, field_name, type	property
创建视图	feishu_bitable_app_table_view	create	app_token, table_id, view_name, view_type	-

🎯 核心约束（Schema 未透露的知识）

📚 详细参考文档

当遇到字段配置、记录值格式问题或需要完整示例时，查阅以下文档：

字段 Property 配置详解 - 每种字段类型创建/更新时需要的 property 参数结构（单选的 options、进度的 min/max、关联的 table_id 等）
记录值数据结构详解 - 每种字段类型在记录中对应的 fields 值格式（人员字段只传 id、日期是毫秒时间戳、附件需先上传等）
使用场景完整示例 - 8 个完整场景示例（创建表模式对比、批量导入、筛选查询、附件处理、关联字段等）

何时查阅:

创建/更新字段时收到 125408X 错误码（property 结构错误）→ 查 field-properties.md
写入记录时收到 125406X 错误码（字段值转换失败）→ 查 record-values.md
需要完整的操作流程和参数示例 → 查 examples.md

1. 字段类型与值格式必须严格匹配

Bitable 最大的坑：不同字段类型对 value 的数据结构要求完全不同。

最易错的字段类型（完整列表见 record-values.md）

type	ui_type	字段类型	正确格式	❌ 常见错误
11	User	人员	`[{id: "ou_xxx"}]`	传字符串 `"ou_xxx"` 或 `[{name: "张三"}]`
5	DateTime	日期	`1674206443000`（毫秒）	传秒时间戳或字符串
3	SingleSelect	单选	`"选项名"`	传数组 `["选项名"]`
4	MultiSelect	多选	`["选项1", "选项2"]`	传字符串 `"选项1"`
15	Url	超链接	`{link: "...", text: "..."}`	只传字符串 URL
17	Attachment	附件	`[{file_token: "..."}]`	传外部 URL 或本地路径

强制流程：

先调用 feishu_bitable_app_table_field.list 获取字段的 type 和 ui_type
根据上表或 record-values.md 构造正确格式
错误码 125406X 或 1254015 → 检查字段值格式

人员字段特别注意：

默认使用 open_id（ou_...），与 calendar/task 一致
格式：[{id: "ou_xxx"}]（数组对象）
只能传 id 字段，不能传 name/email 等

📌 核心使用场景

完整示例: 查阅 examples.md 了解更多场景（创建表模式对比、空行处理、附件上传、关联字段等）

场景 1: 查字段类型（必做第一步）

{
  "action": "list",
  "app_token": "S404b...",
  "table_id": "tbl..."
}

返回：包含每个字段的 field_id、field_name、type、ui_type、property

场景 2: 批量导入客户数据

{
  "action": "batch_create",
  "app_token": "S404b...",
  "table_id": "tbl...",
  "records": [
    {
      "fields": {
        "客户名称": "Bytedance",
        "负责人": [{"id": "ou_xxx"}],
        "签约日期": 1674206443000,
        "状态": "进行中"
      }
    },
    {
      "fields": {
        "客户名称": "飞书",
        "负责人": [{"id": "ou_yyy"}],
        "签约日期": 1675416243000,
        "状态": "已完成"
      }
    }
  ]
}

字段值格式：

人员：[{id: "ou_xxx"}]（数组对象）
日期：毫秒时间戳
单选：字符串
多选：字符串数组

限制: 最多 500 条记录

场景 3: 筛选查询（高级筛选）

{
  "action": "list",
  "app_token": "S404b...",
  "table_id": "tbl...",
  "filter": {
    "conjunction": "and",
    "conditions": [
      {
        "field_name": "状态",
        "operator": "is",
        "value": ["进行中"]
      },
      {
        "field_name": "截止日期",
        "operator": "isLess",
        "value": ["ExactDate", "1740441600000"]
      }
    ]
  },
  "sort": [
    {
      "field_name": "截止日期",
      "desc": false
    }
  ]
}

filter 说明：

支持 10 种 operator（is/isNot/contains/isEmpty 等，见附录 C）
⚠️ isEmpty/isNotEmpty 必须传 value: []（虽然逻辑上不需要值，但 API 要求必须传空数组）
日期筛选可使用 ["Today"]、["ExactDate", "时间戳"] 等
sort 可指定多个排序字段

🔍 常见错误与排查

错误码	错误现象	根本原因	解决方案
1254064	DatetimeFieldConvFail	日期字段格式错误	必须用毫秒时间戳（如 `1772121600000`），不能用字符串（`"2026-02-27"`、RFC3339）或秒级时间戳
1254068	URLFieldConvFail	超链接字段格式错误	必须用对象 `{text: "显示文本", link: "URL"}`，不能直接传字符串 URL
1254066	UserFieldConvFail	人员字段格式错误或 ID 类型不匹配	必须传 `[{id: "ou_xxx"}]`，确认 `user_id_type`
1254015	Field types do not match	字段值格式与类型不匹配	先 list 字段，按类型构造正确格式
1254104	RecordAddOnceExceedLimit	批量创建超过 500 条	分批调用，每批 ≤ 500
1254291	Write conflict	并发写冲突	串行调用 + 延迟 0.5-1 秒
1254303	AttachPermNotAllow	附件未上传到当前表格	先调用上传素材接口
1254045	FieldNameNotFound	字段名不存在	检查字段名（包括空格、大小写）

📚 附录：背景知识

A. 资源层级关系

App (多维表格应用)
 ├── Table (数据表) ×100
 │    ├── Record (记录/行) ×20,000
 │    ├── Field (字段/列) ×300
 │    └── View (视图) ×200
 └── Dashboard (仪表盘)

B. 筛选条件 operator 列表

operator	含义	支持字段	value 要求
`is`	等于	所有	单个值
`isNot`	不等于	除日期外	单个值
`contains`	包含	除日期外	可多个值
`doesNotContain`	不包含	除日期外	可多个值
`isEmpty`	为空	所有	必须为 `[]`
`isNotEmpty`	不为空	所有	必须为 `[]`
`isGreater`	大于	数字、日期	单个值
`isGreaterEqual`	大于等于	数字（不支持日期）	单个值
`isLess`	小于	数字、日期	单个值
`isLessEqual`	小于等于	数字（不支持日期）	单个值

日期字段特殊值: ["Today"], ["Tomorrow"], ["ExactDate", "时间戳"] 等（完整列表见 examples.md）

C. 使用限制

限制项	上限
数据表 + 仪表盘	100（单个 App）
记录数	20,000（单个数据表）
字段数	300（单个数据表）
视图数	200（单个数据表）
批量创建/更新/删除	500（单次 API 调用）
单元格文本	10 万字符
单选/多选选项	20,000（单个字段）
单元格附件	100
单元格人员	1,000

D. 其他约束

从其他数据源同步的数据表，不支持增删改记录
公式字段、查看引用字段是只读的
删除操作无法恢复
视图筛选条件使用 field_id，需先调用 field.list 获取

FAQ

What does the feishu-bitable skill do?

How do I install feishu-bitable?

Run npx skills add https://github.com/larksuite/openclaw-lark --skill feishu-bitable in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/feishu-bitable/ (personal) or .claude/skills/feishu-bitable/ (project).

Which AI agents can use feishu-bitable?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is feishu-bitable safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains feishu-bitable?

It is published by larksuite in larksuite/openclaw-lark. It has 580 recorded installs.

Popular productivity & automation skills

View category →

agent-browser

vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

OfficialProductivity & Automation1.3M installs

lark-doc

open.feishu.cn

飞书云文档（Docx / Wiki）内容操作：读取、创建、编辑文档，插入或下载图片附件，以及操作思维笔记。用户提供文档 URL/token（包括 doubao.com 的 /docx/、/wiki/）时使用；按 URL 路径/token 而非域名路由；/page/ 是妙搭应用，非飞书云文档。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive；随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。

Productivity & Automation815.7K installs

lark-base

open.feishu.cn

飞书多维表格（Base）操作：建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、应用模式（BaseApp/AppMode 页面与组件）、Workspace 目录、workflow、角色权限、模板中心（多维表格模板分类/列表/搜索）；遇到 Base/多维表格/bitable、BaseApp/AppMode、/base/ 或 /app/ 链接时使用。BaseApp 不走 lark-apps；文件导入/导出转 lark-drive，认证/授权转 lark-shared。

Productivity & Automation815K installs

lark-drive

open.feishu.cn

飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、查询权限设置、评论/权限/订阅、标题、版本、飞书文档密级标签（secure labels）和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题，或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sheet/bitable/slides 时使用；doubao.com 云空间 URL/token 也按资源路径和 token 路由，不回退 WebFetch。不负责：文档内容编辑（走 lark-doc）、表格/Base 表内数据操作（走 lark-sheets/lark-base）、知识空间节点/成员管理（走 lark-wiki）、原生 Markdown 文件读写/patch/diff（走 lark-markdown）。

Productivity & Automation815K installs

lark-shared

open.feishu.cn

Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling notice JSON.

Productivity & Automation814.8K installs

lark-im

open.feishu.cn

飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片（Interactive Card）、监听卡片按钮回调（card.action.trigger）。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据、管理 Feed 置顶（添加/移除/查询置顶会话）、管理标签数据、处理卡片回调时使用。

Productivity & Automation814.1K installs

feishu-bitable

Install

Install

Describe the task

Review the result

SKILL.md

Feishu Bitable (多维表格) SKILL

🚨 执行前必读

📋 快速索引：意图 → 工具 → 必填参数

🎯 核心约束（Schema 未透露的知识）

📚 详细参考文档

1. 字段类型与值格式必须严格匹配

最易错的字段类型（完整列表见 record-values.md）

📌 核心使用场景

场景 1: 查字段类型（必做第一步）

场景 2: 批量导入客户数据

场景 3: 筛选查询（高级筛选）

🔍 常见错误与排查

📚 附录：背景知识

A. 资源层级关系

B. 筛选条件 operator 列表

C. 使用限制

D. 其他约束

FAQ

More from larksuite/openclaw-lark

feishu-create-doc

feishu-im-read

feishu-calendar

feishu-fetch-doc

feishu-update-doc

feishu-task

Popular productivity & automation skills

agent-browser

lark-doc

lark-base

lark-drive

lark-shared

lark-im