What makes 飞书Bitable管理工具 notable?

959 downloads. Trust evidence available

How should 飞书Bitable管理工具 be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

飞书Bitable管理工具

飞书多维表格（Bitable）的创建、查询、编辑和管理工具。包含 27 种字段类型支持、高级筛选、批量操作和视图管理。 **当以下情况时使用此 Skill**： (1) 需要创建或管理飞书多维表格 App (2) 需要在多维表格中新增、查询、修改、删除记录（行数据） (3) 需要管理字段（列）、视图、数据表 (4... Skill: 飞书Bitable管理工具 Owner: a3152557994-ship-it Summary: 飞书多维表格（Bitable）的创建、查询、编辑和管理工具。包含 27 种字段类型支持、高级筛选、批量操作和视图管理。 **当以下情况时使用此 Skill**： (1) 需要创建或管理飞书多维表格 App (2) 需要在多维表格中新增、查询、修改、删除记录（行数据） (3) 需要管理字段（列）、视图、数据表 (4... Tags: latest:1.0.0 Version history: v1.0.0 | 2026-04-24T06:33:44.892Z | auto - 首发版本，支持飞书多维表格（Bitable）全功能操作 - 实现 27 种字段类型的表结构管理、查询和批量数据操作 - 提供详细字段格式、数据导入、筛选、并发、批量等最佳实践说明 - 补充常见错误码及排查，详解字段类型、导入格式和极易踩坑点 -

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

959

Updated

Oct 12, 2026

Version

1.0.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 959 downloads reported by the source. Last updated 10/12/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 12, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 12, 2026
Adoption signal: 959 downloadsadoption · observed Oct 12, 2026
Latest release: 1.0.0release · observed Apr 24, 2026
Handshake status: UNKNOWNsecurity

What changed

Newest first. Only changes that point at a source are listed.

Release 1.0.0release
- 首发版本，支持飞书多维表格（Bitable）全功能操作 - 实现 27 种字段类型的表结构管理、查询和批量数据操作 - 提供详细字段格式、数据导入、筛选、并发、批量等最佳实践说明 - 补充常见错误码及排查，详解字段类型、导入格式和极易踩坑点 - 附带完整索引、使用样例和限制说明，便于快速上手
Observed Apr 24, 2026 · source

Install and run

Setup complexity: low.

clawhub skill install s173ar224xha1b0e8jxxvg0r2985aes9:feishu-bitable-suite

Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-a3152557994-ship-it-feishu-bitable-suite/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

46,066 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: feishu-bitable
description: |
  飞书多维表格（Bitable）的创建、查询、编辑和管理工具。包含 27 种字段类型支持、高级筛选、批量操作和视图管理。

  **当以下情况时使用此 Skill**：
  (1) 需要创建或管理飞书多维表格 App
  (2) 需要在多维表格中新增、查询、修改、删除记录（行数据）
  (3) 需要管理字段（列）、视图、数据表
  (4) 用户提到"多维表格"、"bitable"、"数据表"、"记录"、"字段"
  (5) 需要批量导入数据或批量更新多维表格
---

# 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 配置详解](references/field-properties.md)** - 每种字段类型创建/更新时需要的 `property` 参数结构（单选的 options、进度的 min/max、关联的 table_id 等）
- **[记录值数据结构详解](references/record-values.md)** - 每种字段类型在记录中对应的 `fields` 值格式（人员字段只传 id、日期是毫秒时间戳、附件需先上传等）
- **[使用场景完整示例](references/examples.md)** - 8 个完整场景示例（创建表模式对比、批量导入、筛选查询、附件处理、关联字段等）

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

---

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

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

#### 最易错的字段类型（完整列表见 [record-values.md](references/record-values.md)）

| type | ui_type | 字段类型 | 正确格式 | ❌ 常见错误 |
|------|---------|----------|---------|-----------|
| 11 | User | 人员 | `[{id: "ou_xxx"}]` | 传字符串 `"ou_xxx"` 或 `[{name: "张三"}]` |
| 5 | DateTime | 日期 | `1674206443000`（毫秒） | 传秒时间戳或字符串 |
| 3 | SingleSelect | 单选 | `"选项名"` | 传数组 `["选项名"]` |
| 4 | MultiSelect | 多选 | `["选项1", "选项2"]` | 传字符串 `"选项1"` |

_meta.json

{
  "ownerId": "kn785z27bvq547m6kep7brvsc185a3r6",
  "slug": "feishu-bitable-suite",
  "version": "1.0.0",
  "publishedAt": 1777012424892
}

references/examples.md

# 飞书多维表格使用场景完整示例

本文档提供多维表格操作的完整场景示例，包括参数说明和注意事项。

> **基础参考**: 先查阅 [字段 Property 配置详解](field-properties.md) 和 [记录值数据结构详解](record-values.md)

---

## 📋 目录

1. [场景 0: 创建数据表（两种模式对比）](#场景-0-创建数据表两种模式对比)
2. [场景 1: 查字段类型（必做第一步）](#场景-1-查字段类型必做第一步)
3. [场景 2: 批量导入客户数据](#场景-2-批量导入客户数据)
4. [场景 2.5: 创建表并插入数据（含空行处理）](#场景-25-创建表并插入数据含空行处理)
5. [场景 3: 筛选查询（高级筛选）](#场景-3-筛选查询高级筛选)
6. [场景 4: 更新单条记录](#场景-4-更新单条记录)
7. [场景 5: 创建带选项的单选字段](#场景-5-创建带选项的单选字段)
8. [场景 6: 创建复杂字段（进度、货币、评分）](#场景-6-创建复杂字段进度货币评分)
9. [场景 7: 处理附件字段](#场景-7-处理附件字段)
10. [场景 8: 双向关联字段](#场景-8-双向关联字段)

---

## 场景 0: 创建数据表（两种模式对比）

### 模式 A：一次性定义所有字段

**适用场景**：字段类型、配置都已明确，需要快速创建表结构。

**优势**：一次 API 调用，原子性操作。

**工具**: `feishu_bitable_app_table`

```json
{
  "action": "create",
  "app_token": "S404b...",
  "table": {
    "name": "客户管理表",
    "default_view_name": "所有客户",
    "fields": [
      {
        "field_name": "客户名称",
        "type": 1
      },
      {
        "field_name": "负责人",
        "type": 11,
        "property": {
          "multiple": false
        }
      },
      {
        "field_name": "签约日期",
        "type": 5,
        "property": {
          "date_formatter": "yyyy-MM-dd"
        }
      },
      {
        "field_name": "状态",
        "type": 3,
        "property": {
          "options": [
            {"name": "进行中", "color": 0},
            {"name": "已完成", "color": 10}
          ]
        }
      },
      {
        "field_name": "金额",
        "type": 2,
        "ui_type": "Currency",
        "property": {
          "currency_code": "CNY",
          "formatter": "0.00"
        }
      }
    ]
  }
}
```

**返回示例**:
```json
{
  "table_id": "tblXXXXXXXX",
  "name": "客户管理表",
  "default_view_id": "vewXXXXXXXX"
}
```

---

### 模式 B：使用默认表 + 逐步修改字段

**适用场景**：探索式建表，需要边建边调整，或复杂字段配置需要分步确认。

**优势**：
- `app.create` 自带默认表和默认字段，可在此基础上调整
- 复杂字段（单选 options、URL 格式等）分步确认，减少出错
- 踩坑后容易回退（比如 URL 字段改为文本字段）

**完整流程**：

#### 步骤 1: 创建 App（工具: `feishu_bitable_app`）

```json
{
  "action": "create",
  "name": "客户管理系统",
  "folder_token": "fldXXXXXXXX"
}
```

**返回**: 包含 `app_token` 和默认表的 `default_table_id`

---

#### 步骤 2: 查看默认字段（工具: `feishu_bitable_app_table_field`）

```json
{
  "action": "list",
  "app_token": "S404b...",
  "table_id": "tblXXXXXXXX"
}
```

**返回示例**:
```json
{
  "fields": [
    {
      "field_id": "fld001",
      "field_name": "文本",
      "type": 1,
      "ui_type": "Text"
    },
    {
      "field_id": "fld002",
      "field_name": "数字",
      "type": 2,
      "ui_type": "Number"
    }
  ]
}
```

---

#### 步骤 3: 修改默认字段名称（工具: `feishu_bitable_app_table_field`）

```json
{
  "action": "update",
  "app_token": "S404b...",
  "table_id": "tblXXXXXXXX",
  "field_id": "fld001",
  "field_name": "客户名称"
}
```

---

#### 步骤 4: 补充缺失字段（工具: `feishu_bitable_app_table_field`）

```json
{
  "action": "create",
  "app_token": "S404b...",
  "table_id": "tblXXXXXXXX",
  "field_name": "负责人",
  "type": 11,
  "property": {
    "multiple": false
  }
}
```

---

#### 步骤 5: 查看空记录（工具: `feishu_bitable_app_table_record`）

```json
{

references/field-properties.md

# 飞书多维表格字段 Property 配置详解

本文档详细说明每种字段类型创建或更新时需要的 `property` 参数结构。

> **来源**: 基于飞书开放平台文档 [字段编辑指南](https://go.feishu.cn/s/672BSzVyo03)

## 📋 目录

- [基础字段](#基础字段)
  - [1. 文本 (type=1)](#1-文本-type1)
  - [2. 数字 (type=2)](#2-数字-type2)
  - [5. 日期 (type=5)](#5-日期-type5)
  - [7. 复选框 (type=7)](#7-复选框-type7)
  - [13. 电话号码 (type=13)](#13-电话号码-type13)
- [选择字段](#选择字段)
  - [3. 单选 (type=3)](#3-单选-type3)
  - [4. 多选 (type=4)](#4-多选-type4)
- [特殊显示字段](#特殊显示字段)
  - [进度 (type=2, ui_type="Progress")](#进度-type2-ui_typeprogress)
  - [货币 (type=2, ui_type="Currency")](#货币-type2-ui_typecurrency)
  - [评分 (type=2, ui_type="Rating")](#评分-type2-ui_typerating)
  - [条码 (type=1, ui_type="Barcode")](#条码-type1-ui_typebarcode)
  - [邮箱 (type=1, ui_type="Email")](#邮箱-type1-ui_typeemail)
- [关系字段](#关系字段)
  - [11. 人员 (type=11)](#11-人员-type11)
  - [15. 超链接 (type=15)](#15-超链接-type15)
  - [17. 附件 (type=17)](#17-附件-type17)
  - [18. 单向关联 (type=18)](#18-单向关联-type18)
  - [21. 双向关联 (type=21)](#21-双向关联-type21)
  - [22. 地理位置 (type=22)](#22-地理位置-type22)
  - [23. 群组 (type=23)](#23-群组-type23)
- [高级字段](#高级字段)
  - [20. 公式 (type=20)](#20-公式-type20)
  - [1001. 创建时间 (type=1001)](#1001-创建时间-type1001)
  - [1002. 最后更新时间 (type=1002)](#1002-最后更新时间-type1002)
  - [1005. 自动编号 (type=1005)](#1005-自动编号-type1005)

---

## 基础字段

### 1. 文本 (type=1)

**Property 结构**: 空对象或省略

```json
{
  "type": 1,
  "field_name": "任务描述",
  "property": {}
}
```

**注意**:
- 默认 `ui_type` 为 "Text"
- 单个单元格最多 10 万字符
- 支持富文本格式（提及人、超链接等）

---

### 2. 数字 (type=2)

**Property 结构**:

```json
{
  "formatter": "0"  // 可选，数字显示格式
}
```

**formatter 可选值**:
- `"0"`: 整数（默认）
- `"0.0"`: 一位小数
- `"0.00"`: 两位小数
- `"0,000"`: 千分位
- `"0.00%"`: 百分比

**示例**:

```json
{
  "type": 2,
  "field_name": "工时",
  "property": {
    "formatter": "0.00"
  }
}
```

---

### 5. 日期 (type=5)

**Property 结构**:

```json
{
  "date_formatter": "yyyy/MM/dd",  // 可选，默认 "yyyy/MM/dd"
  "auto_fill": false               // 可选，是否自动填充创建时间
}
```

**date_formatter 可选值**:
- `"yyyy/MM/dd"`: 2021/1/30
- `"yyyy-MM-dd HH:mm"`: 2021/1/30 14:00
- `"MM-dd"`: 1月30日
- `"MM/dd/yyyy"`: 01/30/2021
- `"dd/MM/yyyy"`: 30/01/2021

**示例**:

```json
{
  "type": 5,
  "field_name": "截止日期",
  "property": {
    "date_formatter": "yyyy-MM-dd HH:mm",
    "auto_fill": false
  }
}
```

---

### 7. 复选框 (type=7)

**Property 结构**: 空对象或省略

```json
{
  "type": 7,
  "field_name": "是否完成",
  "property": {}
}
```

---

### 13. 电话号码 (type=13)

**Property 结构**: 空对象或省略

```json
{
  "type": 13,
  "field_name": "联系电话",
  "property": {}
}
```

**注意**:
- 电话号码格式：符合正则 `(\+)?\d*`
- 最大长度 64 字符

---

## 选择字段

### 3. 单选 (type=3)

**Property 结构**:

```json
{
  "options": [
    {
      "name": "进行中",   // 必填，选项名称
      "color": 0         // 可选，颜色编号 (0-54)
    },
    {
      "name": "已完成",
      "color": 10
    }
  ]
}
```

**颜色编号 (color)**:
- 范围: 0-54
- 0: 红色
- 10: 绿色
- 20: 蓝色
- ... (详见飞书官方文档)

**示例**:

```json
{
  "type": 3,
  "field_name": "任务状态",
  "property": {
    "options": [
      {"name": "待开始", "color": 0},
      {"name": "进行中", "color"

references/record-values.md

# 飞书多维表格记录值数据结构详解

本文档详细说明每种字段类型在记录中对应的 `fields` 值格式。

> **来源**: 基于飞书开放平台文档 [多维表格记录数据结构](https://go.feishu.cn/s/6lY28723w04)

## 📋 快速索引

| 字段类型 | type | 值类型 | 示例 | 限制 |
|---------|------|--------|------|------|
| [文本](#文本-type1) | 1 | string (写入) / list of object (返回) | `"任务描述"` | 最多 10 万字符 |
| [数字](#数字-type2) | 2 | number | `0.5` | - |
| [单选](#单选-type3) | 3 | string | `"进行中"` | 选项总数≤20,000 |
| [多选](#多选-type4) | 4 | array&lt;string&gt; | `["审批", "办公"]` | 选项总数≤20,000，单元格≤1,000 |
| [日期](#日期-type5) | 5 | number | `1675526400000` | Unix 毫秒时间戳 |
| [复选框](#复选框-type7) | 7 | boolean | `true` | - |
| [人员](#人员-type11) | 11 | list of object | `[{"id": "ou_xxx"}]` | 单元格≤1,000，写入仅支持 `id` |
| [电话](#电话号码-type13) | 13 | string | `"17899870000"` | 最多 64 字符 |
| [超链接](#超链接-type15) | 15 | object | `{"text": "飞书", "link": "..."}` | - |
| [附件](#附件-type17) | 17 | list of object | `[{"file_token": "xxx"}]` | 单元格≤100 |
| [单向关联](#单向关联-type18) | 18 | object | `{"link_record_ids": [...]}` | 单元格≤500 |
| [双向关联](#双向关联-type21) | 21 | object | `{"link_record_ids": [...]}` | 单元格≤500 |
| [地理位置](#地理位置-type22) | 22 | object | `{"location": "116.3,40.0", ...}` | - |
| [群组](#群组-type23) | 23 | list of object | `[{"id": "oc_xxx"}]` | 单元格≤10 |
| [公式/查找引用](#公式查找引用-type20-type19) | 20/19 | object | `{"type": 1, "value": [...]}` | 只读 |

---

## 文本 (type=1)

### 基础文本 (ui_type="Text")

**写入格式**: 字符串

```json
{
  "fields": {
    "任务描述": "维护客户关系"
  }
}
```

**返回格式**: 对象数组

```json
{
  "任务描述": [
    {
      "text": "维护客户关系",
      "type": "text"
    }
  ]
}
```

**富文本格式** (提及人、超链接):

```json
{
  "任务描述": [
    {
      "text": "请 ",
      "type": "text"
    },
    {
      "text": "@张三",
      "type": "mention",
      "token": "ou_user123",
      "mentionType": "User",
      "mentionNotify": true,
      "name": "张三"
    },
    {
      "text": " 查看 ",
      "type": "text"
    },
    {
      "text": "飞书官网",
      "type": "url",
      "link": "https://www.feishu.cn"
    }
  ]
}
```

**富文本元素类型**:

| type | 说明 | 额外字段 |
|------|------|---------|
| `"text"` | 纯文本 | `text` |
| `"mention"` | 提及（人/文档） | `token`, `mentionType`, `mentionNotify`, `name` |
| `"url"` | 超链接 | `text`, `link` |

**mentionType 可选值**:
- `"User"`: 提及用户
- `"Docx"`: 提及文档
- `"Sheet"`: 提及电子表格
- `"Bitable"`: 提及多维表格

---

### 条码 (ui_type="Barcode")

**写入格式**: 字符串

```json
{
  "fields": {
    "商品条码": "FS0001"
  }
}
```

**返回格式**:

```json
{
  "商品条码": [
    {
      "text": "FS0001",
      "type": "text"
    }
  ]
}
```

---

### 邮箱 (ui_type="Email")

**写入格式**: 字符串

```json
{
  "fields": {
    "联系邮箱": "[email protected]"
  }
}
```

**返回格式**:

```json
{
  "联系邮箱": [
    {
      "text": "[email protected]",
      "type": "url",
      "link": "mailto:[email protected]"
    }
  ]
}
```

---

## 数字 (type=2)

**写入/返回格式**: 数字

```json
{
  "fields": {
    "工时": 10,
    "完成率": 0.75,
    "预算": 5000.50
  }
}
```

**注意**:
- 进度 (ui_type="Progress"): 0-1 范围的小数
- 货币 (ui_type="Currency"): 普通数字
- 评分 (ui_type="Rating"): 整数

---

## 单选 (type=3)

**写入格式

Github ReposUpdated 3d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW

Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular