동영상 생성

"status"는 현재 세션 작업을 반환하고, "list"는 제공자를 검사합니다.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InRpbWVvdXRNcyIgdHlwZT0ibnVtYmVyIg 선택적 제공자 작업 제한 시간(밀리초)입니다. 생략하면 OpenClaw는 구성된 경우 agents.defaults.videoGenerationModel.timeoutMs를 사용하고, 그렇지 않으면 존재할 때 Plugin 작성 제공자 기본값을 사용합니다. OPENCLAW_DOCS_MARKER:paramClose:

참조 입력은 런타임 모드를 선택합니다.

• 참조 미디어 없음 → generate
• 이미지 참조 있음 → imageToVideo
• 비디오 참조 있음 → videoToVideo
• 참조 오디오 입력은 해석된 모드를 변경하지 않습니다. 이미지/비디오 참조가 선택한 모드 위에 적용되며, maxInputAudios를 선언한 제공자에서만 작동합니다.

이미지와 비디오 참조를 혼합하는 것은 안정적인 공유 기능 표면이 아닙니다. 요청당 하나의 참조 유형을 사용하는 것이 좋습니다.

폴백 및 타입 지정 옵션

일부 기능 검사는 도구 경계가 아니라 폴백 계층에서 적용되므로, 기본 제공자의 제한을 초과하는 요청도 기능을 갖춘 폴백에서 계속 실행될 수 있습니다.

• 요청에 오디오 참조가 포함된 경우 maxInputAudios를 선언하지 않았거나 0으로 선언한 활성 후보는 건너뛰고 다음 후보를 시도합니다.
• 활성 후보의 maxDurationSeconds가 요청된 durationSeconds보다 낮고 선언된 supportedDurationSeconds 목록이 없으면 건너뜁니다.
• 요청에 providerOptions가 포함되어 있고 활성 후보가 타입이 지정된 providerOptions 스키마를 명시적으로 선언하면, 제공된 키가 스키마에 없거나 값 타입이 일치하지 않을 때 건너뜁니다. 선언된 스키마가 없는 제공자는 옵션을 있는 그대로 받습니다(이전 버전과 호환되는 패스스루). 제공자는 빈 스키마(capabilities.providerOptions: {})를 선언하여 모든 제공자 옵션을 거부할 수 있으며, 이 경우 타입 불일치와 동일하게 건너뜁니다.

요청의 첫 번째 건너뛰기 이유는 warn으로 로깅되어 운영자가 기본 제공자가 건너뛰어졌음을 확인할 수 있습니다. 이후 건너뛰기는 긴 폴백 체인을 조용하게 유지하기 위해 debug로 로깅됩니다. 모든 후보를 건너뛰면 집계된 오류에 각 후보의 건너뛰기 이유가 포함됩니다.

작업

모델 선택

OpenClaw는 다음 순서로 모델을 해석합니다.

1. model 도구 매개변수 - 에이전트가 호출에서 지정한 경우.
2. 구성의 videoGenerationModel.primary.
3. 순서대로 videoGenerationModel.fallbacks.
4. 자동 감지 - 현재 기본 제공자부터 시작한 뒤 나머지 제공자를 알파벳 순서로, 유효한 인증을 가진 제공자.

제공자가 실패하면 다음 후보를 자동으로 시도합니다. 모든 후보가 실패하면 오류에 각 시도의 세부 정보가 포함됩니다.

명시적 model, primary, fallbacks 항목만 사용하려면 agents.defaults.mediaGenerationAutoProviderFallback: false를 설정하세요.

{  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 같은 평면 집계 필드만으로는 변환 모드 지원을 알리기에 충분하지 않습니다. 제공자는 라이브 테스트, 계약 테스트, 공유 video_generate 도구가 모드 지원을 결정론적으로 검증할 수 있도록 generate, imageToVideo, videoToVideo를 명시적으로 선언해야 합니다.

제공자의 한 모델이 나머지보다 더 넓은 참조 입력 지원을 제공하는 경우, 모드 전체 제한을 높이는 대신 maxInputImagesByModel, maxInputVideosByModel 또는 maxInputAudiosByModel을 사용하세요.

라이브 테스트

공유 번들 제공자에 대한 옵트인 라이브 적용 범위:

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

저장소 래퍼:

pnpm test:live:media video

이 라이브 파일은 기본적으로 저장된 인증 프로필보다 이미 내보낸 제공자 환경 변수를 우선 사용하며, 기본적으로 릴리스에 안전한 스모크를 실행합니다.

• 스윕의 모든 비 FAL 제공자에 대한 generate.
• 1초짜리 바닷가재 프롬프트.
• 제공자별 작업 상한은 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.

현재 공유 videoToVideo 라이브 레인은 runway/gen4_aleph를 선택한 경우에만 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
• 모델
• OpenAI
• Qwen
• Runway
• Together AI
• 도구 개요
• Vydra
• xAI