Providers

Qwen OAuth / 포털

qwen-oauth는 Qwen Plugin(@openclaw/qwen-provider)이 등록하는 Qwen Portal 공급자 ID입니다. https://portal.qwen.ai/v1의 Qwen Portal 엔드포인트를 대상으로 하며, 이전 Qwen OAuth / 포털 설정을 표준 qwen 공급자와 별도의 고유한 공급자 ID를 통해 계속 사용할 수 있게 합니다.

이미 작동하는 Qwen Portal 토큰이 있거나, 기존 Qwen OAuth 또는 Qwen CLI 워크플로를 마이그레이션하거나, Qwen Portal 엔드포인트를 구체적으로 테스트해야 한다면 qwen-oauth를 선택하세요. 새 설정에서는 Standard ModelStudio 엔드포인트를 사용하는 Qwen을 권장합니다. 새 API 키 설정, 더 폭넓은 엔드포인트 선택지, Standard 종량제, Coding Plan 및 전체 Qwen Plugin 카탈로그를 지원합니다.

설정

아직 설치하지 않았다면 Qwen Plugin을 설치하세요.

bash
openclaw plugins install @openclaw/qwen-provideropenclaw gateway restart

온보딩을 통해 포털 토큰을 제공하세요.

bash
openclaw onboard --auth-choice qwen-oauth

비대화형 실행에서는 --qwen-oauth-token <token>에서 토큰을 읽습니다. 또는 다음과 같이 설정하세요.

bash
export QWEN_API_KEY="<your-qwen-portal-token>" # pragma: allowlist secret

온보딩은 토큰을 qwen-oauth 인증 프로필에 저장하고, 포털 모델 카탈로그를 초기화하며, 구성된 모델이 없으면 qwen-oauth/qwen3.5-plus를 기본 모델로 설정합니다.

기본값

  • 공급자: qwen-oauth
  • 별칭: qwen-portal, qwen-cli
  • 기본 URL: https://portal.qwen.ai/v1
  • 환경 변수: QWEN_API_KEY
  • API 방식: OpenAI 호환
  • 기본 모델: qwen-oauth/qwen3.5-plus

Qwen과의 차이점

OpenClaw에는 Qwen용 공급자 ID가 두 개 있습니다.

공급자 엔드포인트 계열 적합한 용도
qwen Qwen Cloud / Alibaba DashScope 및 Coding Plan 엔드포인트 새 API 키 설정, Standard 종량제, Coding Plan, 멀티모달 DashScope 기능
qwen-oauth portal.qwen.ai/v1의 Qwen Portal 엔드포인트 기존 Qwen Portal 토큰 및 기존 Qwen OAuth / CLI 설정

두 공급자 모두 OpenAI 호환 요청 형식을 사용하지만 인증 영역은 서로 분리되어 있습니다. qwen-oauth용으로 저장된 토큰을 DashScope 또는 ModelStudio 키로 취급해서는 안 되며, 새 DashScope 키에는 표준 qwen 공급자를 사용해야 합니다.

모델

Qwen Plugin은 Qwen Portal 엔드포인트에 대해 다음 정적 카탈로그를 초기화합니다. 모든 항목의 최대 출력은 65,536토큰이며, 사용 가능 여부는 현재 Qwen Portal 계정과 토큰에 따라 달라집니다.

모델 참조 입력 컨텍스트 참고
qwen-oauth/qwen3.5-plus 텍스트, 이미지 1,000,000 기본 모델
qwen-oauth/qwen3.6-plus 텍스트, 이미지 1,000,000
qwen-oauth/qwen3-max-2026-01-23 텍스트 262,144
qwen-oauth/qwen3-coder-next 텍스트 262,144
qwen-oauth/qwen3-coder-plus 텍스트 1,000,000
qwen-oauth/MiniMax-M2.5 텍스트 1,000,000 추론
qwen-oauth/glm-5 텍스트 202,752
qwen-oauth/glm-4.7 텍스트 202,752
qwen-oauth/kimi-k2.5 텍스트, 이미지 262,144

계정에서 ModelStudio / DashScope API 키를 대신 사용한다면 표준 qwen 공급자를 구성하세요.

bash
openclaw onboard --auth-choice qwen-standard-api-keyopenclaw models set qwen/qwen3-coder-plus

마이그레이션

기존 Qwen Portal OAuth 프로필은 갱신할 수 없으며, openclaw doctor가 이를 표시합니다. 포털 프로필이 작동하지 않게 되면 최신 토큰으로 온보딩을 다시 실행하거나 Standard Qwen 공급자로 전환하세요.

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

Standard 글로벌 ModelStudio는 다음을 사용합니다.

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

문제 해결

  • 포털 OAuth 갱신 실패: 기존 Qwen Portal OAuth 프로필은 갱신할 수 없습니다. 최신 토큰으로 온보딩을 다시 실행하세요.
  • 잘못된 엔드포인트 오류: 포털 토큰을 사용할 때 모델 참조가 qwen-oauth/로 시작하는지 확인하세요. qwen/ 참조는 표준 Qwen 공급자에만 사용하세요.
  • QWEN_API_KEY 혼동: 두 Qwen 페이지 모두 이 환경 변수를 언급하지만, 온보딩은 선택한 공급자 ID 아래에 자격 증명을 저장합니다. 동일한 컴퓨터에서 qwenqwen-oauth를 모두 사용 가능하게 유지하는 경우 온보딩을 권장합니다.

관련 문서

Was this useful?
On this page

On this page