核心用法
Feishu File Sender 解决了OpenClaw智能体生成文件后无法直接发送到飞书的痛点。智能体只能输出本地文件路径,而此Skill通过调用飞书OpenAPI,将任意本地文件上传并作为可下载附件发送到指定会话。使用时只需提供文件绝对路径,可选指定接收会话ID;若省略,则自动从环境变量OPENCLAW_CHAT_ID读取。
显著优点
无缝集成:自动从~/.openclaw/openclaw.json读取应用凭证,无需硬编码或额外配置,支持多Agent多账号场景。格式全兼容:支持Excel、Word、PPT、PDF、图片、代码文件等任意格式,通过stream模式上传。智能识别:receive-id前缀自动推断类型(oc_群聊/ou_用户/on_员工号),减少参数负担。开箱即用:单脚本设计,依赖仅Python3,无复杂运行时要求。
潜在局限
凭证本地化:必须预先在本地配置好appId和appSecret,无法动态获取或OAuth授权。单租户限制:绑定特定飞书企业,跨租户使用需手动切换配置。权限依赖:机器人必须在目标群中,否则会返回230002错误,无法自动邀请入群。无预览能力:仅发送原文件,不提供缩略图或在线预览优化。路径限制:要求绝对路径,相对路径可能因CWD变化导致失败。
适合人群
- 使用OpenClaw生成报告/文档并需快速分发到飞书的业务分析师
- 构建自动化工作流、需要闭环"生成-发送"能力的开发者
- 企业内部飞书机器人维护者,追求配置即用的低运维方案
常规风险
凭证泄露风险:openclaw.json包含敏感AppSecret,需确保文件权限为600且不在版本控制中。越权发送:脚本不校验发送者身份,任何能执行脚本的用户可代机器人发消息,需配合主机级权限管控。文件内容风险:上传内容未经内容安全扫描,恶意文件可能通过此渠道传播。API限流:高频调用可能触发飞书频控,生产环境需自行实现退避重试。