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:

bash
openclaw plugins install @openclaw/qwen-provideropenclaw gateway restart

Memulai

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:

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

    Untuk endpoint China:

    bash
    openclaw onboard --auth-choice qwen-api-key-cn
  • Tetapkan model bawaan

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

    bash
    openclaw models list --provider qwen
  • Standard (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:

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

    Untuk endpoint China:

    bash
    openclaw onboard --auth-choice qwen-standard-api-key-cn
  • Tetapkan model bawaan

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

    bash
    openclaw models list --provider qwen
  • Token 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:

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

    Untuk endpoint China di Beijing:

    bash
    openclaw onboard --auth-choice qwen-token-plan-cn
  • Verifikasi penyedia

    bash
    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

    bash
    openclaw onboard --auth-choice qwen-oauth
  • Tetapkan model bawaan

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

    bash
    openclaw models list --provider qwen-oauth
  • 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
    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:

    json5
    {  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/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 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

    Was this useful?
    On this page

    On this page