# Send Feishu Send File to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - 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. ## Suggested prompts ### New install ```text 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 ```text 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. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "feishu-send-file", "name": "Feishu Send File", "source": "tencent", "type": "skill", "category": "通讯协作", "sourceUrl": "https://clawhub.ai/dadaniya99/feishu-send-file", "canonicalUrl": "https://clawhub.ai/dadaniya99/feishu-send-file", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/feishu-send-file", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=feishu-send-file", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "scripts/send_file.py", "scripts/send_image.py", "skill.json" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-23T16:43:11.935Z", "expiresAt": "2026-04-30T16:43:11.935Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/feishu-send-file" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/feishu-send-file", "downloadUrl": "https://openagent3.xyz/downloads/feishu-send-file", "agentUrl": "https://openagent3.xyz/skills/feishu-send-file/agent", "manifestUrl": "https://openagent3.xyz/skills/feishu-send-file/agent.json", "briefUrl": "https://openagent3.xyz/skills/feishu-send-file/agent.md" } } ``` ## Documentation ### 飞书发送文件 飞书机器人发送普通文件（非图片/视频）需要两步：先上传文件获取 file_key，再用 file_key 发消息。 如果本地图片通过常规 message / media 路径发送后，用户在飞书里看到的是 /root/...png 路径文本而不是图片本体，不要继续重试同一种方式；直接改走本技能的稳定图片上传脚本。 ### 方式一：用脚本（推荐） python3 scripts/send_file.py [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 \\ \\ \\ \\ 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_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\\":\\"\\",\\"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 返回成功 不等于 用户真的看到了图片 ### 成功标准 只有一个成功标准：用户在飞书里实际看到图片本体。 如果回显的是路径文本，就视为失败。 ### 推荐脚本（稳定版） python3 scripts/send_image.py [domain] 示例： python3 /root/.openclaw/workspace/skills/feishu-send-file/scripts/send_image.py \\ /root/myfiles/generated-images/demo.png \\ \\ \\ 如果是国际版 Lark： python3 scripts/send_image.py lark ### 这和普通文件的区别 普通文件：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 适用于所有普通文件类型 ## Trust - Source: tencent - Verification: Indexed source record - Publisher: dadaniya99 - Version: 1.2.1 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-23T16:43:11.935Z - Expires at: 2026-04-30T16:43:11.935Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/feishu-send-file) - [Send to Agent page](https://openagent3.xyz/skills/feishu-send-file/agent) - [JSON manifest](https://openagent3.xyz/skills/feishu-send-file/agent.json) - [Markdown brief](https://openagent3.xyz/skills/feishu-send-file/agent.md) - [Download page](https://openagent3.xyz/downloads/feishu-send-file)