Runway Provider
기준일: 2026-07-26
난이도: 중급
공식 기준: Runway
개요
이 페이지는 OpenClaw Runway provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.
공식 요약: Runway video generation setup in OpenClaw
model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.
빠른 참조
| Property | Value |
|---|---|
| Provider id | runway |
| Plugin | bundled, enabledByDefault: true |
| Auth env vars | RUNWAYML_API_SECRET (canonical) or RUNWAY_API_KEY |
| Onboarding flag | --auth-choice runway-api-key |
| Direct CLI flag | --runway-api-key <key> |
| API | Runway task-based video generation (GET /v1/tasks/{id} polling) |
| Default model | runway/gen4.5 |
공식 문서 기반 상세
아래는 공식 providers/runway 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.
OpenClaw ships a bundled runway provider for hosted video generation, enabled by default, registered against the videoGenerationProviders contract.
| Property | Value |
|---|---|
| Provider id | runway |
| Plugin | bundled, enabledByDefault: true |
| Auth env vars | RUNWAYML_API_SECRET (canonical) or RUNWAY_API_KEY |
| Onboarding flag | --auth-choice runway-api-key |
| Direct CLI flag | --runway-api-key <key> |
| API | Runway task-based video generation (GET /v1/tasks/{id} polling) |
| Default model | runway/gen4.5 |
시작하기
Set the API key
```bash
openclaw onboard --auth-choice runway-api-key
```
Set Runway as the default video provider
```bash
openclaw config set agents.defaults.mediaModels.video.primary "runway/gen4.5"
```
Generate a video
Ask the agent to generate a video. Runway will be used automatically.
Supported modes and models
The provider exposes seven Runway models split across three modes. The same model id can serve more than one mode (for example gen4.5 works for both text-to-video and image-to-video).
| Mode | Models | Reference input |
|---|---|---|
| Text-to-video | gen4.5 (default), veo3.1, veo3.1_fast, veo3 |
None |
| Image-to-video | gen4.5, gen4_turbo, gen3a_turbo, veo3.1, veo3.1_fast, veo3 |
1 local or remote image |
| Video-to-video | gen4_aleph |
1 local or remote video |
Local image and video references are supported via data URIs.
| Aspect ratios | Allowed values |
|---|---|
| Text-to-video | 16:9, 9:16 |
| Image and video edits | 1:1, 16:9, 9:16, 3:4, 4:3, 21:9 |
Video-to-video currently requires
runway/gen4_aleph. Other Runway model ids reject video reference inputs.
Picking a Runway model id from the wrong column produces an explicit error before the API request leaves OpenClaw. The provider validates
modelagainst the mode's allowlist (TEXT_ONLY_MODELS,IMAGE_MODELS,VIDEO_MODELS) inextensions/runway/video-generation-provider.ts.
설정
{
agents: {
defaults: {
videoGenerationModel: {
primary: "runway/gen4.5",
},
},
},
}
고급 설정
Environment variable aliases
OpenClaw recognizes both `RUNWAYML_API_SECRET` (canonical) and `RUNWAY_API_KEY`.
Either variable authenticates the Runway provider.
Task polling
Runway uses a task-based API. After submitting a generation request, OpenClaw
polls `GET /v1/tasks/{id}` until the video is ready. No additional
configuration is needed for the polling behavior.
관련 문서
Shared tool parameters, provider selection, and async behavior.
Agent default settings including video generation model.
검증 체크리스트
-
openclaw models list --provider runway로 모델이 보이는지 확인 - 기본 model alias를
agents.defaults.model.primary에 설정했는지 확인 - API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
- failover 시 데이터가 다른 provider로 이동할 수 있는지 검토