OpenClaw와 Alibaba Qwen 연동하기: 3분 빠른 설정 가이드

새로운 모델을 테스트할 때마다 복잡한 API 문서를 뒤지는 건 정말 지치는 일이죠. 특히 글로벌 서비스와 중국 내수용 서비스의 엔드포인트가 나뉘어 있으면 설정 단계부터 헷갈리기 마련입니다.

알리바바 클라우드의 Qwen 모델을 프로젝트에 빠르게 연동하고 싶은 분들을 위해 Model Studio 설정 방법을 정리했습니다. 복잡한 과정 없이 바로 따라 할 수 있도록 핵심만 담았으니 확인해 보세요.

Qwen / Model Studio (Alibaba Cloud)

Model Studio 프로바이더를 통해 Qwen 및 플랫폼에서 호스팅되는 다양한 서드파티 모델을 사용할 수 있습니다. 요금제는 Standard (종량제)와 Coding Plan (구독형) 두 가지를 지원해요.

• Provider: modelstudio
• Auth: MODELSTUDIO_API_KEY
• API: OpenAI-compatible

빠른 시작 (Quick start)

Standard (종량제)

# China endpoint
openclaw onboard --auth-choice modelstudio-standard-api-key-cn

# Global/Intl endpoint
openclaw onboard --auth-choice modelstudio-standard-api-key

Coding Plan (구독형)

# China endpoint
openclaw onboard --auth-choice modelstudio-api-key-cn

# Global/Intl endpoint
openclaw onboard --auth-choice modelstudio-api-key

온보딩을 마친 후, 기본 모델을 설정하세요:

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

요금제 유형 및 엔드포인트 (Plan types and endpoints)

요금제	지역	인증 선택 (Auth choice)	엔드포인트
Standard (pay-as-you-go)	China	modelstudio-standard-api-key-cn	dashscope.aliyuncs.com/compatible-mode/v1
Standard (pay-as-you-go)	Global	modelstudio-standard-api-key	dashscope-intl.aliyuncs.com/compatible-mode/v1
Coding Plan (subscription)	China	modelstudio-api-key-cn	coding.dashscope.aliyuncs.com/v1
Coding Plan (subscription)	Global	modelstudio-api-key	coding-intl.dashscope.aliyuncs.com/v1

프로바이더가 인증 선택에 따라 엔드포인트를 자동으로 선택합니다. 필요한 경우 설정에서 baseUrl을 직접 입력해 변경할 수 있습니다.

API 키 발급받기 (Get your API key)

• China: bailian.console.aliyun.com
• Global/Intl: modelstudio.console.alibabacloud.com

사용 가능한 모델 (Available models)

• qwen3.5-plus (기본값) — Qwen 3.5 Plus
• qwen3-coder-plus, qwen3-coder-next — Qwen 코딩 전용 모델
• GLM-5 — Alibaba를 통해 제공되는 GLM 모델
• Kimi K2.5 — Alibaba를 통해 제공되는 Moonshot AI 모델
• MiniMax-M2.7 — Alibaba를 통해 제공되는 MiniMax 모델

일부 모델(qwen3.5-plus, kimi-k2.5)은 이미지 입력을 지원합니다. 컨텍스트 윈도우 크기는 200K에서 최대 1M 토큰까지 제공됩니다.

환경 설정 참고 사항 (Environment note)

Gateway가 데몬(launchd/systemd)으로 실행되는 경우, 해당 프로세스가 MODELSTUDIO_API_KEY를 읽을 수 있는지 확인해야 합니다. 예를 들어 ~/.openclaw/.env 파일에 설정하거나 env.shellEnv를 통해 전달할 수 있습니다.

---

설정 과정에서 도움이 필요하다면 언제든 물어봐 주세요!

AI Setup Assistant

다음 단계

• 모델 설정 가이드
• 인증 방법 상세 보기