Qwen

Qwen Cloud는 정식 외부 OpenClaw 제공자 Plugin이며 정식 ID는 qwen입니다. Qwen Cloud / Alibaba DashScope Standard 및 Coding Plan 엔드포인트를 대상으로 하고, Token Plan을 qwen-token-plan으로 제공하며, modelstudio를 호환성 별칭으로 유지합니다. 또한 Alibaba가 문서화한 bailian-token-plan 사용자 지정 제공자 ID를 독립적으로 소유하고, Qwen Portal 토큰 흐름을 qwen-oauth로 제공합니다.

속성	값
제공자	`qwen`
Token Plan 제공자	`qwen-token-plan`
Portal 제공자	`qwen-oauth`
권장 환경 변수	`QWEN_API_KEY`
Token Plan 환경 변수	`QWEN_TOKEN_PLAN_API_KEY`
추가 허용 항목(호환성)	`MODELSTUDIO_API_KEY`, `DASHSCOPE_API_KEY`
API 방식	OpenAI 호환

qwen3.7-plus와 qwen3.6-plus는 Coding Plan 및 Standard 엔드포인트에서 작동합니다. qwen3.7-max 또는 qwen3.6-flash에는 Standard(종량제) 엔드포인트를 사용하세요.

Plugin 설치

qwen은 코어에 번들로 포함되지 않은 정식 외부 Plugin으로 제공됩니다. 이를 설치하고 Gateway를 다시 시작하세요.

openclaw plugins install @openclaw/qwen-provider
openclaw gateway restart

시작하기

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

Coding Plan(구독)
Standard(종량제)
Token Plan(팀 에디션)
Qwen OAuth / Portal

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

API 키 받기

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

온보딩 실행

글로벌 엔드포인트의 경우:

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

중국 엔드포인트의 경우:

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

기본 모델 설정

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

모델 사용 가능 여부 확인

openclaw models list --provider qwen

기존 modelstudio-* 인증 선택 ID와 modelstudio/... 모델 참조도 여전히 호환성 별칭으로 작동하지만, 새 설정 흐름에서는 정식 qwen-* 인증 선택 ID와 qwen/... 모델 참조를 사용하는 것이 좋습니다. 다른 api 값으로 정확히 일치하는 사용자 지정 models.providers.modelstudio 항목을 정의하면 해당 사용자 지정 제공자가 Qwen 호환성 별칭 대신 modelstudio/... 참조를 소유합니다.

적합한 용도: Coding Plan에서 사용할 수 없는 qwen3.7-max 및 qwen3.6-flash를 포함하여 Standard Model Studio 엔드포인트를 통한 종량제 이용.

API 키 받기

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

온보딩 실행

글로벌 엔드포인트의 경우:

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

중국 엔드포인트의 경우:

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

기본 모델 설정

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

모델 사용 가능 여부 확인

openclaw models list --provider qwen

적합한 용도: Alibaba Cloud Model Studio를 통해 Qwen 및 지원되는 타사 모델을 이용하는 크레딧 기반 팀 구독.

전용 키 받기

Token Plan 좌석을 할당하고 전용 sk-sp-... 키를 만드세요. Token Plan, Coding Plan 및 종량제 키는 서로 바꿔 사용할 수 없습니다. 글로벌 Token Plan 개요 또는 중국 Token Plan 개요를 참조하세요.

온보딩 실행

싱가포르의 글로벌/국제 엔드포인트의 경우:

openclaw onboard --auth-choice qwen-token-plan

베이징의 중국 엔드포인트의 경우:

openclaw onboard --auth-choice qwen-token-plan-cn

제공자 확인

openclaw models list --provider qwen-token-plan
openclaw agent --model qwen-token-plan/qwen3.7-plus --message "Reply with: token plan ready"

