概述
OpenClaw v2026.4.11 显著增强了视频生成（video_generate 工具）能力：
- 自适应宽高比：支持任意宽高比，针对不同平台优化
- URL 直接交付：视频生成完成后直接返回 URL，无需本地下载
- 流式播放：URL 支持流媒体协议，无需等待完整下载
支持的宽高比
标准比例
| 比例 | 适用平台 | 典型分辨率 |
|---|---|---|
| 16:9 | YouTube、横屏视频、电视 | 1920×1080 |
| 9:16 | TikTok、抖音、Instagram Reels | 1080×1920 |
| 1:1 | Instagram 帖子、Twitter | 1080×1080 |
| 4:5 | Instagram 竖版帖子 | 1080×1350 |
| 4:3 | 老式视频、教学视频 | 1440×1080 |
| 21:9 | 电影感、横幅 | 2560×1080 |
自定义比例
也支持任意自定义比例：
tools:
video_generate:
aspectRatio: "32:9" # 超宽屏
基础配置
全局默认宽高比
# config.yaml
tools:
video_generate:
aspectRatio: "9:16" # 默认竖屏
delivery: "url" # url 或 file
单次调用指定
在对话中临时指定：
用户：生成一个关于咖啡冲泡的 30 秒视频，宽高比 16:9
Agent：[调用 video_generate，aspectRatio="16:9"]
视频生成完成，URL 如下：...
URL 交付详解
优势
v2026.4.11 之前视频生成完成后会下载到本地，存在以下问题：
- 占用本地存储
- 大文件传输慢
- 跨设备分享不便
URL 交付解决了这些问题：
- 零本地存储：视频存在 Provider 的 CDN
- 流式播放：用户可以边下边看
- 直接分享：URL 可直接发送给团队成员
- 多设备访问：手机、平板、电脑都能看
配置 URL 模式
tools:
video_generate:
delivery: "url"
urlExpiry: "7d" # URL 有效期：7 天（视 Provider 支持）
切回文件模式
如果需要本地副本：
tools:
video_generate:
delivery: "file"
outputDir: "./generated/videos"
或单次指定：
用户：生成视频并保存到本地
多平台批量生成
场景：一次内容多平台分发
为同一内容生成多个版本：
# workflows/multi-platform-video.lobster
name: multi-platform-video
args:
topic:
description: "视频主题"
steps:
- id: youtube
tool: video_generate
args:
prompt: "${topic}，YouTube 横屏视频"
aspectRatio: "16:9"
durationSeconds: 60
- id: tiktok
tool: video_generate
args:
prompt: "${topic}，TikTok 竖屏短视频"
aspectRatio: "9:16"
durationSeconds: 30
- id: instagram_post
tool: video_generate
args:
prompt: "${topic}，Instagram 方形帖子"
aspectRatio: "1:1"
durationSeconds: 30
- id: report
tool: message
args:
channel: "feishu:marketing"
text: |
视频已生成：
- YouTube: ${youtube.url}
- TikTok: ${tiktok.url}
- Instagram: ${instagram_post.url}
执行：
openclaw lobster run multi-platform-video.lobster --args '{"topic": "春季新品发布"}'
配合 Cron 自动化
cron:
- schedule: "0 9 * * 1" # 每周一早 9 点
flow: multi-platform-video
args:
topic: "本周精选话题"
Provider 支持情况
不同 Provider 对宽高比的支持有差异：
| Provider | 16:9 | 9:16 | 1:1 | 自定义 |
|---|---|---|---|---|
| 阿里 Wan | ✓ | ✓ | ✓ | 部分 |
| Runway | ✓ | ✓ | ✓ | ✓ |
| xAI Grok | ✓ | ✓ | ✓ | 部分 |
| ComfyUI | 取决于工作流 |
不支持的比例时：
- v2026.4.11 之前：直接报错
- v2026.4.11 之后：警告但继续，自动选择最接近的支持比例
时长控制
tools:
video_generate:
defaultDuration: 30
或单次指定：
用户：生成 60 秒视频
不同 Provider 的时长上限：
| Provider | 单次最大时长 |
|---|---|
| 阿里 Wan | 5 秒 |
| Runway | 16 秒 |
| xAI Grok | 30 秒 |
| ComfyUI | 取决于工作流 |
超长视频建议拆分成多个片段后合并。
性能优化
异步生成
视频生成是异步任务：
用户：生成视频
Agent：已开始生成，预计 2-3 分钟，完成后通知您
[任务 ID: vid-xxx]
[2 分钟后]
Agent：视频已完成：[URL]
可以同时发起多个生成任务，并行处理。
缓存策略
对于重复的视频请求：
tools:
video_generate:
cache:
enabled: true
ttl: "7d"
相同提示的重复请求会复用之前的结果。
注意事项
- 视频生成需要 OpenClaw v2026.4.5+，URL 交付需要 v2026.4.11+
- URL 通常有有效期，重要视频建议下载备份
- 自定义宽高比可能不被所有 Provider 支持
- 视频生成消耗较多 API 配额，注意成本
- 部分 Provider 对内容有限制（不能生成真人形象等），违规会被拒绝
- 中国用户推荐阿里 Wan，访问稳定且符合监管要求