back
loading skill details...
上传文件到飞书云盘并发送到指定聊天,支持自动令牌管理、30MB大小限制和多种文件格式,需Node.js 18+环境。
# Feishu Upload Skill
飞书文件上传技能 - 直接上传文件到飞书并发送到聊天
## 功能特性
✅ **文件上传**:上传本地文件到飞书云盘
✅ **消息发送**:发送文件消息到指定聊天
✅ **自动令牌管理**:自动获取和刷新访问令牌
✅ **大小限制检查**:自动检查30MB文件大小限制
✅ **多格式支持**:支持各种文件类型(文本、图片、压缩包等)
✅ **纯Node.js实现**:无需额外依赖,使用Node.js 18+原生功能
## 快速开始
### 1. 上传文件并发送到聊天
```bash
node feishu_complete_upload.js <文件路径> <聊天ID>
```
示例:
```bash
node feishu_complete_upload.js document.txt oc_dd899cb1a7846915cdd2d6850bd1dafa
```
### 2. 仅上传文件(获取文件Key)
```bash
node feishu_complete_upload.js <文件路径>
```
### 3. 使用简化脚本
```bash
# 简单上传
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` - 上次上传的结果文件
## 技术原理
### 三步上传流程
1. **获取访问令牌**:使用App ID和Secret获取`tenant_access_token`
2. **上传文件**:使用飞书`/im/v1/files` API上传文件,获取`file_key`
3. **发送消息**:使用`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:上传文本文件
```bash
# 创建测试文件
echo "测试内容" > test.txt
# 上传并发送到群聊
node feishu_complete_upload.js test.txt oc_dd899cb1a7846915cdd2d6850bd1dafa
```
### 示例2:上传图片文件
```bash
# 上传图片
node feishu_complete_upload.js photo.jpg oc_dd899cb1a7846915cdd2d6850bd1dafa
```
### 示例3:上传压缩包
```bash
# 压缩文件
tar -czf archive.tar.gz folder/
# 上传压缩包
node feishu_complete_upload.js archive.tar.gz oc_dd899cb1a7846915cdd2d6850bd1dafa
```
## 错误处理
### 常见错误
1. **令牌过期**:自动刷新令牌
2. **文件太大**:超过30MB限制
3. **权限不足**:检查飞书应用权限配置
4. **网络问题**:自动重试机制
### 调试模式
```bash
# 查看详细日志
DEBUG=1 node feishu_complete_upload.js file.txt chat_id
```
## 集成到OpenClaw
### 作为工具调用
```javascript
const { execSync } = require('child_process');
const result = execSync('node feishu_complete_upload.js file.txt chat_id').toString();
console.log(JSON.parse(result));
```
### 作为Skill使用
1. 将此文件夹复制到`skills/`目录
2. 在OpenClaw配置中启用
3. 通过命令或API调用
## 注意事项
1. **文件大小**:最大支持30MB文件
2. **令牌有效期**:访问令牌2小时有效,自动刷新
3. **权限配置**:确保飞书应用有正确的权限
4. **网络环境**:需要能访问飞书API的网络环境
5. **Node.js版本**:需要Node.js 18+(支持全局FormData和fetch)
## 更新日志
### v1.0.0 (2026-02-12)
- ✅ 初始版本发布
- ✅ 完整的文件上传和发送功能
- ✅ 自动令牌管理
- ✅ 错误处理和日志
- ✅ 多文件格式支持
## 许可证
MIT License - 自由使用和修改don't have the plugin yet? install it then click "run inline in claude" again.