Alibaba의 OpenClaw 가이드는 수동 사용자 지정 제공자에 bailian-token-plan을 사용합니다. Plugin은 해당 ID를 호환성 소유자로 등록하지만 새 구성에서는 qwen-token-plan을 사용해야 합니다. 정확히 일치하는 사용자 지정 models.providers.bailian-token-plan 항목은 구성된 전송 방식과 카탈로그의 소유권을 유지하며, 정식 OpenAI 카탈로그에 병합되지 않습니다.

Token Plan은 대화형 OpenClaw 세션에만 사용하세요. Cron 작업, 무인 스크립트 또는 애플리케이션 백엔드에는 선택하지 마세요. Alibaba는 비대화형으로 사용하면 구독이 중단되거나 API 키가 취소될 수 있다고 명시합니다.

적합한 용도: https://portal.qwen.ai/v1에 대한 Qwen Portal 토큰.전용 제공자 페이지와 마이그레이션 참고 사항은 Qwen OAuth / Portal을 참조하세요.

Portal 토큰 제공

openclaw onboard --auth-choice qwen-oauth

기본 모델 설정

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

모델 사용 가능 여부 확인

openclaw models list --provider qwen-oauth

qwen-oauth는 Qwen Cloud 제공자와 동일한 QWEN_API_KEY 환경 변수 이름을 사용하지만, OpenClaw 온보딩을 통해 구성할 때 인증을 qwen-oauth 제공자 ID 아래에 저장합니다.

요금제 유형 및 엔드포인트

요금제	지역	인증 선택	엔드포인트
Coding Plan(구독)	중국	`qwen-api-key-cn`	`coding.dashscope.aliyuncs.com/v1`
Coding Plan(구독)	글로벌	`qwen-api-key`	`coding-intl.dashscope.aliyuncs.com/v1`
Qwen Portal	글로벌	`qwen-oauth`	`portal.qwen.ai/v1`
Standard(종량제)	중국	`qwen-standard-api-key-cn`	`dashscope.aliyuncs.com/compatible-mode/v1`
Standard(종량제)	글로벌	`qwen-standard-api-key`	`dashscope-intl.aliyuncs.com/compatible-mode/v1`
Token Plan(팀 에디션)	중국	`qwen-token-plan-cn`	`token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1`
Token Plan(팀 에디션)	글로벌	`qwen-token-plan`	`token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`

제공자는 인증 선택에 따라 엔드포인트를 자동으로 선택합니다. 정식 선택 항목은 qwen-* 계열을 사용하며, modelstudio-*는 호환성 용도로만 유지됩니다. 구성에서 사용자 지정 baseUrl을 사용하여 재정의할 수 있습니다.

키 관리: home.qwencloud.com/api-keys | 문서: docs.qwencloud.com

기본 제공 카탈로그

OpenClaw는 다음 Qwen 정적 카탈로그를 제공합니다. 카탈로그는 엔드포인트를 인식하므로 Coding Plan 구성에서는 Standard 엔드포인트에서만 작동하는 모델을 제외합니다.

모델 참조	입력	컨텍스트	참고 사항
`qwen/qwen3.5-plus`	텍스트, 이미지	1,000,000	기본 모델
`qwen/qwen3.6-flash`	텍스트, 이미지	1,000,000	Standard 엔드포인트 전용
`qwen/qwen3.6-plus`	텍스트, 이미지	1,000,000	Coding Plan + Standard
`qwen/qwen3.7-max`	텍스트	1,000,000	Standard 엔드포인트 전용
`qwen/qwen3.7-plus`	텍스트, 이미지	1,000,000	Coding Plan + 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 기본값

모델이 정적 카탈로그에 있어도 엔드포인트와 결제 요금제에 따라 사용 가능 여부가 달라질 수 있습니다.

Token Plan 카탈로그

Token Plan은 별도의 정확한 문자열 허용 목록을 사용합니다. 이미지 생성 전용 요금제 모델은 서로 다른 API를 사용하므로 여기에 포함되지 않습니다.

