OpenClaw 한국어 문서

Appearance

OpenClaw는 Alibaba Model Studio / DashScope에서 Wan 모델을 사용하기 위한 번들 alibaba 영상 생성 프로바이더를 제공합니다.

  • 프로바이더: alibaba
  • 선호 인증: MODELSTUDIO_API_KEY
  • 허용되는 추가 인증: DASHSCOPE_API_KEY, QWEN_API_KEY
  • API: DashScope / Model Studio 비동기 영상 생성

시작하기 ​

  1. API 키 설정

    bash
        openclaw onboard --auth-choice qwen-standard-api-key
    ```

  2. 기본 영상 모델 설정

json5
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "alibaba/wan2.6-t2v",
          },
        },
      },
    }
    ```

3. **프로바이더가 사용 가능한지 확인**

```bash
    openclaw models list --provider alibaba
    ```


::: info NOTE
허용되는 인증 키(`MODELSTUDIO_API_KEY`, `DASHSCOPE_API_KEY`, `QWEN_API_KEY`) 중 어느 것이든 동작합니다. `qwen-standard-api-key` 온보딩 선택지는 공유 DashScope 자격증명을 구성합니다.
:::


## 내장 Wan 모델

번들 `alibaba` 프로바이더는 현재 다음을 등록합니다.

| 모델 ref                   | 모드                       |
| -------------------------- | -------------------------- |
| `alibaba/wan2.6-t2v`       | Text-to-video              |
| `alibaba/wan2.6-i2v`       | Image-to-video             |
| `alibaba/wan2.6-r2v`       | Reference-to-video         |
| `alibaba/wan2.6-r2v-flash` | Reference-to-video (고속)  |
| `alibaba/wan2.7-r2v`       | Reference-to-video         |

## 현재 제한

| 파라미터              | 제한                                                          |
| --------------------- | ------------------------------------------------------------- |
| 출력 영상             | 요청당 최대 **1**개                                           |
| 입력 이미지           | 최대 **1**개                                                  |
| 입력 영상             | 최대 **4**개                                                  |
| 길이                  | 최대 **10초**                                                 |
| 지원 컨트롤           | `size`, `aspectRatio`, `resolution`, `audio`, `watermark`     |
| 레퍼런스 이미지/영상  | 원격 `http(s)` URL만 지원                                     |

::: warning
레퍼런스 이미지/영상 모드는 현재 **원격 http(s) URL**만 요구합니다. 레퍼런스 입력에는 로컬 파일 경로가 지원되지 않습니다.
:::


## 고급 설정

::: details Qwen과의 관계
번들 `qwen` 프로바이더 또한 Wan 영상 생성을 위해 Alibaba 호스팅 DashScope
 엔드포인트를 사용합니다. 다음과 같이 사용하세요.

 - 정식 Qwen 프로바이더 표면을 원하면 `qwen/...`
 - 벤더 직속 Wan 영상 표면을 원하면 `alibaba/...`

 자세한 내용은 [Qwen 프로바이더 문서](/providers/qwen)를 참고하세요.
:::


::: details 인증 키 우선순위
OpenClaw는 다음 순서로 인증 키를 확인합니다.

 1. `MODELSTUDIO_API_KEY` (선호)
 2. `DASHSCOPE_API_KEY`
 3. `QWEN_API_KEY`

 이 중 어느 것이든 `alibaba` 프로바이더를 인증합니다.
:::

## 관련 문서

> **영상 생성** [→](/tools/video-generation)
> 공유 영상 도구 파라미터와 프로바이더 선택.


> **Qwen** [→](/providers/qwen)
> Qwen 프로바이더 설정과 DashScope 연동.


> **설정 레퍼런스** [→](/gateway/config-agents#agent-defaults)
> 에이전트 기본값과 모델 설정.