From 99a60702d6234b399cf960efb3d3fcbedf101a94 Mon Sep 17 00:00:00 2001
From: OpenClaw Bot <bot@valavala.com>
Date: Fri, 3 Apr 2026 16:06:53 +0800
Subject: [PATCH] auto-sync: feishu-file-sender 2026-04-03_16:06

---
 SKILL.md | 73 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 73 insertions(+)
 create mode 100644 SKILL.md

diff --git a/SKILL.md b/SKILL.md
new file mode 100644
index 0000000..5d85aa5
--- /dev/null
+++ b/SKILL.md
@@ -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. 发送给群聊时需要确保机器人在群内，否则会发送失败