feishu-file-sender

# 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 ```bash python3 scripts/feishu_file_sender.py \ --file /absolute/path/to/report.xlsx \ --receive-id oc_xxx ``` ## 使用方法 | Usage ```bash 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 发送文件。 1. Resolve the current agent id by matching `cwd` to OpenClaw workspace path. 2. Read appId/appSecret from `~/.openclaw/openclaw.json` based on the agent id. 3. Call Feishu **Upload File** API to get `file_key`. 4. 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`