Qwen - OpenClaw

OpenClaw sekarang memperlakukan Qwen sebagai Plugin penyedia kelas utama dengan id kanonis qwen. Plugin penyedia menargetkan endpoint Qwen Cloud / Alibaba DashScope dan Coding Plan, tetap membuat id lama modelstudio berfungsi sebagai alias kompatibilitas, dan juga mengekspos alur token Qwen Portal sebagai penyedia qwen-oauth.

Penyedia: qwen
Penyedia Portal: qwen-oauth
Env var yang disarankan: QWEN_API_KEY
Juga diterima untuk kompatibilitas: MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
Gaya API: kompatibel dengan OpenAI

Jika Anda menginginkan qwen3.6-plus, pilih endpoint Standar (bayar sesuai pemakaian). Dukungan Coding Plan dapat tertinggal dari katalog publik.

Instal Plugin

Instal Plugin resmi, lalu mulai ulang Gateway:

openclaw plugins install @openclaw/qwen-provider
openclaw gateway restart

Memulai

Pilih jenis paket Anda dan ikuti langkah-langkah penyiapan.

Coding Plan (subscription)
Standard (pay-as-you-go)
Qwen OAuth / Portal

Terbaik untuk: akses berbasis langganan melalui Qwen Coding Plan.

Get your API key

Buat atau salin kunci API dari home.qwencloud.com/api-keys.

Run onboarding

Untuk endpoint Global:

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

Untuk endpoint China:

openclaw onboard --auth-choice qwen-api-key-cn

Set a default model

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

Verify the model is available

openclaw models list --provider qwen

Id auth-choice lama modelstudio-* dan ref model modelstudio/... masih berfungsi sebagai alias kompatibilitas, tetapi alur penyiapan baru sebaiknya menggunakan id auth-choice kanonis qwen-* dan ref model qwen/.... Jika Anda mendefinisikan entri models.providers.modelstudio kustom yang persis dengan nilai api lain, maka penyedia kustom tersebut memiliki ref modelstudio/..., bukan alias kompatibilitas Qwen.

Terbaik untuk: akses bayar sesuai pemakaian melalui endpoint Standard Model Studio, termasuk model seperti qwen3.6-plus yang mungkin tidak tersedia di Coding Plan.

Get your API key

Buat atau salin kunci API dari home.qwencloud.com/api-keys.

Run onboarding

Untuk endpoint Global:

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

Untuk endpoint China:

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

Set a default model

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

Verify the model is available

openclaw models list --provider qwen

Terbaik untuk: token Qwen Portal terhadap https://portal.qwen.ai/v1.Lihat Qwen OAuth / Portal untuk halaman penyedia khusus dan catatan migrasi.

Provide your portal token

openclaw onboard --auth-choice qwen-oauth

Set a default model

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

Verify the model is available

openclaw models list --provider qwen-oauth

qwen-oauth menggunakan nama env var QWEN_API_KEY yang sama seperti penyedia DashScope, tetapi menyimpan auth di bawah id penyedia qwen-oauth saat dikonfigurasi melalui onboarding OpenClaw.

Jenis paket dan endpoint

Paket	Wilayah	Pilihan auth	Endpoint
Standar (bayar sesuai pemakaian)	China	`qwen-standard-api-key-cn`	`dashscope.aliyuncs.com/compatible-mode/v1`
Standar (bayar sesuai pemakaian)	Global	`qwen-standard-api-key`	`dashscope-intl.aliyuncs.com/compatible-mode/v1`
Coding Plan (langganan)	China	`qwen-api-key-cn`	`coding.dashscope.aliyuncs.com/v1`
Coding Plan (langganan)	Global	`qwen-api-key`	`coding-intl.dashscope.aliyuncs.com/v1`
Qwen Portal	Global	`qwen-oauth`	`portal.qwen.ai/v1`

Penyedia memilih endpoint secara otomatis berdasarkan pilihan auth Anda. Pilihan kanonis menggunakan keluarga qwen-*; modelstudio-* tetap hanya untuk kompatibilitas. Anda dapat menimpanya dengan baseUrl kustom dalam konfigurasi.

Kelola kunci: home.qwencloud.com/api-keys | Dokumentasi: docs.qwencloud.com

Katalog bawaan

OpenClaw saat ini mengirimkan katalog statis Qwen ini. Katalog yang dikonfigurasi sadar endpoint: konfigurasi Coding Plan menghilangkan model yang hanya diketahui berfungsi pada endpoint Standar.

Ref model	Input	Konteks	Catatan
`qwen/qwen3.5-plus`	teks, gambar	1,000,000	Model default
`qwen/qwen3.6-plus`	teks, gambar	1,000,000	Pilih endpoint Standar saat Anda memerlukan model ini
`qwen/qwen3-max-2026-01-23`	teks	262,144	Lini Qwen Max
`qwen/qwen3-coder-next`	teks	262,144	Coding
`qwen/qwen3-coder-plus`	teks	1,000,000	Coding
`qwen/MiniMax-M2.5`	teks	1,000,000	Penalaran diaktifkan
`qwen/glm-5`	teks	202,752	GLM
`qwen/glm-4.7`	teks	202,752	GLM
`qwen/kimi-k2.5`	teks, gambar	262,144	Moonshot AI melalui Alibaba
`qwen-oauth/qwen3.5-plus`	teks, gambar	1,000,000	Default Qwen Portal

Ketersediaan tetap dapat berbeda menurut endpoint dan paket penagihan meskipun sebuah model ada dalam katalog statis.

Kontrol penalaran

Untuk model Qwen Cloud yang mendukung penalaran, penyedia memetakan level penalaran OpenClaw ke flag permintaan tingkat atas DashScope enable_thinking. Penalaran yang dinonaktifkan mengirim enable_thinking: false; level penalaran lain mengirim enable_thinking: true.

