Feishu File Sender

飞书文件发送器 — 补齐飞书渠道缺失的文件投递能力，通过飞书 OpenAPI 上传并发送 agent 生成的本地文件。| Feishu File Sender — Upload & send files via Feishu OpenAPI, filling the channel's missing file...

Security Scan

The skill's code, instructions, and requested config access align with its stated purpose of uploading a local file to Feishu and sending it to a chat; nothing in the bundle appears to perform unrelated or hidden actions.

Purpose & Capability

Name/description describe uploading local files to Feishu. The script only requires python3 and the OpenClaw config (~/.openclaw/openclaw.json) to locate appId/appSecret, then calls Feishu token/upload/send APIs — all of which are necessary and proportional for the claimed functionality.

Instruction Scope

SKILL.md and the script instruct the agent to read the OpenClaw config, resolve an agent by matching cwd against workspace paths, optionally read environment variables (OPENCLAW_CHAT_ID / OPENCLAW_RECEIVE_ID / FEISHU_CHAT_ID), and then call Feishu APIs. These steps stay within the stated purpose, but the script does read optional environment variables that are not listed in the skill's top-level 'required env vars' — they are optional for receive_id resolution.

Install Mechanism

No install spec is provided (instruction-only). The README notes 'requests' is required; that is a reasonable, low-risk dependency for an HTTP client. Nothing is downloaded from arbitrary URLs nor are archives extracted.

Credentials

The skill reads appId/appSecret from ~/.openclaw/openclaw.json (declared in manifest) which is necessary to obtain a tenant token and send files. It does not request unrelated cloud credentials. However, it also optionally inspects environment variables (OPENCLAW_CHAT_ID / OPENCLAW_RECEIVE_ID / FEISHU_CHAT_ID) that are not declared as required in registry metadata — this is benign but worth noting so users know which env vars may be consulted.

Persistence & Privilege

always:false and default model-invocation behavior. The skill does not request permanent or system-wide changes and does not modify other skills. It only reads a per-user OpenClaw config file and performs network calls to Feishu, which matches its purpose.

Assessment

This skill appears to do exactly what it says: read your OpenClaw config for Feishu appId/appSecret, obtain a tenant token, upload a specified local file, and send it to a chat. Before using it, verify you trust the source and inspect ~/.openclaw/openclaw.json (it contains app secrets) and the included script. Ensure the bot/account in that config is appropriate for sending the file and avoid sending sensitive files unintentionally. Note the tool will also accept optional env vars (OPENCLAW_CHAT_ID / OPENCLAW_RECEIVE_ID / FEISHU_CHAT_ID) for resolving the receive_id even though none are listed as required in the metadata.

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