什么是 飞书电子表格？

飞书电子表格（Feishu Sheets）技能是专为 AI 智能体设计的强大集成工具，用于与飞书在线电子表格进行无缝交互。它支持广泛的电子表格操作（区别于多维表格 Bitable），允许进行高精度的数据处理。通过在 Openclaw Skills 生态中使用此技能，开发人员可以授权其智能体以编程方式执行复杂任务，如写入单元格数值、追加数据行以及管理工作表结构。

该工具对于依赖飞书进行协作的团队特别有价值，因为它弥补了 AI 推理与结构化数据存储之间的鸿沟。无论您需要生成自动化报告还是维护动态日志，飞书电子表格集成都提供了通过统一的基于动作的接口处理表格逻辑所需的基础设施。它简化了与飞书开放平台 API 交互的过程，使其成为构建高级 Openclaw Skills 工作流的基石。

下载入口:https://github.com/openclaw/skills/tree/main/skills/wesley138cn/feishu-sheets

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

飞书电子表格 应用场景

• 在特定的飞书文件夹中自动创建新的项目跟踪表格。
• 将实时数据日志或会议摘要直接追加到现有的飞书表格中。
• 读取特定的单元格范围以提取数据供 AI 分析或外部报告使用。
• 根据变量数据输入动态插入或删除行和列，以格式化表格。
• 在单个表格文件中管理多个工作表，以实现复杂的数据组织。

1. AI 智能体通过从提供的飞书 URL 中提取 spreadsheet_token 和 sheet_id 来识别目标表格。
2. 用户或智能体通过飞书电子表格工具接口指定动作，如创建、读取、写入或追加。
3. 该技能将请求转换为对飞书开放 API 的精确调用，处理身份验证和数据格式化。
4. 对于数据录入，工具将提供的值映射到工作表内特定的 A1 或 R1C1 范围。
5. 工具返回结构化的 JSON 响应，包括更新的元数据或单元格内容，以在 Openclaw Skills 框架内确认操作。

飞书电子表格 配置指南

要启用此技能，请确保您的飞书应用具有所需的权限：sheets:spreadsheet、sheets:spreadsheet:readonly 和 drive:drive。然后，按如下方式配置您的环境：

channels:
  feishu:
    tools:
      sheets: true

请确保在 Openclaw Skills 环境变量中正确设置了应用程序凭据，以允许安全的 API 通信。

飞书电子表格 数据架构与分类体系

该技能使用标准的电子表格标识符和灵活的值类型组织数据：

支持的复杂数据对象包括公式（例如 =SUM(A1:A10)）和带有显示文本的 URL 链接。

name: feishu-sheets
description: |
  Feishu online spreadsheet (Sheets) operations including create, read, write, append data, manage worksheets.
  Use when user mentions Feishu Sheets, online spreadsheet, electronic spreadsheet (not Bitable/multi-dimensional table).
  Supports: create spreadsheet, write/read cell values, append rows, insert/delete rows/columns, manage worksheets.

Feishu Sheets Tool

Single tool feishu_sheets with action parameter for all spreadsheet operations.

Token Extraction

From URL https://xxx.feishu.cn/sheets/shtABC123 → spreadsheet_token = shtABC123

Actions

Create Spreadsheet

{ "action": "create", "title": "New Spreadsheet" }

Optional folder:

{ "action": "create", "title": "New Spreadsheet", "folder_token": "fldcnXXX" }

Returns: spreadsheet_token, url, title

Write Values

{
  "action": "write",
  "spreadsheet_token": "shtABC123",
  "sheet_id": "0bxxxx",
  "range": "A1:C3",
  "values": [["Name", "Age", "City"], ["Alice", 25, "Beijing"], ["Bob", 30, "Shanghai"]]
}

Read Values

{
  "action": "read",
  "spreadsheet_token": "shtABC123",
  "sheet_id": "0bxxxx",
  "range": "A1:C10"
}

Append Values

{
  "action": "append",
  "spreadsheet_token": "shtABC123",
  "sheet_id": "0bxxxx",
  "values": [["Charlie", 28, "Shenzhen"]]
}

Insert Rows/Columns

{
  "action": "insert_dimension",
  "spreadsheet_token": "shtABC123",
  "sheet_id": "0bxxxx",
  "dimension": "ROWS",
  "start_index": 5,
  "end_index": 7
}

Delete Rows/Columns

{
  "action": "delete_dimension",
  "spreadsheet_token": "shtABC123",
  "sheet_id": "0bxxxx",
  "dimension": "ROWS",
  "start_index": 5,
  "end_index": 7
}

Get Spreadsheet Info

{ "action": "get_info", "spreadsheet_token": "shtABC123" }

Returns: metadata including all sheet_ids and titles

Add Worksheet

{
  "action": "add_sheet",
  "spreadsheet_token": "shtABC123",
  "title": "Sheet2"
}

Delete Worksheet

{
  "action": "delete_sheet",
  "spreadsheet_token": "shtABC123",
  "sheet_id": "0bxxxx"
}

Range Format

• Cell: A1, B5
• Range: A1:C10, B2:D5
• Entire column: A:A, B:D
• Entire row: 1:1, 3:5
• With sheet_id: 0bxxxx!A1:C10

Sheet ID

• From URL: https://xxx.feishu.cn/sheets/shtABC123?sheet=0bxxxx
• From get_info action
• Default first sheet often has simple id like 0bxxxx

Data Types

Values can be:

• String: "Hello"
• Number: 123, 45.67
• Formula: {"type": "formula", "text": "=SUM(A1:A10)"}
• Link: {"type": "url", "text": "Click here", "link": "https://..."}

Configuration

channels:
  feishu:
    tools:
      sheets: true  # default: true

Permissions Required

• sheets:spreadsheet - Create and manage spreadsheets
• sheets:spreadsheet:readonly - Read spreadsheet data
• drive:drive - Access cloud storage

API Reference

Base URL: https://open.feishu.cn/open-apis/sheets/v2/spreadsheets/

See references/api-reference.md for detailed API documentation.