Files
openclaw/docs/providers/qwen_modelstudio.md
2026-04-04 12:20:31 +01:00

5.3 KiB

title, summary, read_when
title summary read_when
Qwen / Model Studio Alibaba Cloud Model Studio setup (Standard pay-as-you-go and Coding Plan, dual region endpoints)
You want to use Qwen (Alibaba Cloud Model Studio) with OpenClaw
You need the API key env var for Model Studio
You want to use the Standard (pay-as-you-go) or Coding Plan endpoint

Qwen / Model Studio (Alibaba Cloud)

The Model Studio provider gives access to Alibaba Cloud models including Qwen and third-party models hosted on the platform. Two billing plans are supported: Standard (pay-as-you-go) and Coding Plan (subscription).

If you need qwen3.6-plus, prefer Standard (pay-as-you-go). Coding Plan availability can lag behind the public Model Studio catalog, and the Coding Plan API can reject a model until it appears in your plan's supported model list.

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

Quick start

Standard (pay-as-you-go)

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

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

Coding Plan (subscription)

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

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

After onboarding, set a default model:

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

Plan types and endpoints

Plan Region Auth choice Endpoint
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

The provider auto-selects the endpoint based on your auth choice. You can override with a custom baseUrl in config.

Native Model Studio endpoints advertise streaming usage compatibility on the shared openai-completions transport. OpenClaw keys that off endpoint capabilities now, so DashScope-compatible custom provider ids targeting the same native hosts inherit the same streaming-usage behavior instead of requiring the built-in modelstudio provider id specifically.

Get your API key

Built-in catalog

OpenClaw currently ships this bundled Model Studio catalog:

Model ref Input Context Notes
modelstudio/qwen3.5-plus text, image 1,000,000 Default model
modelstudio/qwen3.6-plus text, image 1,000,000 Prefer Standard endpoints when you need this model
modelstudio/qwen3-max-2026-01-23 text 262,144 Qwen Max line
modelstudio/qwen3-coder-next text 262,144 Coding
modelstudio/qwen3-coder-plus text 1,000,000 Coding
modelstudio/MiniMax-M2.5 text 1,000,000 Reasoning enabled
modelstudio/glm-5 text 202,752 GLM
modelstudio/glm-4.7 text 202,752 GLM
modelstudio/kimi-k2.5 text, image 262,144 Moonshot AI via Alibaba

Availability can still vary by endpoint and billing plan even when a model is present in the bundled catalog.

Native-streaming usage compatibility applies to both the Coding Plan hosts and the Standard DashScope-compatible hosts:

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

Qwen 3.6 Plus availability

qwen3.6-plus is available on the Standard (pay-as-you-go) Model Studio endpoints:

  • China: dashscope.aliyuncs.com/compatible-mode/v1
  • Global: dashscope-intl.aliyuncs.com/compatible-mode/v1

If the Coding Plan endpoints return an "unsupported model" error for qwen3.6-plus, switch to Standard (pay-as-you-go) instead of the Coding Plan endpoint/key pair.

Environment note

If the Gateway runs as a daemon (launchd/systemd), make sure MODELSTUDIO_API_KEY is available to that process (for example, in ~/.openclaw/.env or via env.shellEnv).