Feishu Media Sender | 飞书媒体发送器#

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

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

Quick Start#

bash

# 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#

ParamRequiredDescription--file✅Local file path (absolute)--receive-idoptionalTarget chat_id or open_id. Falls back to OPENCLAW_CHAT_ID env var--receive-id-typeoptionalAuto-detected from prefix: oc_ → chat_id, ou_ → open_id--typeoptionalimage 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:

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

Videos:

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

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

API Reference#

• Upload Image
• Upload File
• Send Message