Feishu File Sender

核心用法

Feishu File Sender 是一个为 OpenClaw 生态设计的桥接技能，解决官方飞书渠道插件仅支持文本消息、无法投递文件的架构缺陷。该技能通过 Python 脚本直接调用飞书 OpenAPI，实现本地文件的上传与消息投递。

使用流程：
1. 自动识别当前工作区，从 ~/.openclaw/openclaw.json 读取对应 agent 的飞书应用凭证（appId/appSecret）
2. 调用飞书"上传文件" API 获取 file_key
3. 调用飞书"发送消息" API 将文件投递至指定聊天

命令示例：

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

支持自动识别 receive_id_type（通过 oc_/ou_/on_ 前缀），也可通过环境变量 OPENCLAW_CHAT_ID 隐式传入目标 ID。

显著优点

• 零配置桥接：无需修改 OpenClaw 核心或渠道插件，以独立技能形式填补功能空白
• 凭证隔离：按 agent 自动匹配飞书应用配置，支持多租户/多应用部署
• 智能降级：ID 类型自动推断，降低使用门槛
• MIT 开源：可自由审计、修改与二次分发

潜在局限与风险

局限：

• 依赖本地 Python3 运行时，非纯 OpenClaw 原生实现
• 需预配置 openclaw.json 的 channels.feishu 结构，首次部署有门槛
• 不支持文件内容预览或富文本格式控制，仅基础文件投递

风险：

• 凭证以明文形式存储于本地 JSON，依赖文件系统权限保护
• 脚本拥有飞书 API 调用权限，若被非授权调用可能导致信息外泄
• 错误码 230002（机器人不在群内）需人工处理，无自动加群能力

适合人群

• 使用 OpenClaw 构建飞书机器人的开发者
• 需要将生成文件（报表、文档、图片）自动回传至飞书聊天的自动化场景
• 企业 IT 管理员，寻求最小侵入性的飞书文件投递方案

安全建议

建议将 ~/.openclaw/openclaw.json 权限设为 600，并定期轮换 appSecret；生产环境可考虑通过环境变量注入凭证，避免磁盘持久化存储。

核心用法

feishu-file-sender 是专为 OpenClaw 生态设计的桥接工具，解决官方飞书渠道仅支持文本消息的局限。技能通过 Python 脚本直接调用飞书 OpenAPI，完成「上传文件→获取 file_key→发送消息」的完整链路。

典型使用场景：Agent 生成本地报告（Excel/Word/PDF）后，自动回传到触发会话。

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

脚本支持智能 ID 识别（oc_/ou_/on_ 前缀自动映射），也可通过环境变量 OPENCLAW_CHAT_ID 隐式传递目标会话。

显著优点

• 无缝补齐架构缺口：无需等待官方渠道更新，即开即用的文件投递能力
• 零配置感知：自动读取 ~/.openclaw/openclaw.json 匹配当前 Agent 的飞书凭证，开发者无感
• 轻量依赖：仅依赖 requests 单库，无臃肿框架
• 传输安全：全链路 HTTPS，仅访问 open.feishu.cn 官方域名

潜在缺点与局限

• 凭证耦合：依赖本地 OpenClaw 配置文件，若配置迁移或权限变更会导致失效
• T3 来源风险：个人开发者维护，长期更新节奏不确定
• 无重试机制：网络抖动时可能失败，需外部 wrapping 保证可靠性
• 飞书侧限制：受限于飞书 Bot 权限（如必须已在群内），错误码 230002 需人工介入

适合人群

• 使用 OpenClaw 构建飞书 Bot 的开发者
• 需要将 Agent 输出文件自动推送至 IM 场景的业务团队
• 能接受本地凭证配置方案的中低敏感场景

常规风险

| 风险点 | 等级 | 说明 |

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

| 本地凭证读取 | 低 | 从 `~/.openclaw/openclaw.json` 读取 appId/appSecret，需确保文件权限 600 |

| 网络外连 | 低 | 仅流向飞书官方 API，TLS 加密 |

| 文件内容外发 | 功能固有 | 上传至飞书服务器，需确认文件不含敏感信息 |

建议定期轮换飞书 appSecret，并监控 log_id 以便排查 API 异常。