feishu-bitable - SKILL.md Agent Skill

name: feishu-bitable description: | Feishu multi-dimensional table (Bitable) operations. Activate when user mentions tables, databases, or bitable links.

Feishu Bitable Tool

Tool feishu_bitable for multi-dimensional table operations.

Token Extraction

From URL https://xxx.feishu.cn/base/ABC123def → app_token = ABC123def

Actions

List Tables

{ "action": "list_tables", "app_token": "ABC123def" }

Returns: all tables in the bitable app.

Get Table Info

{ "action": "get_table", "app_token": "ABC123def", "table_id": "tblXXX" }

Returns: table name, fields, record count.

Query Records

{
  "action": "query_records",
  "app_token": "ABC123def",
  "table_id": "tblXXX",
  "filter": "field_name=\"value\"",
  "page_size": 20
}

Returns: records matching filter criteria.

Create Record

{
  "action": "create_record",
  "app_token": "ABC123def",
  "table_id": "tblXXX",
  "fields": {
    "field1": "value1",
    "field2": "value2"
  }
}

Creates a new record in the table.

Update Record

{
  "action": "update_record",
  "app_token": "ABC123def",
  "table_id": "tblXXX",
  "record_id": "recXXX",
  "fields": {
    "field1": "new_value"
  }
}

Updates an existing record.

Delete Record

{
  "action": "delete_record",
  "app_token": "ABC123def",
  "table_id": "tblXXX",
  "record_id": "recXXX"
}

Deletes a record from the table.

X-OmniClaw Implementation

Tool Class: FeishuBitableTools.kt

Available Tools:

feishu_bitable_list_tables - List all tables
feishu_bitable_query - Query records
feishu_bitable_create - Create record
feishu_bitable_update - Update record
feishu_bitable_delete - Delete record

Example Usage:

// Query records
val result = feishuBitableTools.queryRecords(
    appToken = "ABC123def",
    tableId = "tblXXX",
    filter = "Status=\"Active\""
)

// Create record
val result = feishuBitableTools.createRecord(
    appToken = "ABC123def",
    tableId = "tblXXX",
    fields = mapOf(
        "Name" to "Task 1",
        "Status" to "Active"
    )
)

Field Types

Bitable supports various field types:

Text: Single line text, multi-line text
Number: Integer, decimal
Select: Single select, multi-select
Date: Date, datetime
Checkbox: Boolean
Attachment: Files
User: User picker
Formula: Calculated fields

Permissions

Required: bitable:app, bitable:app:readonly