​

비디오 생성

• 참조 미디어가 없는 텍스트-비디오 요청용 generate
• 요청에 하나 이상의 참조 이미지가 포함될 때의 imageToVideo
• 요청에 하나 이상의 참조 비디오가 포함될 때의 videoToVideo

​

빠른 시작

1. 지원되는 provider 중 하나의 API 키를 설정합니다.

export GEMINI_API_KEY="your-key"

2. 선택적으로 기본 모델을 고정합니다.

openclaw config set agents.defaults.videoGenerationModel.primary "google/veo-3.1-fast-generate-preview"

3. 에이전트에게 요청합니다.

석양 속에서 친근한 바닷가재가 서핑하는 5초짜리 영화 같은 비디오를 생성해줘.

​

비디오를 생성할 때 일어나는 일

1. OpenClaw는 요청을 provider에 제출하고 즉시 작업 ID를 반환합니다.
2. provider는 백그라운드에서 작업을 처리합니다(일반적으로 provider와 해상도에 따라 30초에서 5분).
3. 비디오가 준비되면 OpenClaw는 내부 완료 이벤트로 같은 세션을 다시 깨웁니다.
4. 에이전트는 완성된 비디오를 원래 대화에 다시 게시합니다.

​

작업 수명 주기

1. queued — 작업이 생성되었고, provider가 수락하기를 기다리는 중입니다.
2. running — provider가 처리 중입니다(일반적으로 provider와 해상도에 따라 30초에서 5분).
3. succeeded — 비디오가 준비되었고, 에이전트가 깨어나 대화에 게시합니다.
4. failed — provider 오류 또는 시간 초과가 발생했으며, 에이전트가 오류 세부 정보와 함께 깨어납니다.

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

​

지원되는 provider

​

선언된 기능 매트릭스

​

도구 매개변수

​

필수

​

콘텐츠 입력

​

스타일 제어

​

고급

• 참조 미디어 없음: generate
• 이미지 참조가 하나라도 있으면: imageToVideo
• 비디오 참조가 하나라도 있으면: videoToVideo

​

작업

• generate (기본값) — 지정된 프롬프트와 선택적 참조 입력으로 비디오를 생성합니다.
• status — 새 생성을 시작하지 않고 현재 세션의 진행 중인 비디오 작업 상태를 확인합니다.
• list — 사용 가능한 provider, 모델 및 해당 기능을 표시합니다.

​

모델 선택

1. model 도구 매개변수 — 에이전트가 호출에서 지정한 경우
2. videoGenerationModel.primary — config에서
3. videoGenerationModel.fallbacks — 순서대로 시도
4. 자동 감지 — 현재 기본 provider부터 시작한 뒤 나머지 provider를 알파벳순으로 시도하며, 유효한 인증이 있는 provider를 사용

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

​

provider 참고

​

provider 기능 모드

capabilities: {
  generate: {
    maxVideos: 1,
    maxDurationSeconds: 10,
    supportsResolution: true,
  },
  imageToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputImages: 1,
    maxDurationSeconds: 5,
  },
  videoToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputVideos: 1,
    maxDurationSeconds: 5,
  },
}

​

라이브 테스트

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

pnpm test:live:media video

• 스윕의 모든 provider에 대한 generate
• capabilities.imageToVideo.enabled일 때 imageToVideo
• capabilities.videoToVideo.enabled이고 provider/모델이 공유 스윕에서 버퍼 기반 로컬 비디오 입력을 수용할 때 videoToVideo

• runway/gen4_aleph를 선택했을 때의 runway만

​

구성

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

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
• 구성 참조
• 모델