메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw는 호스팅 비디오 생성을 위한 번들 runway 공급자를 제공합니다. 이 Plugin은 기본적으로 활성화되어 있으며 videoGenerationProviders 계약에 대해 runway 공급자를 등록합니다.
속성값
공급자 idrunway
Plugin번들, enabledByDefault: true
인증 환경 변수RUNWAYML_API_SECRET(표준) 또는 RUNWAY_API_KEY
온보딩 플래그--auth-choice runway-api-key
직접 CLI 플래그--runway-api-key <key>
APIRunway 작업 기반 비디오 생성(GET /v1/tasks/{id} 폴링)
기본 모델runway/gen4.5

​
시작하기

1

API 키 설정

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

Runway를 기본 비디오 공급자로 설정

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

비디오 생성

에이전트에게 비디오 생성을 요청하세요. 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에서 model을 모드의 허용 목록(TEXT_ONLY_MODELS, IMAGE_MODELS, VIDEO_MODELS)과 대조하여 검증합니다.

​
구성

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

​
고급 구성

OpenClaw는 RUNWAYML_API_SECRET(표준)과 RUNWAY_API_KEY를 모두 인식합니다. 두 변수 중 하나로 Runway 공급자를 인증할 수 있습니다.
Runway는 작업 기반 API를 사용합니다. 생성 요청을 제출한 뒤 OpenClaw는 비디오가 준비될 때까지 GET /v1/tasks/{id}를 폴링합니다. 폴링 동작에는 추가 구성이 필요하지 않습니다.

​
관련 항목

비디오 생성

공유 도구 매개변수, 공급자 선택, 비동기 동작입니다.

구성 참조

비디오 생성 모델을 포함한 에이전트 기본 설정입니다.