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:

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