Tencent SkillHub · Communication & Collaboration

Feishu Send File

飞书发送文件技能。当需要通过飞书向用户发送文件附件（HTML、ZIP、PDF、代码文件等非图片/视频的普通文件）时使用。图片和视频用 message tool 的 media 参数即可，普通文件必须用本技能的两步流程：先上传获取 file_key，再发送消息。

skill openclawclawhub Free

0 Downloads

0 Stars

0 Installs

0 Score

High Signal

⬇ 0 downloads ★ 0 stars Unverified but indexed

Install for OpenClaw

Quick setup

Download the package from Yavira.
Extract the archive and review SKILL.md first.
Import or place the package into your OpenClaw setup.

Requirements

Target platform: OpenClaw
Install method: Manual import
Extraction: Extract archive
Prerequisites: OpenClaw
Primary doc: SKILL.md

Package facts

Download mode: Yavira redirect
Package format: ZIP package
Source platform: Tencent SkillHub
What's included: SKILL.md, scripts/send_file.py, scripts/send_image.py, skill.json

Validation

Use the Yavira download entry.
Review SKILL.md after the package is downloaded.
Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

Download the package from Yavira.
Extract it into a folder your agent can access.
Paste one of the prompts below and point your agent at the extracted folder.

New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.

Open Send to Agent page Open JSON manifest Open Markdown brief

Trust & source

Release facts

Source: Tencent SkillHub
Verification: Indexed source record
Version: 1.2.1

Provenance

Publisher: dadaniya99
Source page: View original listing
Canonical URL: Open canonical page

Documentation

ClawHub primary doc Primary doc: SKILL.md 9 sections Open source page

飞书发送文件

飞书机器人发送普通文件（非图片/视频）需要两步：先上传文件获取 file_key，再用 file_key 发消息。如果本地图片通过常规 message / media 路径发送后，用户在飞书里看到的是 /root/...png 路径文本而不是图片本体，不要继续重试同一种方式；直接改走本技能的稳定图片上传脚本。

方式一：用脚本（推荐）

python3 scripts/send_file.py <file_path> <open_id> <app_id> <app_secret> [file_name] 参数说明： file_path: 要发送的文件路径（HTML/PDF/ZIP/代码文件等） open_id: 接收者的 open_id（从 inbound_meta 的 chat_id 字段获取，格式为 user:ou_xxx，取 ou_xxx 部分） app_id: 飞书应用 ID（从 openclaw.json 的 channels.feishu.appId 读取） app_secret: 飞书应用密钥（从 openclaw.json 的 channels.feishu.appSecret 读取） file_name: 可选，自定义文件名（不填则用原文件名）快速获取配置： # 获取 app_id 和 app_secret grep -A 2 '"feishu"' /root/.openclaw/openclaw.json | grep -E '(appId|appSecret)' 完整示例： python3 /root/.openclaw/workspace/skills/feishu-send-file/scripts/send_file.py \ /root/myfiles/report.html \ <USER_OPEN_ID> \ <YOUR_APP_ID> \ <YOUR_APP_SECRET> \ report.html AI 助手使用示例： # 当需要发送文件给用户时，直接调用脚本 exec(f""" python3 /root/.openclaw/workspace/skills/feishu-send-file/scripts/send_file.py \\ {file_path} \\ {user_open_id} \\ {app_id} \\ {app_secret} \\ {custom_filename} """)

方式二：手动两步

Step 1 - 上传文件： TOKEN=$(curl -s -X POST "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal" \ -H "Content-Type: application/json" \ -d '{"app_id":"<APP_ID>","app_secret":"<APP_SECRET>"}' | python3 -c "import json,sys; print(json.load(sys.stdin)['tenant_access_token'])") FILE_KEY=$(curl -s -X POST "https://open.feishu.cn/open-apis/im/v1/files" \ -H "Authorization: Bearer $TOKEN" \ -F "file_type=stream" \ -F "file_name=<文件名>" \ -F "file=@<文件路径>" | python3 -c "import json,sys; print(json.load(sys.stdin)['data']['file_key'])") Step 2 - 发送消息： curl -s -X POST "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id" \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d "{\"receive_id\":\"<OPEN_ID>\",\"msg_type\":\"file\",\"content\":\"{\\\"file_key\\\":\\\"$FILE_KEY\\\"}\"}"

什么时候不要再硬用 message + media

如果你把本地图片路径（尤其是 /root/myfiles/...）传给飞书消息链路后，用户在飞书里看到的是： 📎 /root/myfiles/xxx.png 或纯本地路径文本那就说明这次没有真正发成图片。不要继续重试同一种参数组合。

原因（真实世界版）

飞书真正的图片消息不是“把本地路径塞给消息发送器” 正路是：先上传到 im/v1/images，拿到 image_key，再发送 msg_type=image OpenClaw / Feishu 插件在某些本地路径场景下（特别是 /root/myfiles/...）可能无法走通本地媒体上传链路，随后自动降级成把路径文本发出去所以：messageId 返回成功不等于用户真的看到了图片

成功标准

只有一个成功标准：用户在飞书里实际看到图片本体。如果回显的是路径文本，就视为失败。

这和普通文件的区别

普通文件：im/v1/files -> file_key -> msg_type=file 图片：im/v1/images -> image_key -> msg_type=image 这两条链路不要混用。

注意事项

普通文件：必须走本技能的两步流程，直接用 filePath 参数只会显示路径图片：理论上 message tool 的 media 参数可以工作；但如果用户看到的是路径文本而不是图片本体，立刻改用 scripts/send_image.py 不要把 /root/myfiles/... 本地路径回显误判为发送成功 receive_id_type=open_id 对应个人用户；群聊用 chat_id 并替换类型飞书 file_type 用 stream 适用于所有普通文件类型

Category context

Messaging, meetings, inboxes, CRM, and teammate communication surfaces.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package

2 Scripts1 Docs1 Config

SKILL.md Primary doc
scripts/send_file.py Scripts
scripts/send_image.py Scripts
skill.json Config