Feishu Video Message | 飞书视频发送器

Upload a video to Feishu and send it as a media message with auto-generated cover & duration, playable in chat.

将视频上传至飞书并以媒体消息发送，自动抽取首帧作为封面、探测时长，聊天中可直接播放。

When to Use | 何时使用

当在飞书渠道中需要把一段视频发送/展示给用户时，使用本 skill（无需修改 Agent soul）。典型场景：

• 用户在飞书里要求「发个视频 / 把这个视频发我」
• 拿到一个视频的远端地址（如 OpenViking 资源的 preview_url）需要投递到当前飞书聊天

调用约定：

• 用 --url 传远端视频地址（skill 会下载→发送→自动删除临时文件）；本地文件则用 --file。
• 用 --receive-id 传当前聊天的标识，直接用上下文里的原值即可（如 chat:oc_xxx），skill 会自动剥掉 chat: 前缀。单聊为 ou_ 开头、群聊为 oc_ 开头。

Quick Start

# 本地文件（自动封面 + 时长）
python3 scripts/feishu_send_video.py --file video.mp4 --receive-id oc_xxx

# 远端 URL（如 OpenViking preview_url）：下载 → 发送 → 自动删除临时文件
python3 scripts/feishu_send_video.py --url 'https://.../video.mp4' --receive-id oc_xxx

# 跳过封面
python3 scripts/feishu_send_video.py --file video.mp4 --receive-id ou_xxx --no-cover

Arguments

--file 与 --url 必须二选一（至少一个、不能同时）。

关于 --receive-id（聊天目标）

--receive-id 必填，由调用方（模型）传入「当前聊天」的标识：

• 单聊：传对方的 chat_id（一般为ou_ 开头）
• 群聊：传群的 chat_id（一般为oc_ 开头）

获取当前聊天的chat-id传入，当做--receive-id的值。

可直接传 OpenClaw 上下文里的原值（如 chat:oc_xxx），skill 会自动剥掉 chat: 等前缀。

Supported Formats

Video: MP4, MOV, AVI, MKV, WEBM（max 30 MB，以 MP4 上传）

How It Works

1. 取源：--file 用本地文件；--url 先下载到临时文件
2. 抽封面：用 ffmpeg 抽取第 1 秒首帧 → 临时 JPG（失败自动降级为无封面）
3. 传封面：上传首帧 via /im/v1/images → 得到 image_key
4. 探时长：用 ffprobe 探测视频时长（毫秒）
5. 传视频：上传 via /im/v1/files（file_type=mp4，带 duration）→ 得到 file_key
6. 发消息：msg_type=media，content {"file_key": "...", "image_key": "..."}
7. 清理：临时封面图 + --url 下载的临时视频发送后自动删除

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

封面抽取、时长探测、封面上传任一步失败都不会中断主流程，会降级为「无封面/无时长」继续发送视频。

Requirements

• python3（依赖 requests）
• ffmpeg / ffprobe（封面抽取与时长探测）

API Reference

• Upload Image
• Upload File
• Send Message