Feishu File Sender

📎 智能体文件一键送达飞书

integration榜 #2

打通 OpenClaw 智能体文件输出与飞书聊天的最后一公里,支持 Excel/Word/PPT/PDF/图片等全格式文件自动上传并发送。

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

使用说明

核心用法

本技能解决 OpenClaw 智能体能生成文件但无法直接发送至飞书聊天的痛点。智能体生成文件后输出本地路径,本技能自动读取 ~/.openclaw/openclaw.json 中的飞书应用凭证(appId/appSecret),通过飞书 OpenAPI 完成两步操作:先调用上传文件接口获取 file_key,再调用发送消息接口将文件以附件形式送达指定聊天会话。

使用方式极简,支持命令行传参或环境变量自动注入:

  • --file 指定本地文件绝对路径(支持任意格式)
  • --receive-id 指定目标会话,或自动读取 OPENCLAW_CHAT_ID 环境变量
  • --receive-id-type 智能识别 ID 前缀(oc_/ou_/on_)自动匹配类型

显著优点

1. 零配置感知:智能体无需手动管理飞书凭证,通过当前工作目录自动匹配 OpenClaw 工作空间,读取对应账号配置。
2. 格式全覆盖:不限制文件类型,Excel、Word、PPT、PDF、图片、代码文件等均可上传。

3. 上下文无缝衔接:优先复用当前聊天会话的 chat_id,实现"生成即发送"的流畅体验。

4. 企业级集成:基于飞书官方 OpenAPI,非私有协议或逆向接口。

潜在缺点与局限性

  • 依赖飞书机器人权限:目标聊天必须已添加对应飞书机器人,否则返回 230002 错误码。
  • 凭证集中管理风险:所有智能体共享 openclaw.json 中的账号池,若配置文件泄露可能导致多应用凭证暴露。
  • 文件大小与频率限制:受飞书 OpenAPI 本身限流策略约束,超大文件或高频发送可能触发平台级限制。
  • 本地路径依赖:必须能访问文件所在本地文件系统,不适用于分布式或容器化隔离场景。

适合人群

  • 使用 OpenClaw 框架搭建飞书智能体的开发者
  • 需要让 AI 助手自动生成报表、文档并推送到工作群的业务团队
  • 追求"对话即交付"体验的企业自动化场景

常规风险

  • 凭证泄露openclaw.json 包含应用密钥,需确保文件权限为 600 且不在版本控制中。
  • 越权发送:若环境变量被篡改,可能导致文件发送至非预期会话,建议校验 receive-id 白名单。
  • API 变更:飞书 OpenAPI 版本迭代可能导致接口行为变化,需关注官方变更公告。

Feishu File Sender 内容

暂无文件树

手动下载zip · 4.6 kB
contentapplication/octet-stream
请选择文件