什么是Feishu File Sender
飞书文件发送器（Feishu File Sender）是一个专为 OpenClaw Agent 生态设计的命令行工具，用于弥补飞书渠道在文件投递能力上的缺失。尽管 OpenClaw 的飞书插件目前仅支持文本消息传输，无法直接上传并发送本地生成的文件，该工具通过调用飞书开放平台（OpenAPI）的原生接口，实现了从本地文件系统到飞书聊天窗口的文件自动上传与发送功能。它不依赖图形界面，而是以脚本形式运行，能够无缝集成进自动化工作流中，使 AI 代理在本地生成报告、日志或其他数据文件后，可即时回传至指定飞书会话。整个流程基于标准 HTTP API 实现，安全可靠，且完全遵循飞书的权限与安全规范。
核心功能特点
- 支持通过飞书 OpenAPI 上传任意本地文件并作为附件发送至指定聊天
- 自动识别接收者类型（chat_id/open_id/user_id），无需手动配置复杂参数
- 智能读取当前 OpenClaw 工作区配置，自动匹配对应的飞书应用凭证
- 提供清晰的错误提示机制，涵盖凭证缺失、机器人未加入群组等常见问题
- 轻量级脚本设计，无额外依赖，可直接嵌入现有 agent 执行流程
适用场景
该工具特别适用于需要由 AI 代理自动生成文档或数据输出，并实时同步给团队成员的场景。例如，当某个自动化任务完成分析后，系统会生成一份 Excel 报表或 PDF 摘要，传统方式下这些文件无法通过飞书渠道直接分享。使用飞书文件发送器后，脚本可在后台静默执行，将文件上传至飞书服务器并推送到目标群聊或个人对话中，极大提升了信息传递效率。此外，在 CI/CD 流水线或定时任务中，若需将构建日志、测试结果等文件通知相关人员，此工具也能发挥关键作用。其设计兼顾了灵活性与安全性，既支持指定接收人，也允许使用环境变量 fallback，确保在各种部署环境下都能稳定运行。