feishui-file-sender

📤 飞书文件一键分发助手

通过飞书通道发送文件(ZIP/PDF/图片等)至指定群聊或私聊,需配合OpenClaw平台使用,支持技能包快捷分发。

收藏
4.9k
安装
1.3k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Feishu File Sender 是面向 OpenClaw 平台用户的飞书文件传输工具,主要用于将本地二进制文件(ZIP 压缩包、PDF 文档、图片等)发送至飞书群组或个人会话。核心依赖 message 工具的 filePath 参数实现文件上传。

标准调用流程:
1. 准备文件:将目标内容打包为 ZIP 或使用现有文件

2. 构造消息调用:指定 action="send"channel="feishu"、绝对路径 filePath、消息标题 message 及目标会话 target

3. 执行发送:系统自动完成飞书接口鉴权与文件上传

典型场景:

  • 技能开发者分发技能包至测试群组
  • 运维人员推送日志压缩包或报告文档
  • 自动化流程产出文件的分发归档

显著优点

  • 集成度高:直接复用 OpenClaw 内置的 message 工具,无需额外安装飞书 SDK
  • 格式兼容广:支持 ZIP、PDF、PNG/JPG 等常见二进制格式
  • 定位灵活:支持群组(oc_xxx)和私聊(用户 ID)双通道
  • 流程标准化:文档提供了清晰的打包命令示例(zip -r 相对路径打包),降低路径错误率

潜在缺点与局限性

  • 平台锁定:强依赖 OpenClaw 框架与预配置的 Feishu channel,无法独立运行
  • 文件大小限制:受飞书官方限制(约 20MB),大文件需分割或改用其他方案
  • 路径敏感:要求使用绝对路径,且 ZIP 内部需保持相对路径结构,操作失误易导致接收方解压异常
  • 无进度反馈:文档未提及上传进度或异步状态查询机制
  • 安全风险未明:报告为占位生成,未验证文件类型白名单、恶意文件过滤等安全机制

适合人群

  • OpenClaw 平台开发者与运维人员
  • 需要自动化推送文件至飞书工作流的团队
  • 熟悉 Python/message 工具调用方式的技能工程师

常规风险

  • 路径泄露风险:错误使用绝对路径打包可能导致接收者看到服务器内部目录结构
  • 文件注入风险:若 filePath 参数可被外部操控,存在任意文件读取与泄露隐患
  • 敏感数据外泄:自动化发送场景下,缺乏内容审核环节可能导致机密文件误发
  • 大小超限失败:未做前置校验时,大文件调用将直接触发飞书接口报错

feishui-file-sender 内容

手动下载zip · 2.2 kB
package.jsonapplication/json
请选择文件