Providers

Qwen

OpenClaw은 이제 Qwen을 정식 provider Plugin으로 취급하며 canonical id는 qwen입니다. 이 provider Plugin은 Qwen Cloud / Alibaba DashScope와 Coding Plan 엔드포인트를 대상으로 하며, 레거시 modelstudio id가 호환성 alias로 계속 동작하도록 유지하고, Qwen Portal 토큰 흐름도 provider qwen-oauth로 노출합니다.

Provider: qwen
Portal provider: qwen-oauth
권장 env var: QWEN_API_KEY
호환성을 위해 함께 허용됨: MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
API 스타일: OpenAI 호환

Plugin 설치

공식 Plugin을 설치한 다음 Gateway를 다시 시작하세요.

bash

openclaw plugins install @openclaw/qwen-provideropenclaw gateway restart

시작하기

플랜 유형을 선택하고 설정 단계를 따르세요.

Coding Plan (subscription)

적합한 용도: Qwen Coding Plan을 통한 구독 기반 액세스.

Get your API key

home.qwencloud.com/api-keys에서 API 키를 만들거나 복사하세요.

Run onboarding

Global 엔드포인트의 경우:

bash

openclaw onboard --auth-choice qwen-api-key

China 엔드포인트의 경우:

bash

openclaw onboard --auth-choice qwen-api-key-cn

Set a default model

json5

{  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}

Verify the model is available

bash

openclaw models list --provider qwen

Standard (pay-as-you-go)

적합한 용도: Coding Plan에서 제공되지 않을 수 있는 qwen3.6-plus 같은 모델을 포함해 Standard Model Studio 엔드포인트를 통한 종량제 액세스.

Get your API key

home.qwencloud.com/api-keys에서 API 키를 만들거나 복사하세요.

Run onboarding

Global 엔드포인트의 경우:

bash

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

China 엔드포인트의 경우:

bash

openclaw onboard --auth-choice qwen-standard-api-key-cn

Set a default model

json5

{  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}

Verify the model is available

bash

openclaw models list --provider qwen

Qwen OAuth / Portal

적합한 용도: https://portal.qwen.ai/v1에 대한 Qwen Portal 토큰.

전용 provider 페이지와 마이그레이션 참고 사항은 Qwen OAuth / Portal을 참조하세요.

Provide your portal token

bash

openclaw onboard --auth-choice qwen-oauth

Set a default model

json5

{  agents: {    defaults: {      model: { primary: "qwen-oauth/qwen3.5-plus" },    },  },}

Verify the model is available

bash

openclaw models list --provider qwen-oauth

플랜 유형 및 엔드포인트

플랜	리전	Auth choice	엔드포인트
Standard(종량제)	China	`qwen-standard-api-key-cn`	`dashscope.aliyuncs.com/compatible-mode/v1`
Standard(종량제)	Global	`qwen-standard-api-key`	`dashscope-intl.aliyuncs.com/compatible-mode/v1`
Coding Plan(구독)	China	`qwen-api-key-cn`	`coding.dashscope.aliyuncs.com/v1`
Coding Plan(구독)	Global	`qwen-api-key`	`coding-intl.dashscope.aliyuncs.com/v1`
Qwen Portal	Global	`qwen-oauth`	`portal.qwen.ai/v1`

provider는 auth choice에 따라 엔드포인트를 자동으로 선택합니다. Canonical choice는 qwen-* 계열을 사용하며, modelstudio-*는 호환성 전용으로 유지됩니다. config에서 custom baseUrl로 재정의할 수 있습니다.

기본 제공 catalog

OpenClaw은 현재 이 Qwen 정적 catalog를 제공합니다. 구성된 catalog는 엔드포인트를 인식합니다. Coding Plan config는 Standard 엔드포인트에서만 동작하는 것으로 알려진 모델을 제외합니다.

Model ref	입력	Context	참고
`qwen/qwen3.5-plus`	텍스트, 이미지	1,000,000	기본 모델
`qwen/qwen3.6-plus`	텍스트, 이미지	1,000,000	이 모델이 필요하면 Standard 엔드포인트를 우선 사용
`qwen/qwen3-max-2026-01-23`	텍스트	262,144	Qwen Max 계열
`qwen/qwen3-coder-next`	텍스트	262,144	코딩
`qwen/qwen3-coder-plus`	텍스트	1,000,000	코딩
`qwen/MiniMax-M2.5`	텍스트	1,000,000	추론 활성화
`qwen/glm-5`	텍스트	202,752	GLM
`qwen/glm-4.7`	텍스트	202,752	GLM
`qwen/kimi-k2.5`	텍스트, 이미지	262,144	Alibaba를 통한 Moonshot AI
`qwen-oauth/qwen3.5-plus`	텍스트, 이미지	1,000,000	Qwen Portal 기본값

Thinking 제어

추론이 활성화된 Qwen Cloud 모델의 경우, provider는 OpenClaw thinking 수준을 DashScope의 최상위 enable_thinking 요청 플래그에 매핑합니다. 비활성화된 thinking은 enable_thinking: false를 보내고, 다른 thinking 수준은 enable_thinking: true를 보냅니다.

멀티모달 추가 기능

qwen Plugin은 Standard DashScope 엔드포인트에서도 멀티모달 기능을 노출합니다 (Coding Plan 엔드포인트 제외).

qwen-vl-max-latest를 통한 비디오 이해
wan2.6-t2v(기본값), wan2.6-i2v, wan2.6-r2v, wan2.6-r2v-flash, wan2.7-r2v를 통한 Wan 비디오 생성

