런웨이

OpenClaw은 호스팅형 동영상 생성을 위한 번들 runway 제공자와 함께 제공됩니다. 이 제공자는 기본적으로 활성화되며 videoGenerationProviders 계약에 등록됩니다.

속성	값
제공자 ID	`runway`
Plugin	번들, `enabledByDefault: true`
인증 환경 변수	`RUNWAYML_API_SECRET`(표준) 또는 `RUNWAY_API_KEY`
온보딩 플래그	`--auth-choice runway-api-key`
직접 CLI 플래그	`--runway-api-key <key>`
API	Runway 작업 기반 동영상 생성(`GET /v1/tasks/{id}` 폴링)
기본 모델	`runway/gen4.5`

시작하기

API 키 설정

openclaw onboard --auth-choice runway-api-key

Runway를 기본 동영상 제공자로 설정

openclaw config set agents.defaults.videoGenerationModel.primary "runway/gen4.5"

동영상 생성

에이전트에게 동영상을 생성하도록 요청합니다. Runway가 자동으로 사용됩니다.

지원되는 모드 및 모델

이 제공자는 세 가지 모드에 걸쳐 일곱 개의 Runway 모델을 제공합니다. 동일한 모델 ID를 둘 이상의 모드에서 사용할 수 있습니다(예: gen4.5는 텍스트-동영상 변환과 이미지-동영상 변환 모두에서 작동합니다).

모드	모델	참조 입력
텍스트-동영상 변환	`gen4.5`(기본값), `veo3.1`, `veo3.1_fast`, `veo3`	없음
이미지-동영상 변환	`gen4.5`, `gen4_turbo`, `gen3a_turbo`, `veo3.1`, `veo3.1_fast`, `veo3`	로컬 또는 원격 이미지 1개
동영상-동영상 변환	`gen4_aleph`	로컬 또는 원격 동영상 1개

데이터 URI를 통해 로컬 이미지 및 동영상 참조를 지원합니다.

종횡비	허용되는 값
텍스트-동영상 변환	`16:9`, `9:16`
이미지 및 동영상 편집	`1:1`, `16:9`, `9:16`, `3:4`, `4:3`, `21:9`

현재 동영상-동영상 변환에는 runway/gen4_aleph가 필요합니다. 다른 Runway 모델 ID는 동영상 참조 입력을 거부합니다.

잘못된 열에서 Runway 모델 ID를 선택하면 API 요청이 OpenClaw을 벗어나기 전에 명시적인 오류가 발생합니다. 제공자는 extensions/runway/video-generation-provider.ts에서 모드의 허용 목록(TEXT_ONLY_MODELS, IMAGE_MODELS, VIDEO_MODELS)을 기준으로 model을 검증합니다.

구성

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "runway/gen4.5",
      },
    },
  },
}

고급 구성

환경 변수 별칭

OpenClaw은 RUNWAYML_API_SECRET(표준)과 RUNWAY_API_KEY를 모두 인식합니다. 두 변수 중 하나로 Runway 제공자를 인증할 수 있습니다.

작업 폴링

Runway는 작업 기반 API를 사용합니다. 생성 요청을 제출한 후 OpenClaw은 동영상이 준비될 때까지 GET /v1/tasks/{id}를 폴링합니다. 폴링 동작을 위한 추가 구성은 필요하지 않습니다.

동영상 생성

공통 도구 매개변수, 제공자 선택 및 비동기 동작입니다.

구성 참조

동영상 생성 모델을 포함한 에이전트 기본 설정입니다.

Overview

Concepts and configuration

Providers

시작하기

지원되는 모드 및 모델

구성

고급 구성

관련 항목

동영상 생성

구성 참조

​시작하기

​지원되는 모드 및 모델

​구성

​고급 구성

​관련 항목

동영상 생성

구성 참조

시작하기

지원되는 모드 및 모델

구성

고급 구성

관련 항목