Providers
Alibaba Model Studio
OpenClaw에는 Alibaba Model Studio(DashScope의 국제 이름)의 Wan 모델용 비디오 생성 공급자를 등록하는 번들 alibaba Plugin이 포함되어 있습니다. 이 Plugin은 기본적으로 활성화되어 있으며, API 키만 설정하면 됩니다.
| 속성 | 값 |
|---|---|
| 공급자 ID | alibaba |
| Plugin | 번들, enabledByDefault: true |
| 인증 환경 변수 | MODELSTUDIO_API_KEY → DASHSCOPE_API_KEY → QWEN_API_KEY (첫 번째 일치 항목 사용) |
| 온보딩 플래그 | --auth-choice alibaba-model-studio-api-key |
| 직접 CLI 플래그 | --alibaba-model-studio-api-key <key> |
| 기본 모델 | alibaba/wan2.6-t2v |
| 기본 기본 URL | https://dashscope-intl.aliyuncs.com |
시작하기
API 키 설정
온보딩을 사용하여 alibaba 공급자에 대한 키를 저장합니다.
openclaw onboard --auth-choice alibaba-model-studio-api-key
또는 설치/온보딩 중에 키를 직접 전달합니다.
openclaw onboard --alibaba-model-studio-api-key <your-key>
또는 Gateway를 시작하기 전에 허용되는 환경 변수 중 하나를 내보냅니다.
export MODELSTUDIO_API_KEY=sk-...
# or DASHSCOPE_API_KEY=...
# or QWEN_API_KEY=...
기본 비디오 모델 설정
{
agents: {
defaults: {
videoGenerationModel: {
primary: "alibaba/wan2.6-t2v",
},
},
},
}
공급자가 구성되었는지 확인
openclaw models list --provider alibaba
목록에는 번들 Wan 모델 5개가 모두 포함되어야 합니다. MODELSTUDIO_API_KEY가 확인되지 않으면 openclaw models status --json은 누락된 자격 증명을 auth.unusableProfiles 아래에 보고합니다.
기본 제공 Wan 모델
| 모델 참조 | 모드 |
|---|---|
alibaba/wan2.6-t2v |
텍스트-비디오(기본값) |
alibaba/wan2.6-i2v |
이미지-비디오 |
alibaba/wan2.6-r2v |
참조-비디오 |
alibaba/wan2.6-r2v-flash |
참조-비디오(빠름) |
alibaba/wan2.7-r2v |
참조-비디오 |
기능 및 제한
번들 공급자는 DashScope의 Wan 비디오 API 한도를 반영합니다. 세 가지 모드는 모두 요청당 비디오 수와 길이 한도를 공유하며, 입력 형태만 다릅니다.
| 모드 | 최대 출력 비디오 | 최대 입력 이미지 | 최대 입력 비디오 | 최대 길이 | 지원되는 제어 |
|---|---|---|---|---|---|
| 텍스트-비디오 | 1 | 해당 없음 | 해당 없음 | 10초 | size, aspectRatio, resolution, audio, watermark |
| 이미지-비디오 | 1 | 1 | 해당 없음 | 10초 | size, aspectRatio, resolution, audio, watermark |
| 참조-비디오 | 1 | 해당 없음 | 4 | 10초 | size, aspectRatio, resolution, audio, watermark |
요청에서 durationSeconds를 생략하면 공급자는 DashScope에서 허용하는 기본값인 5초를 보냅니다. 최대 10초까지 늘리려면 비디오 생성 도구에서 durationSeconds를 명시적으로 설정하세요.
고급 구성
DashScope 기본 URL 재정의
공급자는 기본적으로 국제 DashScope 엔드포인트를 사용합니다. 중국 리전 엔드포인트를 대상으로 하려면 다음을 설정하세요.
{
models: {
providers: {
alibaba: {
baseUrl: "https://dashscope.aliyuncs.com",
},
},
},
}
공급자는 AIGC 작업 URL을 구성하기 전에 끝의 슬래시를 제거합니다.
인증 환경 변수 우선순위
OpenClaw는 다음 순서로 환경 변수에서 Alibaba API 키를 확인하며, 비어 있지 않은 첫 번째 값을 사용합니다.
MODELSTUDIO_API_KEYDASHSCOPE_API_KEYQWEN_API_KEY
구성된 auth.profiles 항목(openclaw models auth login을 통해 설정)은 환경 변수 확인을 재정의합니다. 프로필 순환, 쿨다운 및 재정의 메커니즘은 모델 FAQ의 인증 프로필을 참조하세요.
Qwen Plugin과의 관계
두 번들 Plugin은 모두 DashScope와 통신하며 겹치는 API 키를 허용합니다. 다음을 사용하세요.
- 이 페이지에 문서화된 전용 Wan 비디오 공급자를 구동하려면
alibaba/wan*.*ID를 사용합니다. - Qwen 채팅, 임베딩 및 미디어 이해에는
qwen/*ID를 사용합니다(Qwen 참조).
인증 환경 변수 목록이 의도적으로 겹치므로 MODELSTUDIO_API_KEY를 한 번 설정하면 두 Plugin이 모두 인증됩니다. 각 Plugin을 별도로 온보딩할 필요는 없습니다.