OpenClaw에서 Qwen 모델 무료로 사용하기

새로운 모델이 나올 때마다 API 키를 새로 발급받고 결제 정보를 등록하는 과정, 정말 귀찮지 않나요? 특히 코딩 성능이 뛰어난 Qwen Coder나 이미지를 잘 분석하는 Qwen Vision을 써보고 싶은데 설정 단계에서 막히면 의욕이 꺾이기 마련입니다. 저도 처음에 복잡한 OAuth 설정 때문에 고생했던 기억이 나네요. 하지만 OpenClaw를 사용하면 이 과정을 아주 간단하게 해결할 수 있습니다.

Qwen은 현재 Coder와 Vision 모델에 대해 하루 2,000회의 무료 요청을 제공하는 OAuth 플로우를 지원하고 있어요. 지금 바로 설정해 보세요.

필요한 것

• 최신 버전의 OpenClaw 설치
• Qwen 계정

빠른 시작

5분 안에 설정을 끝내고 Qwen 모델을 사용해 보세요.

1. 플러그인 활성화

먼저 Qwen 인증을 담당할 플러그인을 켭니다.

openclaw plugins enable qwen-portal-auth

중요: 플러그인을 활성화한 후에는 반드시 Gateway를 재시작해야 합니다.

2. 인증 및 로그인

다음 명령어를 입력하면 Qwen의 디바이스 코드 OAuth 플로우가 시작됩니다.

openclaw models auth login --provider qwen-portal --set-default

이 과정을 마치면 models.json 파일에 자동으로 설정이 저장되고, qwen이라는 별칭(alias)이 생성되어 모델을 빠르게 전환할 수 있습니다.

3. 모델 선택

사용하려는 모델 ID를 확인하고 설정하세요.

• qwen-portal/coder-model
• qwen-portal/vision-model

모델을 바꾸고 싶을 때는 아래 명령어를 사용합니다.

openclaw models set qwen-portal/coder-model

4. 기존 CLI 로그인 정보 재사용

이미 Qwen Code CLI를 사용 중이라면, OpenClaw가 ~/.qwen/oauth_creds.json 경로에서 인증 정보를 자동으로 가져옵니다. 다만, models.providers.qwen-portal 항목은 여전히 필요하므로 위의 로그인 명령어를 한 번은 실행해 주는 것이 좋습니다.

문제 해결

• 토큰 갱신 문제: 토큰은 자동으로 갱신되지만, 만약 갱신에 실패하거나 권한이 취소되었다면 다시 로그인 명령어를 실행하세요.
• Base URL 변경: 기본 API 주소는 https://portal.qwen.ai/v1입니다. 만약 Qwen에서 다른 엔드포인트를 제공한다면 models.providers.qwen-portal.baseUrl에서 수정할 수 있습니다.

설정 과정에서 궁금한 점이 생기면 언제든 AI Setup Assistant에게 물어보세요.

다음 단계

• Model providers에서 더 자세한 제공자 규칙 확인하기