核心用法
Feishu File Sender 是一款面向 OpenClaw 生态的桥接型技能，用于解决飞书渠道插件仅支持文本消息、无法原生投递文件的限制。该技能通过 Python 脚本直接调用飞书 OpenAPI，完成「上传文件 → 获取 file_key → 发送文件消息」的完整链路，使 Agent 生成的报表、文档等本地文件能够自动回传到飞书会话中。
使用上只需指定本地文件绝对路径与目标会话 ID（支持自动识别 chat_id/open_id/user_id），脚本会自动解析当前工作区、匹配对应的飞书应用凭证（appId/appSecret），完成无感鉴权与发送。兼容所有 Agent，无需硬编码配置。
显著优点
1. 架构补位：精准填补 OpenClaw 官方飞书渠道的能力空白，实现文件级消息闭环
2. 零配置感知：自动读取 ~/.openclaw/openclaw.json，按工作区匹配凭证，多 Agent 场景下无需手动切换
3. 智能 ID 识别：--receive-id-type 可省略，自动根据 oc_/ou_/on_ 前缀推断目标类型
4. 灵活触发：支持命令行参数或环境变量（OPENCLAW_CHAT_ID）双模式传入目标会话
5. 开源轻量：单 Python 脚本实现，MIT 协议，易于审计与二次定制
潜在缺点与局限性
- 单租户限制：依赖本地 OpenClaw 配置文件，无法跨租户或跨机器复用凭证
- 机器人准入门槛：目标群聊必须预先添加对应飞书机器人，否则报错 230002
- 无进度反馈：大文件上传期间无进度条，超时场景需自行重试
- 类型覆盖有限：默认仅支持 stream 类型上传，特殊飞书文件类型（如 image/voice）需手动指定
--file-type - 环境耦合：必须与 OpenClaw 工作目录结构保持兼容，独立使用需模拟 workspace 路径匹配逻辑
适合人群
- 使用 OpenClaw 搭建飞书智能体、且需要向用户回传生成文件（Excel、PDF、图片等）的开发者
- 企业内部自动化工作流构建者，希望将 Agent 输出物直接投递到业务群聊
- 追求最小依赖、快速补位官方能力缺失的轻量级集成场景
常规风险
- 凭证泄露风险：脚本需读取本地明文存储的 appSecret，共享机器或 CI 环境需严格管控文件权限
- 权限扩散：获取 tenant access token 后具备该应用全部消息发送权限，需确保 bindings 映射最小化
- 日志敏感信息：调试时可能打印
log_id，结合时间戳可反向追踪，生产环境建议脱敏处理 - API 限流：高频文件发送可能触发飞书开放平台速率限制，需自行实现退避重试