Add-on multimodal

Plugin qwen juga mengekspos kemampuan multimodal pada endpoint DashScope Standar (bukan endpoint Coding Plan):

Pemahaman video melalui qwen-vl-max-latest
Pembuatan video Wan melalui wan2.6-t2v (default), wan2.6-i2v, wan2.6-r2v, wan2.6-r2v-flash, wan2.7-r2v

Untuk menggunakan Qwen sebagai penyedia video default:

{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
    },
  },
}

Lihat Pembuatan Video untuk parameter alat bersama, pemilihan penyedia, dan perilaku failover.

Konfigurasi lanjutan

Image and video understanding

Plugin Qwen mendaftarkan pemahaman media untuk gambar dan video pada endpoint DashScope Standar (bukan endpoint Coding Plan).

Properti	Nilai
Model	`qwen-vl-max-latest`
Input yang didukung	Gambar, video

Pemahaman media diselesaikan otomatis dari auth Qwen yang dikonfigurasi — tidak diperlukan konfigurasi tambahan. Pastikan Anda menggunakan endpoint Standar (bayar sesuai pemakaian) untuk dukungan pemahaman media.

Qwen 3.6 Plus availability

qwen3.6-plus tersedia pada endpoint Model Studio Standar (bayar sesuai pemakaian):

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

Jika endpoint Coding Plan mengembalikan kesalahan “model tidak didukung” untuk qwen3.6-plus, beralihlah ke Standar (bayar sesuai pemakaian), bukan pasangan endpoint/kunci Coding Plan.Katalog statis Qwen OpenClaw tidak mengiklankan qwen3.6-plus pada endpoint Coding Plan, tetapi entri qwen/qwen3.6-plus yang dikonfigurasi secara eksplisit di bawah models.providers.qwen.models tetap dihormati pada baseUrl Coding Plan sehingga Anda dapat mengaktifkan model tersebut jika Aliyun mengaktifkannya pada langganan Anda. API upstream tetap menentukan apakah panggilan berhasil.

Capability plan

Plugin qwen diposisikan sebagai rumah vendor untuk seluruh permukaan Qwen Cloud, bukan hanya model coding/teks.

Model teks/chat: tersedia melalui Plugin
Pemanggilan alat, output terstruktur, penalaran: diwarisi dari transport kompatibel OpenAI
Pembuatan gambar: direncanakan pada lapisan Plugin penyedia
Pemahaman gambar/video: tersedia melalui Plugin pada endpoint Standar
Ucapan/audio: direncanakan pada lapisan Plugin penyedia
Embedding/reranking memori: direncanakan melalui permukaan adaptor embedding
Pembuatan video: tersedia melalui Plugin melalui kemampuan pembuatan video bersama

Video generation details

Untuk pembuatan video, OpenClaw memetakan wilayah Qwen yang dikonfigurasi ke host DashScope AIGC yang sesuai sebelum mengirimkan pekerjaan:

Global/Intl: https://dashscope-intl.aliyuncs.com
China: https://dashscope.aliyuncs.com

Artinya, models.providers.qwen.baseUrl normal yang mengarah ke host Coding Plan atau Standar Qwen tetap menjaga pembuatan video pada endpoint video regional DashScope yang benar.Batas pembuatan video Qwen saat ini:

Hingga 1 video output per permintaan
Hingga 1 gambar input
Hingga 4 video input
Durasi hingga 10 detik
Mendukung size, aspectRatio, resolution, audio, dan watermark
Mode gambar/video referensi saat ini memerlukan URL http(s) jarak jauh. Path file lokal ditolak sejak awal karena endpoint video DashScope tidak menerima buffer lokal yang diunggah untuk referensi tersebut.

Kompatibilitas penggunaan streaming

Endpoint Model Studio native mengiklankan kompatibilitas penggunaan streaming pada transport openai-completions bersama. OpenClaw kini menentukannya berdasarkan kemampuan endpoint, sehingga id penyedia kustom yang kompatibel dengan DashScope yang menargetkan host native yang sama mewarisi perilaku penggunaan streaming yang sama, alih-alih mengharuskan id penyedia bawaan qwen secara spesifik.Kompatibilitas penggunaan native-streaming berlaku untuk host Coding Plan dan host Standard yang kompatibel dengan DashScope:

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

Wilayah endpoint multimodal

Surface multimodal (pemahaman video dan pembuatan video Wan) menggunakan endpoint DashScope Standard, bukan endpoint Coding Plan:

URL dasar Standard Global/Intl: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
URL dasar Standard China: https://dashscope.aliyuncs.com/compatible-mode/v1

Penyiapan lingkungan dan daemon

Jika Gateway berjalan sebagai daemon (launchd/systemd), pastikan QWEN_API_KEY tersedia untuk proses tersebut (misalnya, di ~/.openclaw/.env atau melalui env.shellEnv).

Terkait

Pemilihan model

Memilih penyedia, referensi model, dan perilaku failover.

Pembuatan video

Parameter alat video bersama dan pemilihan penyedia.

Alibaba (ModelStudio)

Penyedia ModelStudio lama dan catatan migrasi.

Pemecahan masalah

Pemecahan masalah umum dan FAQ.

​Instal Plugin

​Memulai

​Jenis paket dan endpoint

​Katalog bawaan

​Kontrol penalaran

​Add-on multimodal

​Konfigurasi lanjutan

​Terkait

Pemilihan model

Pembuatan video

Alibaba (ModelStudio)

Pemecahan masalah

Instal Plugin

Memulai

Jenis paket dan endpoint

Katalog bawaan

Kontrol penalaran

Add-on multimodal

Konfigurasi lanjutan

Terkait