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, mengekspos Token Plan sebagai qwen-token-plan, mempertahankan modelstudio sebagai alias kompatibilitas, dan secara independen memiliki id penyedia khusus bailian-token-plan yang didokumentasikan Alibaba.

Properti	Nilai
Penyedia	`qwen`
Penyedia Token Plan	`qwen-token-plan`
Variabel lingkungan utama	`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

qwen3.7-plus dan qwen3.6-plus berfungsi dengan endpoint Coding Plan dan Standard. Untuk qwen3.7-max atau qwen3.6-flash, gunakan endpoint Standard (bayar sesuai pemakaian).

Instal plugin

qwen didistribusikan sebagai plugin eksternal resmi, bukan disertakan bersama core. Instal plugin tersebut dan mulai ulang Gateway:

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

Memulai

Pilih jenis paket Anda dan ikuti langkah-langkah penyiapan.

Coding Plan (langganan)
Standard (bayar sesuai pemakaian)
Token Plan (Edisi Tim)

Paling cocok 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-key

Untuk endpoint China:

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

Tetapkan model default

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

Verifikasi bahwa model tersedia

openclaw models list --provider qwen

Id pilihan autentikasi lama modelstudio-* dan referensi model modelstudio/... masih berfungsi sebagai alias kompatibilitas, tetapi alur penyiapan baru sebaiknya mengutamakan id pilihan autentikasi kanonis qwen-* dan referensi model qwen/.... Jika Anda menentukan entri khusus models.providers.modelstudio yang persis dengan nilai api lain, penyedia khusus tersebut memiliki referensi modelstudio/..., bukan alias kompatibilitas Qwen.

Paling cocok untuk: akses bayar sesuai pemakaian melalui endpoint Standard Model Studio, termasuk qwen3.7-max dan qwen3.6-flash, yang tidak tersedia di 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-key

Untuk endpoint China:

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

Tetapkan model default

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

Verifikasi bahwa model tersedia

openclaw models list --provider qwen

Paling cocok 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 tempat Token Plan dan buat kunci khusus sk-sp-... untuknya. Kunci Token Plan, Coding Plan, dan bayar sesuai pemakaian tidak dapat 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-plan

Untuk endpoint China di Beijing:

openclaw onboard --auth-choice qwen-token-plan-cn

Verifikasi penyedia

openclaw models list --provider qwen-token-plan
openclaw agent --model qwen-token-plan/qwen3.7-plus --message "Balas dengan: token plan siap"

Panduan OpenClaw Alibaba menggunakan bailian-token-plan untuk penyedia khusus manual. Plugin mendaftarkan id tersebut sebagai pemilik kompatibilitas, tetapi konfigurasi baru sebaiknya menggunakan qwen-token-plan. Entri khusus models.providers.bailian-token-plan yang persis tetap memiliki transportasi dan katalog yang dikonfigurasikan; entri tersebut tidak pernah digabungkan ke dalam katalog OpenAI kanonis.

Gunakan Token Plan hanya untuk sesi OpenClaw interaktif. Jangan memilihnya untuk tugas cron, skrip tanpa pengawasan, atau backend aplikasi. Alibaba menyatakan bahwa penggunaan noninteraktif dapat menangguhkan langganan atau mencabut kunci API-nya.

Jenis 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`
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 keluarga qwen-*; modelstudio-* tetap hanya untuk kompatibilitas. Timpa dengan baseUrl khusus dalam konfigurasi.

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

Katalog bawaan

OpenClaw mendistribusikan katalog statis Qwen ini. Katalog ini memperhatikan 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 default
`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	Lini Qwen Max
`qwen/qwen3-coder-next`	teks	262,144	Pengodean
`qwen/qwen3-coder-plus`	teks	1,000,000	Pengodean
`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

Ketersediaan masih dapat berbeda menurut endpoint dan paket penagihan meskipun suatu model tercantum dalam katalog statis.

Katalog Token Plan

Token Plan menggunakan daftar yang diizinkan berdasarkan pencocokan string persis yang terpisah. Model paket yang hanya menghasilkan 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 pemikiran

qwen3.7-max, qwen3.7-plus, qwen3.6-flash, dan qwen3.6-plus mendukung penalaran dalam katalog bawaan. Untuk model penalaran pada 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 untuk menggunakan payload pemikiran templat obrolan alternatif dengan menetapkan compat.thinkingFormat: "qwen-chat-template" pada entri model. Model Token Plan juga ditandai mampu melakukan penalaran. kimi-k2.7-code dan MiniMax-M2.5 hanya mendukung pemikiran, sehingga OpenClaw mempertahankan pemikiran tetap aktif bahkan ketika 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 rentang penuh 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.

Pengaya multimodal

Plugin qwen mengekspos kemampuan multimodal hanya pada endpoint DashScope Standard, bukan endpoint Coding Plan:

Pemahaman gambar dan video melalui qwen3.6-plus
Pembuatan video Wan melalui wan2.6-t2v (default), wan2.6-i2v, wan2.6-r2v, wan2.6-r2v-flash, wan2.7-r2v

Pemahaman media diselesaikan secara otomatis dari autentikasi Qwen yang dikonfigurasikan; 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), durasi maksimum 10 detik. Mendukung size, aspectRatio, resolution, audio, dan watermark. Masukan gambar/video referensi memerlukan URL http(s) jarak jauh; jalur file lokal ditolak sejak awal karena endpoint video DashScope tidak menerima buffer lokal yang diunggah untuk referensi tersebut.

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

Konfigurasi lanjutan

Ketersediaan Qwen 3.6 dan 3.7

qwen3.7-plus dan qwen3.6-plus tersedia di endpoint Coding Plan dan Standard. qwen3.7-max dan qwen3.6-flash hanya tersedia di 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 dan kunci Standard 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 mengumumkan kompatibilitas penggunaan streaming pada transportasi openai-completions bersama, 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/v1
https://coding-intl.dashscope.aliyuncs.com/v1
https://dashscope.aliyuncs.com/compatible-mode/v1
https://dashscope-intl.aliyuncs.com/compatible-mode/v1
https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1

Rencana kapabilitas

Plugin qwen diposisikan sebagai pusat penyedia untuk seluruh permukaan Qwen Cloud, bukan hanya model pengodean/teks.

Model teks/obrolan: tersedia melalui plugin
Pemanggilan alat, keluaran terstruktur, penalaran: 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/perangkingan ulang memori: direncanakan melalui permukaan adaptor embedding
Pembuatan video: tersedia melalui plugin lewat kapabilitas 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, 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 Model Studio

Penyedia pembuatan video Wan terpaket pada platform DashScope yang sama.

Pemecahan masalah

Pemecahan masalah umum dan FAQ.

Overview

Concepts and configuration

Providers

Instal plugin

Memulai

Jenis paket dan endpoint

Katalog bawaan

Katalog Token Plan

Kontrol pemikiran

Pengaya multimodal

Konfigurasi lanjutan

Terkait

Pemilihan model

Pembuatan video

Alibaba Model Studio

Pemecahan masalah

​Instal plugin

​Memulai

​Jenis paket dan endpoint

​Katalog bawaan

​Katalog Token Plan

​Kontrol pemikiran

​Pengaya multimodal

​Konfigurasi lanjutan

​Terkait

Pemilihan model

Pembuatan video

Alibaba Model Studio

Pemecahan masalah

Instal plugin

Memulai

Jenis paket dan endpoint

Katalog bawaan

Katalog Token Plan

Kontrol pemikiran

Pengaya multimodal

Konfigurasi lanjutan

Terkait