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로 제공합니다.

Plugin 설치

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

openclaw plugins install @openclaw/qwen-provideropenclaw gateway restart

시작하기

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

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

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

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

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

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

openclaw onboard --auth-choice qwen-oauth

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

openclaw models list --provider qwen-oauth

요금제 유형 및 엔드포인트

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

기본 제공 카탈로그

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

Token Plan 카탈로그

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

사고 제어

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 동영상 엔드포인트는 이러한 참조에 업로드된 로컬 버퍼를 허용하지 않으므로 로컬 파일 경로는 요청 전에 거부됩니다.

고급 구성

관련 항목