모델 참조	입력	컨텍스트
`qwen-token-plan/qwen3.7-max`	텍스트	1,000,000
`qwen-token-plan/qwen3.7-plus`	텍스트, 이미지	1,000,000
`qwen-token-plan/qwen3.6-plus`	텍스트, 이미지	1,000,000
`qwen-token-plan/qwen3.6-flash`	텍스트, 이미지	1,000,000
`qwen-token-plan/deepseek-v4-pro`	텍스트	1,000,000
`qwen-token-plan/deepseek-v4-flash`	텍스트	1,000,000
`qwen-token-plan/deepseek-v3.2`	텍스트	131,072
`qwen-token-plan/kimi-k2.7-code`	텍스트, 이미지	262,144
`qwen-token-plan/kimi-k2.6`	텍스트, 이미지	262,144
`qwen-token-plan/kimi-k2.5`	텍스트, 이미지	262,144
`qwen-token-plan/glm-5.2`	텍스트	1,000,000
`qwen-token-plan/glm-5.1`	텍스트	202,752
`qwen-token-plan/glm-5`	텍스트	202,752
`qwen-token-plan/MiniMax-M2.5`	텍스트	196,608

사고 제어

qwen3.7-max, qwen3.7-plus, qwen3.6-flash, qwen3.6-plus는 기본 제공 카탈로그에서 추론이 활성화되어 있습니다. qwen 계열의 추론 모델에 대해 공급자는 OpenClaw 사고 수준을 DashScope의 최상위 enable_thinking 요청 플래그에 매핑합니다. 사고가 비활성화되면 enable_thinking: false를 전송하고, 그 외의 모든 수준에서는 enable_thinking: true를 전송합니다. 사용자 지정 모델은 모델 항목에 compat.thinkingFormat: "qwen-chat-template"을 설정하여 대체 채팅 템플릿 사고 페이로드를 사용하도록 선택할 수 있습니다. Token Plan 모델도 추론 가능 모델로 표시됩니다. kimi-k2.7-code와 MiniMax-M2.5는 사고 전용이므로 세션에서 /think off를 요청해도 OpenClaw는 사고를 활성화된 상태로 유지합니다. DeepSeek V4는 minimal부터 high까지를 서비스의 high 노력 수준에 매핑하고, xhigh 또는 max는 max에 매핑합니다. GLM 5.2는 minimal부터 max까지의 전체 범위를 허용합니다. GLM 5.1과 GLM 5는 xhigh까지 허용하며, 세 모델 모두 기본값은 high입니다. 그 밖의 하이브리드 모델은 요청된 켜짐/꺼짐 상태를 따릅니다.

멀티모달 추가 기능

qwen Plugin은 Coding Plan 엔드포인트가 아닌 Standard DashScope 엔드포인트에서만 멀티모달 기능을 제공합니다.

qwen-vl-max-latest를 통한 이미지 및 동영상 이해
wan2.6-t2v(기본값), wan2.6-i2v, wan2.6-r2v, wan2.6-r2v-flash, wan2.7-r2v를 통한 Wan 동영상 생성

미디어 이해 기능은 구성된 Qwen 인증에서 자동으로 확인되므로 추가 구성이 필요하지 않습니다. 미디어 이해 기능을 사용하려면 Standard(사용량 기반 요금제) 엔드포인트를 사용하고 있는지 확인하세요. Qwen을 기본 동영상 공급자로 설정하려면 다음과 같이 구성합니다.

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

동영상 생성 제한 사항: 요청당 출력 동영상 1개, 입력 이미지 최대 1개(이미지-동영상 변환), 입력 동영상 최대 4개(동영상-동영상 변환), 최대 길이 10초입니다. size, aspectRatio, resolution, audio, watermark를 지원합니다. 참조 이미지/동영상 입력에는 원격 http(s) URL이 필요합니다. DashScope 동영상 엔드포인트는 이러한 참조에 업로드된 로컬 버퍼를 허용하지 않으므로 로컬 파일 경로는 요청 전에 거부됩니다.

공통 도구 매개변수, 공급자 선택 및 장애 조치 동작은 동영상 생성을 참조하세요.

고급 구성

