feishu-send-file
飞书发送文件技能。用于通过飞书向用户发送普通文件附件(HTML、ZIP、PDF、代码文件等)以及处理“本地图片路径被发成路径文本”的可靠补救场景。普通文件必须先上传获取 `file_key` 再发送;当本地图片用 `message`/`media` 发送后在飞书里只显示 `/root/...png` 路径而不显示...
Popular
New
Join 2,341+ developers using this skill
skill
飞书发送文件技能。用于通过飞书向用户发送普通文件附件(HTML、ZIP、PDF、代码文件等)以及处理“本地图片路径被发成路径文本”的可靠补救场景。普通文件必须先上传获取 `file_key` 再发送;当本地图片用 `message`/`media` 发送后在飞书里只显示 `/root/...png` 路径而不显示...
Real data. Real impact.
Growing
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
飞书机器人发送普通文件(非图片/视频)需要两步:先上传文件获取 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/root/myfiles/...)可能无法走通本地媒体上传链路,随后自动降级成把路径文本发出去messageId 返回成功 不等于 用户真的看到了图片只有一个成功标准:用户在飞书里实际看到图片本体。
如果回显的是路径文本,就视为失败。
python3 scripts/send_image.py <image_path> <open_id> <app_id> <app_secret> [domain]
示例:
python3 /root/.openclaw/workspace/skills/feishu-send-file/scripts/send_image.py \ /root/myfiles/generated-images/demo.png \ <USER_OPEN_ID> \ <YOUR_APP_ID> \ <YOUR_APP_SECRET>
如果是国际版 Lark:
python3 scripts/send_image.py <image_path> <open_id> <app_id> <app_secret> lark
im/v1/files -> file_key -> msg_type=fileim/v1/images -> image_key -> msg_type=image这两条链路不要混用。
filePath 参数只会显示路径message tool 的 media 参数可以工作;但如果用户看到的是路径文本而不是图片本体,立刻改用 scripts/send_image.py/root/myfiles/... 本地路径回显误判为发送成功receive_id_type=open_id 对应个人用户;群聊用 chat_id 并替换类型stream 适用于所有普通文件类型No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.