Feishu File Sender

核心用法

feishu-file-sender 是 OpenClaw 代理生态的配套工具，用于填补"Agent 能生成文件但无法直接发送到飞书"的能力缺口。其核心工作流为：

1. 凭证自动发现：通过当前工作目录匹配 OpenClaw 工作空间，从 ~/.openclaw/openclaw.json 读取对应 Agent 绑定的飞书 appId/appSecret
2. 文件上传：调用飞书 OpenAPI 的 Upload File 接口，获取 file_key
3. 消息投递：调用 Send Message 接口，将文件以可下载附件形式发送到指定会话

支持全格式（Excel、Word、PPT、PDF、图片、代码文件等），通过 --receive-id 或环境变量 OPENCLAW_CHAT_ID 指定目标会话，ID 类型（chat_id/open_id/user_id）可自动识别前缀推断。

显著优点

• 零配置集成：读取 OpenClaw 既有配置，无需额外填写凭证
• 全格式通用：不限制文件类型，依赖飞书原生文件处理能力
• 会话感知：优先使用当前对话上下文，符合 Agent 交互直觉
• 轻量独立：单 Python 脚本实现，依赖仅 python3

潜在缺点与局限性

• 生态绑定：深度依赖 OpenClaw 配置体系，脱离该环境无法独立运行
• 凭证集中风险：多 Agent 共享 ~/.openclaw/openclaw.json，误配置可能导致凭证串用
• Bot 准入限制：目标群组必须预先添加该飞书机器人，否则报错 230002
• 无加密传输声明：凭证和文件均通过 HTTPS 传输，但脚本未额外实现本地加密或密钥托管
• 单租户模式：一次调用仅支持单一飞书企业租户

适合人群

• OpenClaw 平台用户，需将 Agent 输出文件自动推送到飞书协作场景
• 企业自动化工作流开发者，构建"生成-审核-分发"闭环
• 内部工具团队，需低代码方式实现文件通知机器人

常规风险

| 风险类别 | 说明 |

|---------|------|

| 凭证泄露 | `openclaw.json` 包含 appSecret，需确保文件权限为 `600` 且不在版本控制中 |

| 越权发送 | 脚本不校验发送者身份与文件内容敏感性，需上层 Agent 控制权限 |

| 会话误投 | `receive_id` 错误可能导致文件发送到非预期群组，建议结合白名单校验 |

| API 限流 | 高频调用可能触发飞开放平台速率限制，需实现退避重试机制（当前未内置） |

功能概述

feishu-file-sender 是一款专为 OpenClaw 生态设计的文件发送工具，解决 AI Agent 生成文件后无法直接推送至飞书的痛点。该 Skill 通过调用飞书官方 OpenAPI，实现本地文件的上传与消息投递，支持 Excel、Word、PPT、PDF、图片、代码文件等全格式。

核心用法

使用方式极为简洁：

python3 scripts/feishu_file_sender.py --file /path/to/report.xlsx --receive-id oc_xxx

Skill 会自动识别当前工作区、匹配 ~/.openclaw/openclaw.json 中的凭证配置，无需手动指定 appId/appSecret。receive-id 支持 chat_id（群聊）、open_id、user_id 三种类型，可通过前缀自动识别（oc_/ou_/on_）。

显著优点

1. 无缝集成：与 OpenClaw 深度绑定，自动解析 Agent ID 和凭证，零配置成本
2. 格式全能：不限制文件类型，从办公文档到代码、图片均可发送
3. 安全传输：全程 HTTPS 加密，调用飞书官方域名 open.feishu.cn
4. 依赖极简：仅依赖 requests 单库，无复杂依赖树
5. 错误完备：针对凭证缺失、机器人未入群、接收方错误等场景提供清晰指引

潜在局限

• 平台绑定：仅支持飞书生态，无法用于钉钉、企业微信等其他 IM
• 本地执行依赖：需 Python 3 环境，且必须在配置好 OpenClaw 的机器上运行
• 权限门槛：需预先完成飞书应用创建、机器人入群、OpenClaw 绑定等准备工作
• 来源可信度：个人开发者作品（T3），建议审查后用于生产环境

适合人群

• 使用 OpenClaw 开发 AI Agent 的开发者与自动化工程师
• 需要将报表、代码、设计稿等文件自动推送至飞书群聊的企业团队
• 构建飞书 BOT 自动化工作流的技术人员

常规风险

• 凭证泄露风险：若 ~/.openclaw/openclaw.json 权限配置不当，可能导致 appSecret 被其他用户读取（建议 chmod 600）
• 误发风险：未验证 receive-id 可能导致文件发送至错误对象
• API 变更风险：依赖飞书 OpenAPI，若接口升级需同步更新 Skill