视频生成工具（video_generate）

概述

video_generate 工具让 Agent 从文本提示、参考图像或已有视频生成视频，支持 16 个 provider 后端。视频生成为异步执行：提交后立即返回 task id，provider 在后台处理（通常 30 秒到数分钟），完成后唤醒 Agent 会话并附上生成的视频。

核心功能

三种运行模式

• generate：纯文本生成视频
• imageToVideo：包含参考图像
• videoToVideo：包含参考视频

支持的 Provider（部分）

Provider	默认模型	文本	图像参考	视频参考
Google	veo-3.1-fast-generate-preview	✓	1 张	1 个
OpenAI	sora-2	✓	1 张	1 个
Runway	gen4.5	✓	1 张	1 个
fal	fal-ai/minimax/video-01-live	✓	最多 9 张	最多 3 个
MiniMax	MiniMax-Hailuo-2.3	✓	1 张	-
BytePlus	seedance-1-0-pro-250528	✓	最多 2 张	-
xAI	grok-imagine-video	✓	最多 7 张	1 个

任务生命周期

状态	含义
queued	已创建，等待 provider 接受
running	Provider 处理中
succeeded	视频就绪，Agent 唤醒并发送
failed	Provider 错误或超时

openclaw tasks list
openclaw tasks show <taskId>
openclaw tasks cancel <taskId>

关键参数

• prompt：视频描述（必填）
• action：generate/status/list
• model：provider/model 覆盖
• image/images：参考图像（最多 9 张）
• imageRoles：per-position 角色提示（first_frame、last_frame、reference_image）
• video/videos：参考视频（最多 4 个）
• aspectRatio：宽高比（如 16:9、adaptive）
• resolution：分辨率（480P/720P/1080P/4K）
• durationSeconds：目标时长
• audio：是否生成音频
• providerOptions：provider 特定选项（如 {"seed": 42}）

配置/权限

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "google/veo-3.1-fast-generate-preview",
        fallbacks: ["runway/gen4.5", "qwen/wan2.6-t2v"]
      }
    }
  }
}

重复调用防护：同一会话中已有 queued/running 任务时，新调用返回当前任务状态而非启动新生成。

相关页面

• tool-media-overview — 媒体能力总览
• tool-image-generation — 图像生成工具
• tool-music-generation — 音乐生成工具