Feishu Media Sender

通过 Python 脚本读取本地图片或视频文件，上传至飞书开放平台并获得 image_key/file_key，再以图片或媒体消息发送到指定 chat_id 或 open_id。文件类型按扩展名自动识别，凭证从 OpenClaw 配置文件读取；不涉及文字消息发送、媒体下载或其他渠道。

yinranphoto

热度 47.18

最近更新 2026-05-11 17:37:27

分类：协作依赖：代码执行 / 读写文件 / 第三方 API应用场景：API 集成 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add feishu-media-sender

Metadata

name: feishu-send-media
description: 飞书媒体发送器 — 上传图片或视频并以媒体消息发送到飞书聊天中。图片直接预览，视频支持播放。补齐飞书渠道缺失的媒体投递能力。| Feishu Media Sender — Upload & send images/videos via Feishu OpenAPI with in-chat preview/playback.
license: MIT
compatibility: openclaw
metadata: {"version":"1.0.0","tags":["feishu","image","video","media","upload","im","messaging","openapi"],"openclaw":{"emoji":"🎬","requires":{"bins":["python3"],"config":["~/.openclaw/openclaw.json"]}}}

Feishu Media Sender | 飞书媒体发送器

Upload images or videos to Feishu and send as media messages with in-chat preview/playback.

将图片或视频上传至飞书并以媒体消息发送，聊天中可直接预览/播放。

Quick Start

# Send image (auto-detect)
python3 scripts/feishu_send_media.py --file photo.jpg --receive-id ou_xxx

# Send video
python3 scripts/feishu_send_media.py --file video.mp4 --receive-id ou_xxx

# Explicit type override
python3 scripts/feishu_send_media.py --file clip.gif --receive-id ou_xxx --type video

Arguments

Param	Required	Description
`--file`	✅	Local file path (absolute)
`--receive-id`	optional	Target `chat_id` or `open_id`. Falls back to `OPENCLAW_CHAT_ID` env var
`--receive-id-type`	optional	Auto-detected from prefix: `oc_` → chat_id, `ou_` → open_id
`--type`	optional	`image` or `video`. Auto-detected from file extension if omitted

Supported Formats

Image: JPG, JPEG, PNG, WEBP, GIF, BMP, ICO, TIFF, HEIC (max 10 MB)

Video: MP4, MOV, AVI, MKV, WEBM (max 30 MB, uploaded as MP4)

How It Works

Images:

Upload via /im/v1/images → get image_key
Send message with msg_type=image, content {"image_key": "..."}

Videos:

Upload via /im/v1/files (file_type=mp4) → get file_key
Send message with msg_type=media, content {"file_key": "..."}

Credentials are auto-read from ~/.openclaw/openclaw.json.