--- read_when: - qwen-oauth 제공자 ID를 구성하려고 합니다 - 이전에 Qwen Portal OAuth 자격 증명을 사용했습니다 - Qwen Portal 엔드포인트 또는 마이그레이션 안내가 필요합니다 summary: OpenClaw에서 Qwen Portal 제공자 ID 사용하기 title: Qwen OAuth / 포털 x-i18n: generated_at: "2026-07-12T01:12:52Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: b78f6f23e62e38d11e6fe4e2bf515b13b414f276d08f672740ad94747a22c8fb source_path: providers/qwen-oauth.md workflow: 16 --- `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](/ko/providers/qwen)을 권장합니다. 새 API 키 설정, 더 폭넓은 엔드포인트 선택지, Standard 종량제, Coding Plan 및 전체 Qwen Plugin 카탈로그를 지원합니다. ## 설정 아직 설치하지 않았다면 Qwen Plugin을 설치하세요. ```bash openclaw plugins install @openclaw/qwen-provider openclaw gateway restart ``` 온보딩을 통해 포털 토큰을 제공하세요. ```bash openclaw onboard --auth-choice qwen-oauth ``` 비대화형 실행에서는 `--qwen-oauth-token `에서 토큰을 읽습니다. 또는 다음과 같이 설정하세요. ```bash export QWEN_API_KEY="" # 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-key openclaw 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 아래에 자격 증명을 저장합니다. 동일한 컴퓨터에서 `qwen`과 `qwen-oauth`를 모두 사용 가능하게 유지하는 경우 온보딩을 권장합니다. ## 관련 문서 - [Qwen](/ko/providers/qwen) - [Alibaba Model Studio](/ko/providers/alibaba) - [모델 공급자](/ko/concepts/model-providers) - [모든 공급자](/ko/providers/index)