视频生成

"status" 返回当前会话任务；"list" 检查提供商。

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InRpbWVvdXRNcyIgdHlwZT0ibnVtYmVyIg 可选的提供商操作超时时间，单位为毫秒。省略时，如果已配置，OpenClaw 会使用 agents.defaults.videoGenerationModel.timeoutMs，否则在存在插件作者提供的提供商默认值时使用该默认值。 OPENCLAW_DOCS_MARKER:paramClose:

参考输入会选择运行时模式：

• 无参考媒体 -> generate
• 任意图像参考 -> imageToVideo
• 任意视频参考 -> videoToVideo
• 参考音频输入不会改变解析后的模式；它们会叠加应用在图像/视频参考所选择的任何模式之上，并且仅适用于声明了 maxInputAudios 的提供商。

混合图像和视频参考不是稳定的共享能力表面。每个请求最好只使用一种参考类型。

Fallback 和类型化选项

某些能力检查应用在 fallback 层，而不是工具边界，因此超过主提供商限制的请求仍可在具备能力的 fallback 上运行：

• 当请求包含音频参考时，声明没有 maxInputAudios（或为 0）的活动候选会被跳过；随后尝试下一个候选。相同保护也会针对 maxInputImages/maxInputVideos 应用于图像和视频参考数量。
• 活动候选的 maxDurationSeconds 低于请求的 durationSeconds，且未声明 supportedDurationSeconds 列表 -> 跳过。
• 请求包含 providerOptions，且活动候选明确声明了类型化 providerOptions schema -> 如果提供的键不在 schema 中或值类型不匹配，则跳过。未声明 schema 的提供商会原样接收选项（向后兼容透传）。提供商可以通过声明空 schema（capabilities.providerOptions: {}）选择退出所有提供商选项，这会导致与类型不匹配相同的跳过结果。

请求中的第一个跳过原因会以 warn 记录，让操作员看到其主提供商何时被跳过；后续跳过会以 debug 记录，以免较长的 fallback 链过于嘈杂。如果每个候选都被跳过，聚合错误会包含每个候选的跳过原因。

操作

模型选择

OpenClaw 按以下顺序解析模型：

1. model 工具参数 - 如果智能体在调用中指定了它。
2. 配置中的 videoGenerationModel.primary。
3. 按顺序使用 videoGenerationModel.fallbacks。
4. 自动检测 - 具备有效凭证的提供商，从当前默认提供商开始，然后按字母顺序使用其余提供商。

如果某个提供商失败，会自动尝试下一个候选。如果所有候选都失败，错误会包含每次尝试的详细信息。

设置 agents.defaults.mediaGenerationAutoProviderFallback: false 可仅使用显式的 model、primary 和 fallbacks 条目。

{  agents: {    defaults: {      videoGenerationModel: {        primary: "google/veo-3.1-fast-generate-preview",        fallbacks: ["runway/gen4.5", "qwen/wan2.6-t2v"],        timeoutMs: 180000, // optional per-tool provider request timeout override      },    },  },}

提供商说明

提供商能力模式

共享的视频生成契约支持特定模式的能力， 而不只是扁平的聚合限制。新的提供商实现 应优先使用显式模式块：

capabilities: {  generate: {    maxVideos: 1,    maxDurationSeconds: 10,    supportsResolution: true,  },  imageToVideo: {    enabled: true,    maxVideos: 1,    maxInputImages: 1,    maxInputImagesByModel: { "provider/reference-to-video": 9 },    maxDurationSeconds: 5,  },  videoToVideo: {    enabled: true,    maxVideos: 1,    maxInputVideos: 1,    maxDurationSeconds: 5,  },}

像 maxInputImages 和 maxInputVideos 这样的扁平聚合字段 不足以声明转换模式支持。提供商应 显式声明 generate、imageToVideo 和 videoToVideo，以便实时 测试、契约测试和共享的 video_generate 工具可以确定性地验证 模式支持。

当提供商中的某个模型拥有比其他模型更宽的引用输入支持时， 请使用 maxInputImagesByModel、maxInputVideosByModel 或 maxInputAudiosByModel，而不是提高整个模式的限制。

实时测试

共享内置提供商的可选实时覆盖：

OPENCLAW_LIVE_TEST=1 pnpm test:live -- extensions/video-generation-providers.live.test.ts

仓库封装命令：

pnpm test:live:media video

默认情况下，此实时文件会优先使用已导出的提供商环境变量，而不是存储的凭证 配置文件，并默认运行发布安全的冒烟测试：

• 对扫描中的每个非 FAL 提供商运行 generate。
• 一秒钟的龙虾提示词。
• 每个提供商的操作上限来自 OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS（默认为 180000）。

FAL 是可选项，因为提供商侧队列延迟可能会主导发布 耗时：

pnpm test:live:media video --video-providers fal

设置 OPENCLAW_LIVE_VIDEO_GENERATION_FULL_MODES=1 后，还会运行声明的 转换模式，这些模式是共享扫描可以使用本地媒体安全执行的：

• 当 capabilities.imageToVideo.enabled 时运行 imageToVideo。
• 当 capabilities.videoToVideo.enabled 且 提供商/模型在共享扫描中接受由缓冲区支持的本地视频输入时运行 videoToVideo。

目前，只有在你选择 runway/gen4_aleph 时，共享的 videoToVideo 实时通道才覆盖 runway。

配置

在你的 OpenClaw 配置中设置默认视频生成模型：

{  agents: {    defaults: {      videoGenerationModel: {        primary: "qwen/wan2.6-t2v",        fallbacks: ["qwen/wan2.6-r2v-flash"],      },    },  },}

或通过 CLI 设置：

openclaw config set agents.defaults.videoGenerationModel.primary "qwen/wan2.6-t2v"

相关

• Alibaba Model Studio
• 后台任务 - 异步视频生成的任务跟踪
• BytePlus
• ComfyUI
• 配置参考
• fal
• Google (Gemini)
• MiniMax
• Models
• OpenAI
• Qwen
• Runway
• Together AI
• 工具概览
• Vydra
• xAI