核心用法
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参数可被外部操控,存在任意文件读取与泄露隐患 - 敏感数据外泄:自动化发送场景下,缺乏内容审核环节可能导致机密文件误发
- 大小超限失败:未做前置校验时,大文件调用将直接触发飞书接口报错