Генерация видео

"status" возвращает текущую задачу сессии; "list" проверяет провайдеров.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InRpbWVvdXRNcyIgdHlwZT0ibnVtYmVyIg Необязательный тайм-аут операции провайдера в миллисекундах. Если он не указан, OpenClaw использует agents.defaults.videoGenerationModel.timeoutMs, если настроено, иначе значение провайдера по умолчанию, заданное Plugin, когда оно существует. OPENCLAW_DOCS_MARKER:paramClose:

Референсные входные данные выбирают режим выполнения:

• Нет референсных медиа → generate
• Любой референс изображения → imageToVideo
• Любой референс видео → videoToVideo
• Референсные аудиовходы не меняют разрешенный режим; они применяются поверх того режима, который выбирают референсы изображения/видео, и работают только с провайдерами, объявляющими maxInputAudios.

Смешанные референсы изображений и видео не являются стабильной общей поверхностью возможностей. Предпочитайте один тип референса на запрос.

Fallback и типизированные параметры

Некоторые проверки возможностей применяются на слое fallback, а не на границе инструмента, поэтому запрос, превышающий ограничения основного провайдера, все еще может выполниться на подходящем fallback:

• Активный кандидат, не объявляющий maxInputAudios (или объявляющий 0), пропускается, когда запрос содержит аудиореференсы; пробуется следующий кандидат.
• maxDurationSeconds активного кандидата ниже запрошенного durationSeconds и список supportedDurationSeconds не объявлен → пропускается.
• Запрос содержит providerOptions, а активный кандидат явно объявляет типизированную схему providerOptions → пропускается, если переданные ключи отсутствуют в схеме или типы значений не совпадают. Провайдеры без объявленной схемы получают параметры как есть (обратно совместимая сквозная передача). Провайдер может отказаться от всех параметров провайдера, объявив пустую схему (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"],      },    },  },}

Примечания по провайдерам

Режимы возможностей провайдера

Общий контракт генерации видео поддерживает возможности, специфичные для режима, а не только плоские агрегированные лимиты. Новым реализациям провайдеров следует предпочитать явные блоки режимов:

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

Этот файл живых тестов по умолчанию использует уже экспортированные env vars провайдеров перед сохраненными профилями авторизации и по умолчанию запускает безопасный для релиза smoke-тест:

• generate для каждого провайдера не из FAL в проверке.
• Односекундный prompt с лобстером.
• Лимит операций для каждого провайдера из OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS (180000 по умолчанию).

FAL включается отдельно, потому что задержка очереди на стороне провайдера может доминировать во времени релиза:

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

Задайте OPENCLAW_LIVE_VIDEO_GENERATION_FULL_MODES=1, чтобы также запускать объявленные режимы преобразования, которые общий проход может безопасно выполнить с локальными медиа:

• imageToVideo, когда capabilities.imageToVideo.enabled.
• videoToVideo, когда capabilities.videoToVideo.enabled и провайдер/модель принимает локальный видеовход на основе буфера в общем проходе.

Сегодня общий живой lane videoToVideo покрывает только runway, когда вы выбираете runway/gen4_aleph.

Конфигурация

Задайте модель генерации видео по умолчанию в конфигурации 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
• Модели
• OpenAI
• Qwen
• Runway
• Together AI
• Обзор инструментов
• Vydra
• xAI