ClawHub

支持发送文件到飞书，大于20MB自动分卷裁切

Other

发送任意本地文件到飞书，自动处理大文件。视频/音频按 20MB 分段（不重新编码），其他文件压缩为 ZIP。支持大文件自动处理。

Install

openclaw skills install sendfiles-to-feishu

Feishu Send File Skill

发送任意本地文件到飞书，自动处理大文件和特殊格式。

功能

  • 自动检测文件类型（视频、音频、其他）
  • 视频/音频：保持原质量，按 20MB 分段
  • 其他文件：压缩为 ZIP，如仍超限则分段 ZIP
  • 支持任意文件类型

用法

/sendfiles-to-feishu <文件路径> <接收者ID> [ID类型]

参数：

  • 文件路径：本地文件（绝对或相对路径）
  • 接收者ID：open_id (ou_xxx) 或 union_id (on_xxx)
  • ID类型：可选，open_id 或 union_id（默认自动识别）

示例：

/sendfiles-to-feishu "C:\data\report.pdf" "ou_05eb1e0dcc31159ab77432d1d9adf7a3"
/sendfiles-to-feishu "video.mp4" "on_0144493a63e92550a0602e2b632ff597" "union_id"

处理逻辑

文件类型处理方式
视频（含音频流）按时间切分，每段 < 20MB，不重新编码
视频（无音频）先合并音频（如有分离的音频文件），再切分
纯音频按时间切分
其他（文档、图片、压缩包等）压缩为 ZIP，如仍 > 20MB 则分段 ZIP

权限要求

飞书应用需：

  • im:message.p2p_msg 或 im:message.group_msg
  • drive:file:upload
  • 机器人能力已开启

配置

方式一：.env 文件（推荐）

在技能目录下创建 .env 文件：

# 飞书应用配置
FEISHU_APP_ID=your_app_id_here
FEISHU_APP_SECRET=your_app_secret_here

可复制 .env.example 为 .env 并填入实际值。

方式二：环境变量

设置系统环境变量：

  • FEISHU_APP_ID
  • FEISHU_APP_SECRET

优先级

系统环境变量 > .env 文件

环境检测

脚本启动时自动检测依赖：

类型依赖处理方式
Pythonrequests自动安装
系统ffmpeg, ffprobe提示安装方法

依赖

  • Python 3.8+
  • requests
  • ffmpeg

注意事项

  • 视频分割使用 ffmpeg -c copy，无画质损失
  • 音频视频分离检测可能不准确，如果遇到问题请手动合并
  • ZIP 分割是将同一文件重复打包，接收后需解压并合并（但通常单文件压缩后不会超限）
  • 发送前确保与接收者已有会话（在飞书中互发过消息）

故障排除

  • 发送失败：检查权限和 token
  • 文件过大：自动分段，如果某段仍超限（罕见），手动调整 MAX_FILE_SIZE_MB 常量
  • 音视频分离未合并：确保同目录下有匹配的音频/视频文件（同名）