Qwen 3.6 및 3.7 사용 가능 여부

qwen3.7-plus와 qwen3.6-plus는 Coding Plan 및 Standard 엔드포인트에서 사용할 수 있습니다. qwen3.7-max와 qwen3.6-flash는 Standard에서만 사용할 수 있습니다. Standard(사용량 기반 요금제) 엔드포인트는 다음과 같습니다.

중국: dashscope.aliyuncs.com/compatible-mode/v1
글로벌: dashscope-intl.aliyuncs.com/compatible-mode/v1

OpenClaw는 Coding Plan 카탈로그에서 qwen3.7-max와 qwen3.6-flash를 제외합니다. Coding Plan 엔드포인트에서 두 모델 중 하나에 대해 “지원되지 않는 모델” 오류가 반환되면 해당하는 Standard 엔드포인트와 키로 전환하세요.

동영상 생성 리전 라우팅

OpenClaw는 동영상 작업을 제출하기 전에 구성된 Qwen 리전을 해당 DashScope AIGC 호스트에 매핑합니다.

글로벌/국제: https://dashscope-intl.aliyuncs.com
중국: https://dashscope.aliyuncs.com

Coding Plan 또는 Standard Qwen 호스트 중 하나를 가리키는 일반적인 models.providers.qwen.baseUrl도 동영상 생성을 해당 리전의 DashScope 동영상 엔드포인트로 라우팅합니다.

스트리밍 사용량 호환성

네이티브 Qwen 엔드포인트는 공유 openai-completions 전송 계층에서 스트리밍 사용량 호환성을 명시하므로, 동일한 네이티브 호스트를 대상으로 하는 DashScope 호환 사용자 지정 공급자 ID는 기본 제공 qwen 공급자 ID를 별도로 요구하지 않고도 동일한 동작을 상속합니다. 이는 Coding Plan, Standard 및 Token Plan 엔드포인트에 적용됩니다.

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
https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1

기능 계획

qwen Plugin은 코딩/텍스트 모델뿐 아니라 전체 Qwen Cloud 기능을 담당하는 공급자 기반으로 자리매김하고 있습니다.

텍스트/채팅 모델: Plugin을 통해 사용 가능
도구 호출, 구조화된 출력, 사고: OpenAI 호환 전송 계층에서 상속
이미지 생성: 공급자 Plugin 계층에서 지원 예정
이미지/동영상 이해: Standard 엔드포인트의 Plugin을 통해 사용 가능
음성/오디오: 공급자 Plugin 계층에서 지원 예정
메모리 임베딩/재순위화: 임베딩 어댑터 기능을 통해 지원 예정
동영상 생성: 공유 동영상 생성 기능을 통해 Plugin에서 사용 가능

환경 및 데몬 설정

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

모델 선택

공급자, 모델 참조 및 장애 조치 동작을 선택하는 방법입니다.

동영상 생성

공유 동영상 도구 매개변수 및 공급자 선택입니다.

Alibaba Model Studio

동일한 DashScope 플랫폼에 기본 제공되는 Wan 동영상 생성 공급자입니다.

문제 해결

일반적인 문제 해결 및 자주 묻는 질문입니다.

Overview

Concepts and configuration

Providers

Plugin 설치

시작하기

요금제 유형 및 엔드포인트

기본 제공 카탈로그

Token Plan 카탈로그

사고 제어

멀티모달 추가 기능

고급 구성

관련 항목

모델 선택

동영상 생성

Alibaba Model Studio

문제 해결

​Plugin 설치

​시작하기

​요금제 유형 및 엔드포인트

​기본 제공 카탈로그

​Token Plan 카탈로그

​사고 제어

​멀티모달 추가 기능

​고급 구성

​관련 항목

모델 선택

동영상 생성

Alibaba Model Studio

문제 해결

Plugin 설치

시작하기

요금제 유형 및 엔드포인트

기본 제공 카탈로그

Token Plan 카탈로그

사고 제어

멀티모달 추가 기능

고급 구성

관련 항목