Providers
Qwen
Qwen Cloud adalah plugin penyedia eksternal resmi OpenClaw dengan id kanonis qwen. Plugin ini ditujukan untuk endpoint Qwen Cloud / Alibaba DashScope Standard dan Coding Plan, menyediakan Token Plan sebagai qwen-token-plan, mempertahankan modelstudio sebagai alias kompatibilitas, secara mandiri memiliki id penyedia khusus bailian-token-plan yang didokumentasikan Alibaba, dan menyediakan alur token Qwen Portal sebagai qwen-oauth.
| Properti | Nilai |
|---|---|
| Penyedia | qwen |
| Penyedia Token Plan | qwen-token-plan |
| Penyedia portal | qwen-oauth |
| Variabel lingkungan yang disukai | QWEN_API_KEY |
| Variabel lingkungan Token Plan | QWEN_TOKEN_PLAN_API_KEY |
| Juga diterima (kompatibilitas) | MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY |
| Gaya API | Kompatibel dengan OpenAI |
Instal plugin
qwen disediakan sebagai plugin eksternal resmi dan tidak dibundel dengan inti. Instal plugin tersebut dan mulai ulang Gateway:
openclaw plugins install @openclaw/qwen-provideropenclaw gateway restartMemulai
Pilih jenis paket Anda dan ikuti langkah-langkah penyiapannya.
Coding Plan (langganan)
Paling sesuai untuk: akses berbasis langganan melalui Qwen Coding Plan.
Dapatkan kunci API Anda
Buat atau salin kunci API dari home.qwencloud.com/api-keys.
Jalankan orientasi awal
Untuk endpoint Global:
openclaw onboard --auth-choice qwen-api-keyUntuk endpoint China:
openclaw onboard --auth-choice qwen-api-key-cnTetapkan model bawaan
{ agents: { defaults: { model: { primary: "qwen/qwen3.5-plus" }, }, },}Pastikan model tersedia
openclaw models list --provider qwenStandard (bayar sesuai pemakaian)
Paling sesuai untuk: akses bayar sesuai pemakaian melalui endpoint Standard Model Studio, termasuk qwen3.7-max dan qwen3.6-flash, yang tidak tersedia pada Coding Plan.
Dapatkan kunci API Anda
Buat atau salin kunci API dari home.qwencloud.com/api-keys.
Jalankan orientasi awal
Untuk endpoint Global:
openclaw onboard --auth-choice qwen-standard-api-keyUntuk endpoint China:
openclaw onboard --auth-choice qwen-standard-api-key-cnTetapkan model bawaan
{ agents: { defaults: { model: { primary: "qwen/qwen3.5-plus" }, }, },}Pastikan model tersedia
openclaw models list --provider qwenToken Plan (Edisi Tim)
Paling sesuai untuk: akses langganan tim berbasis kredit ke Qwen dan model pihak ketiga yang didukung melalui Alibaba Cloud Model Studio.
Dapatkan kunci khusus Anda
Tetapkan satu jatah Token Plan dan buat kunci khusus sk-sp-... untuknya. Kunci Token Plan, Coding Plan, dan bayar sesuai pemakaian tidak dapat saling dipertukarkan. Lihat ikhtisar Token Plan Global atau ikhtisar Token Plan China.
Jalankan orientasi awal
Untuk endpoint Global / Internasional di Singapura:
openclaw onboard --auth-choice qwen-token-planUntuk endpoint China di Beijing:
openclaw onboard --auth-choice qwen-token-plan-cnVerifikasi penyedia
openclaw models list --provider qwen-token-planopenclaw agent --model qwen-token-plan/qwen3.7-plus --message "Reply with: token plan ready"Qwen OAuth / Portal
Paling sesuai untuk: token Qwen Portal yang digunakan terhadap https://portal.qwen.ai/v1.
Lihat Qwen OAuth / Portal untuk halaman penyedia khusus dan catatan migrasi.
Berikan token portal Anda
openclaw onboard --auth-choice qwen-oauthTetapkan model bawaan
{ agents: { defaults: { model: { primary: "qwen-oauth/qwen3.5-plus" }, }, },}Pastikan model tersedia
openclaw models list --provider qwen-oauthJenis paket dan endpoint
| Paket | Wilayah | Pilihan autentikasi | Endpoint |
|---|---|---|---|
| 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 |
| Standard (bayar sesuai pemakaian) | China | qwen-standard-api-key-cn |
dashscope.aliyuncs.com/compatible-mode/v1 |
| Standard (bayar sesuai pemakaian) | Global | qwen-standard-api-key |
dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| Token Plan (Edisi Tim) | China | qwen-token-plan-cn |
token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 |
| Token Plan (Edisi Tim) | Global | qwen-token-plan |
token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 |
Penyedia secara otomatis memilih endpoint berdasarkan pilihan autentikasi Anda.
Pilihan kanonis menggunakan kelompok qwen-*; modelstudio-* tetap hanya untuk
kompatibilitas. Timpa dengan baseUrl khusus dalam konfigurasi.
Katalog bawaan
OpenClaw menyediakan katalog statis Qwen ini. Katalog tersebut memperhitungkan endpoint: konfigurasi Coding Plan menghilangkan model yang hanya berfungsi pada endpoint Standard.
| Referensi model | Masukan | Konteks | Catatan |
|---|---|---|---|
qwen/qwen3.5-plus |
teks, gambar | 1,000,000 | Model bawaan |
qwen/qwen3.6-flash |
teks, gambar | 1,000,000 | Hanya endpoint Standard |
qwen/qwen3.6-plus |
teks, gambar | 1,000,000 | Coding Plan + Standard |
qwen/qwen3.7-max |
teks | 1,000,000 | Hanya endpoint Standard |
qwen/qwen3.7-plus |
teks, gambar | 1,000,000 | Coding Plan + Standard |
qwen/qwen3-max-2026-01-23 |
teks | 262,144 | Seri Qwen Max |
qwen/qwen3-coder-next |
teks | 262,144 | Pemrograman |
qwen/qwen3-coder-plus |
teks | 1,000,000 | Pemrograman |
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 | Bawaan Qwen Portal |
Katalog Token Plan
Token Plan menggunakan daftar izin pencocokan string persis yang terpisah. Model paket yang hanya untuk pembuatan gambar tidak disertakan di sini karena menggunakan API yang berbeda.
| Referensi model | Masukan | Konteks |
|---|---|---|
qwen-token-plan/qwen3.7-max |
teks | 1,000,000 |
qwen-token-plan/qwen3.7-plus |
teks, gambar | 1,000,000 |
qwen-token-plan/qwen3.6-plus |
teks, gambar | 1,000,000 |
qwen-token-plan/qwen3.6-flash |
teks, gambar | 1,000,000 |
qwen-token-plan/deepseek-v4-pro |
teks | 1,000,000 |
qwen-token-plan/deepseek-v4-flash |
teks | 1,000,000 |
qwen-token-plan/deepseek-v3.2 |
teks | 131,072 |
qwen-token-plan/kimi-k2.7-code |
teks, gambar | 262,144 |
qwen-token-plan/kimi-k2.6 |
teks, gambar | 262,144 |
qwen-token-plan/kimi-k2.5 |
teks, gambar | 262,144 |
qwen-token-plan/glm-5.2 |
teks | 1,000,000 |
qwen-token-plan/glm-5.1 |
teks | 202,752 |
qwen-token-plan/glm-5 |
teks | 202,752 |
qwen-token-plan/MiniMax-M2.5 |
teks | 196,608 |
Kontrol penalaran
qwen3.7-max, qwen3.7-plus, qwen3.6-flash, dan qwen3.6-plus
mendukung penalaran dalam katalog bawaan. Untuk model penalaran dalam keluarga
qwen, penyedia memetakan tingkat pemikiran OpenClaw ke flag permintaan tingkat
atas enable_thinking milik DashScope: pemikiran yang dinonaktifkan mengirim
enable_thinking: false, sedangkan tingkat lainnya mengirim enable_thinking: true.
Model khusus dapat memilih payload pemikiran templat obrolan alternatif dengan
menetapkan compat.thinkingFormat: "qwen-chat-template" pada entri model.
Model Token Plan juga ditandai mendukung penalaran. kimi-k2.7-code dan
MiniMax-M2.5 hanya mendukung pemikiran, sehingga OpenClaw mempertahankan
pemikiran tetap aktif meskipun sesi meminta /think off. DeepSeek V4 memetakan
minimal hingga high ke upaya high milik layanan dan memetakan xhigh atau
max ke max. GLM 5.2 menerima seluruh rentang minimal hingga max; GLM 5.1
dan GLM 5 menerima hingga xhigh, dan ketiganya menggunakan high secara
default. Model hibrida lainnya mengikuti status aktif/nonaktif yang diminta.
Fitur tambahan multimodal
Plugin qwen menyediakan kemampuan multimodal hanya pada endpoint DashScope
Standard, bukan endpoint Coding Plan:
- Pemahaman gambar dan 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
Pemahaman media ditentukan secara otomatis dari autentikasi Qwen yang dikonfigurasi; tidak diperlukan konfigurasi tambahan. Pastikan Anda menggunakan endpoint Standard (bayar sesuai pemakaian) agar pemahaman media berfungsi.
Untuk menjadikan Qwen sebagai penyedia video default:
{ agents: { defaults: { videoGenerationModel: { primary: "qwen/wan2.6-t2v" }, }, },}Batas pembuatan video: 1 video keluaran per permintaan, hingga 1 gambar masukan
(gambar-ke-video), hingga 4 video masukan (video-ke-video), dan durasi maksimum
10 detik. Mendukung size, aspectRatio, resolution, audio, dan
watermark. Masukan gambar/video referensi memerlukan URL http(s) jarak jauh;
jalur berkas lokal langsung ditolak karena endpoint video DashScope tidak
menerima buffer lokal yang diunggah untuk referensi tersebut.
Konfigurasi lanjutan
Ketersediaan Qwen 3.6 dan 3.7
qwen3.7-plus dan qwen3.6-plus tersedia pada endpoint Coding Plan dan Standard. qwen3.7-max dan qwen3.6-flash hanya tersedia pada Standard. Endpoint Standard (bayar sesuai pemakaian) adalah:
- Tiongkok:
dashscope.aliyuncs.com/compatible-mode/v1 - Global:
dashscope-intl.aliyuncs.com/compatible-mode/v1
OpenClaw menghilangkan qwen3.7-max dan qwen3.6-flash dari katalog Coding Plan.
Jika endpoint Coding Plan mengembalikan galat "unsupported model" untuk salah
satunya, beralihlah ke endpoint Standard dan kunci yang sesuai.
Perutean wilayah pembuatan video
OpenClaw memetakan wilayah Qwen yang dikonfigurasi ke host AIGC DashScope yang sesuai sebelum mengirimkan tugas video:
- Global/Internasional:
https://dashscope-intl.aliyuncs.com - Tiongkok:
https://dashscope.aliyuncs.com
models.providers.qwen.baseUrl biasa yang mengarah ke host Qwen Coding Plan
atau Standard tetap merutekan pembuatan video ke endpoint video DashScope
regional yang sesuai.
Kompatibilitas penggunaan streaming
Endpoint Qwen native menyatakan kompatibilitas penggunaan streaming pada
transportasi bersama openai-completions, sehingga ID penyedia khusus yang
kompatibel dengan DashScope dan menargetkan host native yang sama mewarisi
perilaku yang sama tanpa secara khusus memerlukan ID penyedia bawaan qwen.
Hal ini berlaku untuk endpoint Coding Plan, Standard, dan Token Plan:
https://coding.dashscope.aliyuncs.com/v1https://coding-intl.dashscope.aliyuncs.com/v1https://dashscope.aliyuncs.com/compatible-mode/v1https://dashscope-intl.aliyuncs.com/compatible-mode/v1https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
Rencana kemampuan
Plugin qwen diposisikan sebagai pusat penyedia untuk seluruh cakupan Qwen
Cloud, bukan hanya model pemrograman/teks.
- Model teks/obrolan: tersedia melalui Plugin
- Pemanggilan alat, keluaran terstruktur, pemikiran: diwarisi dari transportasi yang kompatibel dengan OpenAI
- Pembuatan gambar: direncanakan pada lapisan Plugin penyedia
- Pemahaman gambar/video: tersedia melalui Plugin pada endpoint Standard
- Ucapan/audio: direncanakan pada lapisan Plugin penyedia
- Embedding/pemeringkatan ulang memori: direncanakan melalui lapisan adaptor embedding
- Pembuatan video: tersedia melalui Plugin melalui kemampuan pembuatan video bersama
Penyiapan lingkungan dan daemon
Jika Gateway berjalan sebagai daemon (launchd/systemd), pastikan
QWEN_API_KEY atau QWEN_TOKEN_PLAN_API_KEY tersedia bagi proses tersebut
(misalnya, dalam ~/.openclaw/.env atau melalui env.shellEnv).
Terkait
Memilih penyedia, referensi model, dan perilaku failover.
Parameter alat video bersama dan pemilihan penyedia.
Penyedia pembuatan video Wan yang disertakan pada platform DashScope yang sama.
Pemecahan masalah umum dan pertanyaan umum.