feishu-bitable-upload
Upload files (images, videos, attachments) to Feishu (Lark) Bitable (multi-dimensional table) and return the file_token. Auto-selects direct upload for files up to 20MB or chunked upload (prepare, part, finish) for larger files. Requires App ID and Secret (lark-cli does NOT cover the /drive/v1/medias/ API). Use when the user wants to: upload a file/image/video to Feishu Bitable, get a file_token from Feishu Drive API, upload attachments to 多维表格 (bitable), 上传文件到飞书多维表格, 获取 file_token.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/billzhuang6569/feishu-bitable-upload上传素材到飞书多维表格(获取 file_token)
与官方 lark-* Skill 的定位
| 场景 | 工具 |
|---|---|
| 上传附件直接写入记录 | lark-cli base +record-upload-attachment |
| 上传文件到云空间 | lark-cli drive +upload |
| 上传素材获取独立 file_token | 本 Skill |
lark-cli 不覆盖 /drive/v1/medias/ 素材接口,本 Skill 填补该空白。
获取到的 file_token 可用于后续写入多维表格附件字段。
依赖
bash,curl,python3,dd— macOS/Linux 均内置- 飞书 App 凭证(App ID + App Secret)
脚本
scripts/feishu_upload.sh
用法
# 参数模式
bash scripts/feishu_upload.sh <文件> --parent-node <APP_TOKEN> \
--app-id <APP_ID> --app-secret <APP_SECRET>
# 环境变量模式
export FEISHU_PARENT_NODE=<APP_TOKEN>
export FEISHU_APP_ID=<APP_ID>
export FEISHU_APP_SECRET=<APP_SECRET>
bash scripts/feishu_upload.sh <文件>
--parent-type 可选(默认 bitable_file):图片附件用 bitable_image。
成功后输出 file_token: boxcnrHpsg1QDqXAAAyachabcef
自动选择上传方式
| 文件大小 | 上传方式 | API |
|---|---|---|
| ≤ 20MB | 直接上传 | POST /drive/v1/medias/upload_all |
| > 20MB | 分片上传 | upload_prepare → upload_part × N → upload_finish |
upload_allAPI 硬限制 20MB,超过必须分片(分片大小 4MB,由服务端返回)。
常见错误
| 错误码 | 原因 | 解决 |
|---|---|---|
| 1061004 | 无权限 | 确认应用有 bitable:app 权限且对目标表有编辑权限 |
| 1061044 | parent_node 不存在 | 检查多维表格 App Token 是否正确 |
| 1061043 | 文件超限 | 检查文件大小是否符合飞书限制 |
| 1061005 | Token 无效 | 检查 App ID / Secret 是否正确 |
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-billzhuang6569-feishu-bitable-upload": {
"enabled": true,
"auto_update": true
}
}
}Related Skills
lark-doc-reviser
Read unresolved comments in a Feishu (Lark) document and apply targeted edits block-by-block based on those comments. Use when the user shares a Feishu doc URL and asks to: (1) fetch/show document comments, (2) revise or edit the doc based on comments, (3) process feedback left in a Feishu doc. Requires lark-cli installed and authenticated.
recruitment-agent
招聘Agent:通过 opencli(Boss直聘) + lark-cli(飞书多维表格) 管理招聘流程。支持:(1) 查看Boss直聘最近/未读消息; (2) 将候选人存入人才库(先搜索比对,再新建/更新); (3) 添加人才决策记录(加入库/约面试/跟进/发Offer/归档); (4) 更新人才库中某候选人的指定信息; (5) 约面试(发邀约消息、心跳检测、确认时间、创建飞书日程)。当用户说「查boss消息」「把XXX存入人才库」「我对XXX感兴趣」「对XXX做个决策记录」「更新XXX的信息/字段」「帮我给XXX约个面试」「约一下XXX」时触发。