Feishu Upload Skill_知识管理 skill-PHP中文网

Feishu Upload Skill

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

上传文件至飞书云盘并发送至指定聊天，支持自动令牌管理、30MB大小限制和多种文件格式，需 Node.js 18+ 环境。

Feishu Upload Skill

功能概述

Feishu Upload Skill是一项面向实际任务的技能，主要用于飞书文件上传技能 - 直接上传文件到飞书并发送到聊天；✅ 文件上传：上传本地文件到飞书云盘；

核心要点

✅ 消息发送：发送文件消息到指定聊天；
✅ 自动令牌管理：自动获取和刷新访问令牌；
✅ 大小限制检查：自动检查30MB文件大小限制；

使用与执行

✅ 多格式支持：支持各种文件类型（文本、图片、压缩包等）；✅ 纯Node.js实现：无需额外依赖，使用Node.j。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

结果检查与注意事项

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

Feishu Upload Skill

飞书文件上传技能 - 直接上传文件到飞书并发送到聊天

功能特性

✅ 文件上传：上传本地文件到飞书云盘 ✅ 消息发送：发送文件消息到指定聊天 ✅ 自动令牌管理：自动获取和刷新访问令牌 ✅ 大小限制检查：自动检查30MB文件大小限制 ✅ 多格式支持：支持各种文件类型（文本、图片、压缩包等） ✅ 纯Node.js实现：无需额外依赖，使用Node.js 18+原生功能

快速开始

1. 上传文件并发送到聊天

node feishu_complete_upload.js <文件路径> <聊天ID>

示例：

node feishu_complete_upload.js document.txt oc_dd899cb1a7846915cdd2d6850bd1dafa

2. 仅上传文件（获取文件Key）

node feishu_complete_upload.js <文件路径>

3. 使用简化脚本

# 简单上传
node native_feishu_upload.js <文件路径>

# 获取访问令牌
./get_feishu_token.sh

文件说明

核心文件

feishu_complete_upload.js - 完整的上传和发送工具（推荐）
native_feishu_upload.js - 使用原生FormData的简单上传工具
get_feishu_token.sh - 获取和刷新访问令牌的脚本

辅助文件

feishu_upload_simple.sh - Bash实现的简单上传脚本
feishu_upload_fixed.sh - 修复版Bash上传脚本
simple_feishu_upload.js - 简化版Node.js上传工具

配置文件

feishu_token.txt - 访问令牌缓存文件（自动生成）
upload_result.json - 上次上传的结果文件

技术原理

三步上传流程

获取访问令牌：使用App ID和Secret获取tenant_access_token
上传文件：使用飞书/im/v1/files API上传文件，获取file_key
发送消息：使用file_key发送文件消息到指定聊天

API端点

获取令牌：POST /open-apis/auth/v3/tenant_access_token/internal
上传文件：POST /open-apis/im/v1/files
发送消息：POST /open-apis/im/v1/messages

权限要求

im:message:send_as_bot - 发送消息权限
im:file:send_as_bot - 发送文件权限（可能需要）
文件上传权限（通过drive:file:upload已授权）

使用示例

示例1：上传文本文件

# 创建测试文件
echo "测试内容" > test.txt

# 上传并发送到群聊
node feishu_complete_upload.js test.txt oc_dd899cb1a7846915cdd2d6850bd1dafa

示例2：上传图片文件

# 上传图片
node feishu_complete_upload.js photo.jpg oc_dd899cb1a7846915cdd2d6850bd1dafa

示例3：上传压缩包

# 压缩文件
tar -czf archive.tar.gz folder/

# 上传压缩包
node feishu_complete_upload.js archive.tar.gz oc_dd899cb1a7846915cdd2d6850bd1dafa

错误处理

常见错误

令牌过期：自动刷新令牌
文件太大：超过30MB限制
权限不足：检查飞书应用权限配置
网络问题：自动重试机制

调试模式

# 查看详细日志
DEBUG=1 node feishu_complete_upload.js file.txt chat_id

集成到OpenClaw

作为工具调用

const { execSync } = require('child_process');
const result = execSync('node feishu_complete_upload.js file.txt chat_id').toString();
console.log(JSON.parse(result));