什么是 Airtable？

Airtable 技能使 AI 智能体能够直接与 Airtable 平台交互，以获取电子表格和数据库数据。它通过个人访问令牌 (PAT) 实现与 api.airtable.com 的安全直接通信，无需第三方代理。该技能是使用 Openclaw Skills 的开发人员的核心组件，适用于需要将云端托管的关系数据集成到自动化工作流中，允许智能体动态浏览架构和内容。

下载入口:https://github.com/openclaw/skills/tree/main/skills/codeninja23/native-airtable

安装与下载

1. ClawHub CLI

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

2. 手动安装

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

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

3. 提示词安装

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

Airtable 应用场景

• 检索项目管理数据以跟踪任务进度和截止日期。
• 查询 CRM 库以获取客户联系信息或线索历史。
• 访问产品目录和库存水平以执行自动化逻辑。
• 从编辑日历中提取内容，以辅助内容生成任务。

1. AI 智能体调用位于技能目录中的 Python 脚本来执行命令。
2. 脚本使用 AIRTABLE_PAT 环境变量通过 Airtable 进行身份验证。
3. 根据命令（例如 list-records），脚本向官方 Airtable REST API 发送请求。
4. API 返回结构化数据，技能对其进行解析并呈现给智能体进行处理或分析。

Airtable 配置指南

1. 在 https://airtable.com/create/tokens 生成个人访问令牌。
2. 为该令牌分配 data.records:read 和 schema.bases:read 权限范围。
3. 定义令牌可以访问的 Base（特定 Base 或全部）。
4. 在终端或配置中设置环境变量：

export AIRTABLE_PAT=pat_your_token_here

5. 确保环境中可以使用 python3 来执行脚本。

Airtable 数据架构与分类体系

name: airtable
description: "Read Airtable bases, tables, and records directly via the Airtable API. Use when you need spreadsheet/database data from Airtable. Calls api.airtable.com directly with no third-party proxy."
metadata:
  openclaw:
    requires:
      env:
        - AIRTABLE_PAT
      bins:
        - python3
    primaryEnv: AIRTABLE_PAT
    files:
      - "scripts/*"

Airtable

Read bases, tables, and records directly via api.airtable.com.

Setup (one-time)

1. Go to https://airtable.com/create/tokens
2. Click + Create new token, give it a name
3. Add scopes:
   • data.records:read
   • schema.bases:read
4. Under Access, select which bases to grant access to (or all)
5. Copy the token — it starts with pat
6. Set the environment variable:

   AIRTABLE_PAT=pat_your_token_here
   

Commands

List all accessible bases

python3 /mnt/skills/user/airtable/scripts/airtable.py list-bases

List tables in a base

python3 /mnt/skills/user/airtable/scripts/airtable.py list-tables 

List records in a table

python3 /mnt/skills/user/airtable/scripts/airtable.py list-records  "Table Name"
python3 /mnt/skills/user/airtable/scripts/airtable.py list-records  "Table Name" --limit 50

Filter records with a formula

python3 /mnt/skills/user/airtable/scripts/airtable.py list-records  "Tasks" --filter "{Status}='Done'"
python3 /mnt/skills/user/airtable/scripts/airtable.py list-records  "Contacts" --filter "NOT({Email}='')"

Filter to specific fields only

python3 /mnt/skills/user/airtable/scripts/airtable.py list-records  "People" --fields "Name,Email,Company"

Use a specific view

python3 /mnt/skills/user/airtable/scripts/airtable.py list-records  "Tasks" --view "Active Tasks"

Get a specific record

python3 /mnt/skills/user/airtable/scripts/airtable.py get-record  "Table Name" 

Search records

python3 /mnt/skills/user/airtable/scripts/airtable.py search-records  "Contacts" "Smith"
python3 /mnt/skills/user/airtable/scripts/airtable.py search-records  "Contacts" "smith@acme.com" --field "Email"

Notes

• Free plan: unlimited bases, 1,000 records per base. API reads work on free.
• Base IDs start with app, record IDs start with rec.
• Table names are case-sensitive and must match exactly. Use quotes if the name has spaces.
• Airtable deprecated old API keys in Feb 2024. Only Personal Access Tokens (PAT) work now.