Qwen을 기본 비디오 provider로 사용하려면:

json5

{  agents: {    defaults: {      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },    },  },}

고급 구성

Image and video understanding

Qwen Plugin은 Standard DashScope 엔드포인트에서 이미지와 비디오에 대한 미디어 이해를 등록합니다(Coding Plan 엔드포인트 제외).

속성	값
모델	`qwen-vl-max-latest`
지원 입력	이미지, 비디오

미디어 이해는 구성된 Qwen auth에서 자동으로 해석되므로 추가 config가 필요하지 않습니다. 미디어 이해 지원을 위해 Standard(종량제) 엔드포인트를 사용하고 있는지 확인하세요.

Qwen 3.6 Plus availability

qwen3.6-plus는 Standard(종량제) Model Studio 엔드포인트에서 사용할 수 있습니다.

China: dashscope.aliyuncs.com/compatible-mode/v1
Global: dashscope-intl.aliyuncs.com/compatible-mode/v1

Coding Plan 엔드포인트가 qwen3.6-plus에 대해 "unsupported model" 오류를 반환하면 Coding Plan 엔드포인트/키 쌍 대신 Standard(종량제)로 전환하세요.

OpenClaw의 Qwen 정적 catalog는 Coding Plan 엔드포인트에서 qwen3.6-plus를 표시하지 않지만, models.providers.qwen.models 아래에 명시적으로 구성된 qwen/qwen3.6-plus 항목은 Coding Plan baseUrl에서도 존중되므로, Aliyun이 사용자의 구독에서 해당 모델을 활성화한 경우 opt-in할 수 있습니다. 호출 성공 여부는 여전히 upstream API가 결정합니다.

Capability plan

qwen Plugin은 단순한 코딩/텍스트 모델이 아니라 전체 Qwen Cloud 표면을 위한 공급업체 홈으로 자리 잡는 중입니다.

텍스트/채팅 모델: Plugin을 통해 사용 가능
도구 호출, 구조화된 출력, thinking: OpenAI 호환 transport에서 상속
이미지 생성: provider-Plugin 계층에서 계획됨
이미지/비디오 이해: Standard 엔드포인트의 Plugin을 통해 사용 가능
음성/오디오: provider-Plugin 계층에서 계획됨
메모리 임베딩/reranking: 임베딩 adapter 표면을 통해 계획됨
비디오 생성: 공유 비디오 생성 기능을 통해 Plugin에서 사용 가능

Video generation details

비디오 생성의 경우, OpenClaw은 작업을 제출하기 전에 구성된 Qwen 리전을 일치하는 DashScope AIGC 호스트에 매핑합니다.

Global/Intl: https://dashscope-intl.aliyuncs.com
China: https://dashscope.aliyuncs.com

즉, Coding Plan 또는 Standard Qwen 호스트 중 하나를 가리키는 일반 models.providers.qwen.baseUrl도 비디오 생성을 올바른 리전별 DashScope 비디오 엔드포인트에 유지합니다.

현재 Qwen 비디오 생성 제한:

요청당 출력 비디오는 최대 1개
입력 이미지는 최대 1개
입력 비디오는 최대 4개
지속 시간은 최대 10초
size, aspectRatio, resolution, audio, watermark 지원
참조 이미지/비디오 모드는 현재 원격 http(s) URL이 필요합니다. DashScope 비디오 엔드포인트가 해당 참조용으로 업로드된 로컬 버퍼를 허용하지 않기 때문에 로컬 파일 경로는 사전에 거부됩니다.

스트리밍 사용량 호환성

네이티브 Model Studio 엔드포인트는 공유 openai-completions 전송에서 스트리밍 사용량 호환성을 알립니다. 이제 OpenClaw는 이를 엔드포인트 기능을 기준으로 판단하므로, 동일한 네이티브 호스트를 대상으로 하는 DashScope 호환 사용자 지정 공급자 ID는 기본 제공 qwen 공급자 ID를 특별히 요구하지 않고도 동일한 스트리밍 사용량 동작을 상속합니다.

네이티브 스트리밍 사용량 호환성은 Coding Plan 호스트와 Standard DashScope 호환 호스트 모두에 적용됩니다.

https://coding.dashscope.aliyuncs.com/v1
https://coding-intl.dashscope.aliyuncs.com/v1
https://dashscope.aliyuncs.com/compatible-mode/v1
https://dashscope-intl.aliyuncs.com/compatible-mode/v1

멀티모달 엔드포인트 리전

멀티모달 표면(동영상 이해 및 Wan 동영상 생성)은 Coding Plan 엔드포인트가 아니라 Standard DashScope 엔드포인트를 사용합니다.

글로벌/Intl Standard 기본 URL: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
중국 Standard 기본 URL: https://dashscope.aliyuncs.com/compatible-mode/v1

환경 및 데몬 설정

Gateway가 데몬(launchd/systemd)으로 실행되는 경우, QWEN_API_KEY가 해당 프로세스에서 사용할 수 있는지 확인하세요(예: ~/.openclaw/.env 또는 env.shellEnv를 통해).

Qwen

Plugin 설치

시작하기

Coding Plan (subscription)

Get your API key

Run onboarding

Set a default model

Verify the model is available

Standard (pay-as-you-go)

Get your API key

Run onboarding

Set a default model

Verify the model is available

Qwen OAuth / Portal

Provide your portal token

Set a default model

Verify the model is available

플랜 유형 및 엔드포인트

기본 제공 catalog

Thinking 제어

멀티모달 추가 기능

고급 구성

관련 항목

On this page

Molty