{
  "schemaVersion": "1.0",
  "item": {
    "slug": "feishu-api-bitable",
    "name": "Feishu Bitable API",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/StevenLikeWatermelon/feishu-api-bitable",
    "canonicalUrl": "https://clawhub.ai/StevenLikeWatermelon/feishu-api-bitable",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/feishu-api-bitable",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=feishu-api-bitable",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "CHECKLIST.md",
      "README.md",
      "SKILL.md",
      "bin/cli.js",
      "description.md",
      "examples/create-records.json"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/feishu-api-bitable"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/feishu-api-bitable",
    "agentPageUrl": "https://openagent3.xyz/skills/feishu-api-bitable/agent",
    "manifestUrl": "https://openagent3.xyz/skills/feishu-api-bitable/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/feishu-api-bitable/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "飞书多维表格(Bitable)技能",
        "body": "用于操作飞书多维表格的完整技能，支持数据表、记录和字段的CRUD操作。"
      },
      {
        "title": "功能特性",
        "body": "✅ 数据表管理（创建、列表、获取、删除）\n✅ 记录管理（创建、读取、更新、删除、批量操作）\n✅ 字段管理（创建、列表、更新）\n✅ 视图管理（列表、获取）\n✅ 应用管理（获取应用信息）"
      },
      {
        "title": "环境变量配置",
        "body": "# 飞书应用ID\nexport FEISHU_APP_ID=cli_xxxxxx\n\n# 飞书应用密钥（或密钥文件路径）\nexport FEISHU_APP_SECRET=your_app_secret\n# 或\nexport FEISHU_APP_SECRET_PATH=~/.clawdbot/secrets/feishu_app_secret"
      },
      {
        "title": "1. 安装依赖",
        "body": "cd skills/feishu-bitable\nnpm install"
      },
      {
        "title": "2. 设置环境变量",
        "body": "export FEISHU_APP_ID=cli_xxxxxx\nexport FEISHU_APP_SECRET=your_app_secret"
      },
      {
        "title": "3. 使用CLI工具",
        "body": "# 获取帮助\nnode bitable-cli.js --help\n\n# 列出所有数据表\nnode bitable-cli.js list-tables --app-token basxxxxxx\n\n# 创建新记录\nnode bitable-cli.js create-record --app-token basxxxxxx --table-id tblxxxxxx --data '{\"字段1\": \"值1\", \"字段2\": \"值2\"}'\n\n# 查询记录\nnode bitable-cli.js list-records --app-token basxxxxxx --table-id tblxxxxxx"
      },
      {
        "title": "数据表相关",
        "body": "GET /bitable/v1/apps/{app_token}/tables - 获取数据表列表\nPOST /bitable/v1/apps/{app_token}/tables - 创建数据表\nGET /bitable/v1/apps/{app_token}/tables/{table_id} - 获取数据表详情\nDELETE /bitable/v1/apps/{app_token}/tables/{table_id} - 删除数据表"
      },
      {
        "title": "记录相关",
        "body": "POST /bitable/v1/apps/{app_token}/tables/{table_id}/records - 新增记录\nGET /bitable/v1/apps/{app_token}/tables/{table_id}/records - 获取记录列表\nPUT /bitable/v1/apps/{app_token}/tables/{table_id}/records/{record_id} - 更新记录\nDELETE /bitable/v1/apps/{app_token}/tables/{table_id}/records/{record_id} - 删除记录\nPOST /bitable/v1/apps/{app_token}/tables/{table_id}/records/batch_create - 批量新增记录\nPOST /bitable/v1/apps/{app_token}/tables/{table_id}/records/batch_update - 批量更新记录\nPOST /bitable/v1/apps/{app_token}/tables/{table_id}/records/batch_delete - 批量删除记录"
      },
      {
        "title": "字段相关",
        "body": "GET /bitable/v1/apps/{app_token}/tables/{table_id}/fields - 获取字段列表\nPOST /bitable/v1/apps/{app_token}/tables/{table_id}/fields - 创建字段\nPUT /bitable/v1/apps/{app_token}/tables/{table_id}/fields/{field_id} - 更新字段"
      },
      {
        "title": "视图相关",
        "body": "GET /bitable/v1/apps/{app_token}/tables/{table_id}/views - 获取视图列表\nGET /bitable/v1/apps/{app_token}/tables/{table_id}/views/{view_id} - 获取视图详情"
      },
      {
        "title": "1. 创建数据表",
        "body": "node bitable-cli.js create-table \\\n  --app-token basxxxxxx \\\n  --name \"任务管理\" \\\n  --fields '[{\"field_name\": \"任务名称\", \"type\": \"text\"}, {\"field_name\": \"状态\", \"type\": \"select\", \"property\": {\"options\": [{\"name\": \"待办\"}, {\"name\": \"进行中\"}, {\"name\": \"已完成\"}]}}]'"
      },
      {
        "title": "2. 添加记录",
        "body": "node bitable-cli.js create-record \\\n  --app-token basxxxxxx \\\n  --table-id tblxxxxxx \\\n  --data '{\"任务名称\": \"完成API开发\", \"状态\": \"进行中\", \"优先级\": \"高\", \"截止日期\": \"2024-12-31\"}'"
      },
      {
        "title": "3. 查询记录",
        "body": "node bitable-cli.js list-records \\\n  --app-token basxxxxxx \\\n  --table-id tblxxxxxx \\\n  --filter '{\"conjunction\": \"and\", \"conditions\": [{\"field_name\": \"状态\", \"operator\": \"is\", \"value\": [\"进行中\"]}]}' \\\n  --sort '[\"-创建时间\"]' \\\n  --page-size 50"
      },
      {
        "title": "4. 批量操作",
        "body": "node bitable-cli.js batch-create \\\n  --app-token basxxxxxx \\\n  --table-id tblxxxxxx \\\n  --data-file records.json"
      },
      {
        "title": "字段类型支持",
        "body": "飞书多维表格支持以下字段类型：\n\ntext - 文本\nnumber - 数字\nsingle_select - 单选\nmulti_select - 多选\ndate - 日期\nperson - 人员\ncheckbox - 复选框\nurl - 链接\nphone - 电话\nemail - 邮箱\nattachment - 附件\nformula - 公式\ncreated_time - 创建时间\nmodified_time - 修改时间\ncreated_by - 创建人\nmodified_by - 修改人"
      },
      {
        "title": "错误处理",
        "body": "技能包含完整的错误处理机制：\n\n网络错误重试\n权限验证\n参数验证\n速率限制处理"
      },
      {
        "title": "注意事项",
        "body": "权限要求：应用需要具备bitable:record:readonly和bitable:record:write权限\n速率限制：飞书API有速率限制，建议添加适当的延迟\n数据大小：单次请求记录数量建议不超过100条\n字段名称：字段名称在表中必须唯一"
      },
      {
        "title": "在Clawdbot中使用此技能",
        "body": "确保技能已安装：技能应该位于 skills/feishu-bitable 目录\n设置环境变量：在Clawdbot配置中设置飞书应用凭证\n在对话中调用：Clawdbot可以调用此技能来操作飞书多维表格"
      },
      {
        "title": "示例对话",
        "body": "用户: \"帮我在飞书多维表格中添加一个任务\"\nClawdbot:\n\n# 使用技能添加任务\nnode skills/feishu-bitable/bin/cli.js create-record \\\n  --app-token basxxxxxx \\\n  --table-id tblxxxxxx \\\n  --data '{\"任务名称\": \"新任务\", \"状态\": \"待办\", \"优先级\": \"中\"}'"
      },
      {
        "title": "自动化工作流",
        "body": "你可以创建自动化工作流，例如：\n\n每天同步任务状态\n从其他系统导入数据到飞书多维表格\n根据条件自动更新记录\n生成报表并发送到飞书群聊"
      },
      {
        "title": "开发指南",
        "body": "如需扩展功能，请参考：\n\nsrc/api.js - API客户端\nsrc/cli.js - 命令行接口\nsrc/utils.js - 工具函数"
      },
      {
        "title": "添加新的API端点",
        "body": "在 src/api.js 的 FeishuBitableAPI 类中添加新方法\n在 bin/cli.js 中添加对应的命令\n更新文档"
      },
      {
        "title": "错误处理最佳实践",
        "body": "使用 try-catch 包装所有API调用\n提供有意义的错误消息\n实现重试逻辑处理网络错误\n验证输入参数"
      }
    ],
    "body": "飞书多维表格(Bitable)技能\n\n用于操作飞书多维表格的完整技能，支持数据表、记录和字段的CRUD操作。\n\n功能特性\n✅ 数据表管理（创建、列表、获取、删除）\n✅ 记录管理（创建、读取、更新、删除、批量操作）\n✅ 字段管理（创建、列表、更新）\n✅ 视图管理（列表、获取）\n✅ 应用管理（获取应用信息）\n环境变量配置\n# 飞书应用ID\nexport FEISHU_APP_ID=cli_xxxxxx\n\n# 飞书应用密钥（或密钥文件路径）\nexport FEISHU_APP_SECRET=your_app_secret\n# 或\nexport FEISHU_APP_SECRET_PATH=~/.clawdbot/secrets/feishu_app_secret\n\n快速开始\n1. 安装依赖\ncd skills/feishu-bitable\nnpm install\n\n2. 设置环境变量\nexport FEISHU_APP_ID=cli_xxxxxx\nexport FEISHU_APP_SECRET=your_app_secret\n\n3. 使用CLI工具\n# 获取帮助\nnode bitable-cli.js --help\n\n# 列出所有数据表\nnode bitable-cli.js list-tables --app-token basxxxxxx\n\n# 创建新记录\nnode bitable-cli.js create-record --app-token basxxxxxx --table-id tblxxxxxx --data '{\"字段1\": \"值1\", \"字段2\": \"值2\"}'\n\n# 查询记录\nnode bitable-cli.js list-records --app-token basxxxxxx --table-id tblxxxxxx\n\nAPI端点\n数据表相关\nGET /bitable/v1/apps/{app_token}/tables - 获取数据表列表\nPOST /bitable/v1/apps/{app_token}/tables - 创建数据表\nGET /bitable/v1/apps/{app_token}/tables/{table_id} - 获取数据表详情\nDELETE /bitable/v1/apps/{app_token}/tables/{table_id} - 删除数据表\n记录相关\nPOST /bitable/v1/apps/{app_token}/tables/{table_id}/records - 新增记录\nGET /bitable/v1/apps/{app_token}/tables/{table_id}/records - 获取记录列表\nPUT /bitable/v1/apps/{app_token}/tables/{table_id}/records/{record_id} - 更新记录\nDELETE /bitable/v1/apps/{app_token}/tables/{table_id}/records/{record_id} - 删除记录\nPOST /bitable/v1/apps/{app_token}/tables/{table_id}/records/batch_create - 批量新增记录\nPOST /bitable/v1/apps/{app_token}/tables/{table_id}/records/batch_update - 批量更新记录\nPOST /bitable/v1/apps/{app_token}/tables/{table_id}/records/batch_delete - 批量删除记录\n字段相关\nGET /bitable/v1/apps/{app_token}/tables/{table_id}/fields - 获取字段列表\nPOST /bitable/v1/apps/{app_token}/tables/{table_id}/fields - 创建字段\nPUT /bitable/v1/apps/{app_token}/tables/{table_id}/fields/{field_id} - 更新字段\n视图相关\nGET /bitable/v1/apps/{app_token}/tables/{table_id}/views - 获取视图列表\nGET /bitable/v1/apps/{app_token}/tables/{table_id}/views/{view_id} - 获取视图详情\n使用示例\n1. 创建数据表\nnode bitable-cli.js create-table \\\n  --app-token basxxxxxx \\\n  --name \"任务管理\" \\\n  --fields '[{\"field_name\": \"任务名称\", \"type\": \"text\"}, {\"field_name\": \"状态\", \"type\": \"select\", \"property\": {\"options\": [{\"name\": \"待办\"}, {\"name\": \"进行中\"}, {\"name\": \"已完成\"}]}}]'\n\n2. 添加记录\nnode bitable-cli.js create-record \\\n  --app-token basxxxxxx \\\n  --table-id tblxxxxxx \\\n  --data '{\"任务名称\": \"完成API开发\", \"状态\": \"进行中\", \"优先级\": \"高\", \"截止日期\": \"2024-12-31\"}'\n\n3. 查询记录\nnode bitable-cli.js list-records \\\n  --app-token basxxxxxx \\\n  --table-id tblxxxxxx \\\n  --filter '{\"conjunction\": \"and\", \"conditions\": [{\"field_name\": \"状态\", \"operator\": \"is\", \"value\": [\"进行中\"]}]}' \\\n  --sort '[\"-创建时间\"]' \\\n  --page-size 50\n\n4. 批量操作\nnode bitable-cli.js batch-create \\\n  --app-token basxxxxxx \\\n  --table-id tblxxxxxx \\\n  --data-file records.json\n\n字段类型支持\n\n飞书多维表格支持以下字段类型：\n\ntext - 文本\nnumber - 数字\nsingle_select - 单选\nmulti_select - 多选\ndate - 日期\nperson - 人员\ncheckbox - 复选框\nurl - 链接\nphone - 电话\nemail - 邮箱\nattachment - 附件\nformula - 公式\ncreated_time - 创建时间\nmodified_time - 修改时间\ncreated_by - 创建人\nmodified_by - 修改人\n错误处理\n\n技能包含完整的错误处理机制：\n\n网络错误重试\n权限验证\n参数验证\n速率限制处理\n注意事项\n权限要求：应用需要具备bitable:record:readonly和bitable:record:write权限\n速率限制：飞书API有速率限制，建议添加适当的延迟\n数据大小：单次请求记录数量建议不超过100条\n字段名称：字段名称在表中必须唯一\nClawdbot集成\n在Clawdbot中使用此技能\n确保技能已安装：技能应该位于 skills/feishu-bitable 目录\n设置环境变量：在Clawdbot配置中设置飞书应用凭证\n在对话中调用：Clawdbot可以调用此技能来操作飞书多维表格\n示例对话\n\n用户: \"帮我在飞书多维表格中添加一个任务\" Clawdbot:\n\n# 使用技能添加任务\nnode skills/feishu-bitable/bin/cli.js create-record \\\n  --app-token basxxxxxx \\\n  --table-id tblxxxxxx \\\n  --data '{\"任务名称\": \"新任务\", \"状态\": \"待办\", \"优先级\": \"中\"}'\n\n自动化工作流\n\n你可以创建自动化工作流，例如：\n\n每天同步任务状态\n从其他系统导入数据到飞书多维表格\n根据条件自动更新记录\n生成报表并发送到飞书群聊\n开发指南\n\n如需扩展功能，请参考：\n\nsrc/api.js - API客户端\nsrc/cli.js - 命令行接口\nsrc/utils.js - 工具函数\n添加新的API端点\n在 src/api.js 的 FeishuBitableAPI 类中添加新方法\n在 bin/cli.js 中添加对应的命令\n更新文档\n错误处理最佳实践\n使用 try-catch 包装所有API调用\n提供有意义的错误消息\n实现重试逻辑处理网络错误\n验证输入参数"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/StevenLikeWatermelon/feishu-api-bitable",
    "publisherUrl": "https://clawhub.ai/StevenLikeWatermelon/feishu-api-bitable",
    "owner": "StevenLikeWatermelon",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/feishu-api-bitable",
    "downloadUrl": "https://openagent3.xyz/downloads/feishu-api-bitable",
    "agentUrl": "https://openagent3.xyz/skills/feishu-api-bitable/agent",
    "manifestUrl": "https://openagent3.xyz/skills/feishu-api-bitable/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/feishu-api-bitable/agent.md"
  }
}