auto-sync: feishu-file-sender 2026-04-03_16:06
This commit is contained in:
commit
99a60702d6
73
SKILL.md
Normal file
73
SKILL.md
Normal file
@ -0,0 +1,73 @@
|
|||||||
|
# 飞书文件发送技能
|
||||||
|
|
||||||
|
## 功能说明
|
||||||
|
通过飞书原生API直接发送本地文件(Excel/PDF/Word/PPT/Markdown/图片/音视频等)给指定的飞书用户或群组,绕过内置message工具的附件限制,支持最大30MB文件传输。
|
||||||
|
|
||||||
|
## 使用场景
|
||||||
|
1. 需要发送导出的Excel报表、分析报告给指定同事
|
||||||
|
2. 需要发送技能文档、配置文件等附件
|
||||||
|
3. 需要批量发送文件到飞书群
|
||||||
|
4. 需要发送大文件(超过普通消息附件限制)
|
||||||
|
|
||||||
|
## 前置条件
|
||||||
|
- 已获取飞书用户授权(包含文件上传和消息发送权限)
|
||||||
|
- 本地文件路径正确,文件存在且可读
|
||||||
|
- 单文件大小不超过30MB
|
||||||
|
|
||||||
|
## 操作步骤
|
||||||
|
|
||||||
|
### 1. (可选)上传文件到飞书云空间
|
||||||
|
如果需要先上传文件再发送,可以调用上传接口:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"name": "feishu_drive_file",
|
||||||
|
"parameters": {
|
||||||
|
"action": "upload",
|
||||||
|
"file_path": "<本地文件的绝对路径>"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
- 支持任意格式的本地文件
|
||||||
|
- 上传成功后会返回file_token和文件信息
|
||||||
|
|
||||||
|
### 2. 直接发送文件给目标对象
|
||||||
|
使用message工具直接发送本地文件:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"name": "message",
|
||||||
|
"parameters": {
|
||||||
|
"action": "send",
|
||||||
|
"channel": "feishu",
|
||||||
|
"target": "<接收目标>",
|
||||||
|
"media": "<本地文件的绝对路径>",
|
||||||
|
"message": "<文件说明文本(可选)>"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
- **target格式**:
|
||||||
|
- 发送给个人:`user:<用户open_id>`,例如 `user:ou_9cb5bc9a5f1b6cab2d78fd36139ecb87`
|
||||||
|
- 发送给群组:`chat:<群chat_id>`,例如 `chat:oc_f6207e1e45dbed30205b1044b9aa0843`
|
||||||
|
- **media**:本地文件的绝对路径,工具会自动处理上传和发送流程
|
||||||
|
- **message**:可选,文件的说明文字,会和文件一起发送
|
||||||
|
|
||||||
|
## 示例
|
||||||
|
### 发送SKILL.md文件给指定用户
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"name": "message",
|
||||||
|
"parameters": {
|
||||||
|
"action": "send",
|
||||||
|
"channel": "feishu",
|
||||||
|
"target": "user:ou_9cb5bc9a5f1b6cab2d78fd36139ecb87",
|
||||||
|
"media": "/root/.openclaw/workspace/skills/feishu-wiki-content-reader/SKILL.md",
|
||||||
|
"message": "飞书知识库内容读取技能SKILL.md文档"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 注意事项
|
||||||
|
1. 单文件最大支持30MB,超过限制会发送失败
|
||||||
|
2. 支持的文件格式:Excel(.xlsx/.xls)、PDF(.pdf)、Word(.docx/.doc)、PPT(.pptx/.ppt)、Markdown(.md)、图片(.jpg/.png/.gif)、音频/视频等
|
||||||
|
3. 需要确保用户已完成飞书授权,否则会返回授权失败
|
||||||
|
4. 发送前请确认文件路径正确,文件有可读权限
|
||||||
|
5. 发送给群聊时需要确保机器人在群内,否则会发送失败
|
||||||
Loading…
Reference in New Issue
Block a user