feishu-file-sender

name	feishu-file-sender
description	飞书文件发送器 — 补齐飞书渠道缺失的文件投递能力，通过飞书 OpenAPI 上传并发送 agent 生成的本地文件。| Feishu File Sender — Upload & send files via Feishu OpenAPI, filling the channel's missing file delivery.
license	MIT
compatibility	openclaw
metadata	{"version":"1.0.9","tags":["feishu","file","upload","im","messaging","openapi"],"author":"wen-ai","openclaw":{"emoji":"📎","requires":{"bins":["python3"],"config":["~/.openclaw/openclaw.json"]}}}

Feishu File Sender | 飞书文件发送器

OpenClaw agent 在本地生成文件，但飞书渠道插件只支持文本消息，没有文件投递能力。本 skill 通过直接调用飞书 OpenAPI（上传+发送）补齐这一底层能力，使生成的文件能回传到聊天中。

OpenClaw agents generate files locally, but the Feishu channel integration only supports text messages and does not provide native file delivery. This skill fills that architectural gap by calling Feishu OpenAPI directly (upload + send), enabling files to be delivered back to chat.

将本地文件上传到飞书并作为文件消息发送。

Upload a local file to Feishu and send it as a file message.

快速开始 | Quick Start

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

使用方法 | Usage

python3 scripts/feishu_file_sender.py \
  --file /absolute/path/to/file \
  --receive-id <chat_id|open_id> \
  --receive-id-type <chat_id|open_id|user_id>

参数说明 | Arguments

• --file（必填）：本地文件绝对路径。

• --receive-id（可选）：目标 chat_id 或 open_id。若省略，脚本会读取 OPENCLAW_CHAT_ID（或 OPENCLAW_RECEIVE_ID / FEISHU_CHAT_ID）。

• --receive-id-type（可选）：若省略，将根据前缀自动识别：

  • oc_ → chat_id
  • ou_ → open_id
  • on_ → user_id

• --file-type（可选）：飞书上传的文件类型，默认 stream。

• --file (required): Absolute path to the local file.

• --receive-id (optional): Target chat_id or open_id. If omitted, the script reads OPENCLAW_CHAT_ID (or OPENCLAW_RECEIVE_ID / FEISHU_CHAT_ID).

• --receive-id-type (optional): If omitted, auto-detect by prefix:

  • oc_ → chat_id
  • ou_ → open_id
  • on_ → user_id

• --file-type (optional): Feishu file upload type, default stream.

工作原理 | How It Works

1. 通过 cwd 匹配 OpenClaw 工作区，解析当前 agent id。

2. 根据 agent id 从 ~/.openclaw/openclaw.json 读取 appId/appSecret。

3. 调用飞书 上传文件 API 获取 file_key。

4. 调用飞书 发送消息 API 发送文件。

5. Resolve the current agent id by matching cwd to OpenClaw workspace path.

6. Read appId/appSecret from ~/.openclaw/openclaw.json based on the agent id.

7. Call Feishu Upload File API to get file_key.

8. Call Feishu Send Message API to deliver the file.

错误处理 | Error Handling

• 缺少凭证 → 确保 channels.feishu.accounts 存在于 ~/.openclaw/openclaw.json，且 bindings 映射 agentId → accountId。

• 机器人不在群内（230002） → 将机器人加入目标群或换一个群。

• 缺少 receive_id → 传入 --receive-id 或设置 OPENCLAW_CHAT_ID。

• HTTP 错误 → 查看飞书错误返回中的 log_id 进行排查。

• Missing credentials → Ensure channels.feishu.accounts exists in ~/.openclaw/openclaw.json and bindings map agentId → accountId.

• Bot not in chat (code 230002) → Add the bot to the target chat or use a chat where the bot is present.

• Missing receive_id → Pass --receive-id or set OPENCLAW_CHAT_ID.

• HTTP errors → Check the returned log_id in Feishu error payload.

安全说明 | Security

本技能会从本机 OpenClaw 配置中读取飞书凭证（~/.openclaw/openclaw.json）：

• channels.feishu.accounts.*.appId
• channels.feishu.accounts.*.appSecret

这些凭证仅用于获取 tenant access token 并发送文件。技能不会存储或向其他地方传输凭证。

This skill reads Feishu credentials from the local OpenClaw config (~/.openclaw/openclaw.json) on the machine where it runs:

• channels.feishu.accounts.*.appId
• channels.feishu.accounts.*.appSecret

These values are used only to obtain a tenant access token and send the file. The skill does not store or transmit credentials anywhere else.

备注 | Notes

• 本技能面向 所有 agent 设计，会自动读取当前工作区来选择正确的 飞书应用凭证。

• 建议通过入站 chat_id 发送到 当前聊天。

• This skill is designed for all agents; it reads the active workspace to choose the correct Feishu app credentials automatically.

• Prefer sending to the current chat by passing the inbound chat_id.

随附脚本 | Bundled Script

• scripts/feishu_file_sender.py