> ## 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` 공급자를 등록합니다.

| 속성         | 값                                             |
| ---------- | --------------------------------------------- |
| 공급자 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`                               |

## 시작하기

<Steps>
  <Step title="API 키 설정">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --auth-choice runway-api-key
    ```
  </Step>

  <Step title="Runway를 기본 비디오 공급자로 설정">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw config set agents.defaults.videoGenerationModel.primary "runway/gen4.5"
    ```
  </Step>

  <Step title="비디오 생성">
    에이전트에게 비디오 생성을 요청하세요. Runway가 자동으로 사용됩니다.
  </Step>
</Steps>

## 지원되는 모드 및 모델

이 공급자는 세 가지 모드로 나뉜 일곱 개의 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` |

<Warning>
  비디오-비디오는 현재 `runway/gen4_aleph`가 필요합니다. 다른 Runway 모델 id는 비디오 참조 입력을 거부합니다.
</Warning>

<Note>
  잘못된 열에서 Runway 모델 id를 선택하면 API 요청이 OpenClaw를 떠나기 전에 명시적인 오류가 발생합니다. 공급자는 `extensions/runway/video-generation-provider.ts`에서 `model`을 모드의 허용 목록(`TEXT_ONLY_MODELS`, `IMAGE_MODELS`, `VIDEO_MODELS`)과 대조하여 검증합니다.
</Note>

## 구성

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "runway/gen4.5",
      },
    },
  },
}
```

## 고급 구성

<AccordionGroup>
  <Accordion title="환경 변수 별칭">
    OpenClaw는 `RUNWAYML_API_SECRET`(표준)과 `RUNWAY_API_KEY`를 모두 인식합니다.
    두 변수 중 하나로 Runway 공급자를 인증할 수 있습니다.
  </Accordion>

  <Accordion title="작업 폴링">
    Runway는 작업 기반 API를 사용합니다. 생성 요청을 제출한 뒤 OpenClaw는
    비디오가 준비될 때까지 `GET /v1/tasks/{id}`를 폴링합니다. 폴링 동작에는 추가
    구성이 필요하지 않습니다.
  </Accordion>
</AccordionGroup>

## 관련 항목

<CardGroup cols={2}>
  <Card title="비디오 생성" href="/ko/tools/video-generation" icon="video">
    공유 도구 매개변수, 공급자 선택, 비동기 동작입니다.
  </Card>

  <Card title="구성 참조" href="/ko/gateway/config-agents#agent-defaults" icon="gear">
    비디오 생성 모델을 포함한 에이전트 기본 설정입니다.
  </Card>
</CardGroup>