Providers

Qwen

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

Instal Plugin

Instal Plugin resmi, lalu mulai ulang Gateway:

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

Memulai

Pilih jenis paket Anda dan ikuti langkah-langkah penyiapan.

Coding Plan (subscription)

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:

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

    Untuk endpoint China:

    bash
    openclaw onboard --auth-choice qwen-api-key-cn
  • Set a default model

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • Verify the model is available

    bash
    openclaw models list --provider qwen
  • Standard (pay-as-you-go)

    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:

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

    Untuk endpoint China:

    bash
    openclaw onboard --auth-choice qwen-standard-api-key-cn
  • Set a default model

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • Verify the model is available

    bash
    openclaw models list --provider qwen
  • Qwen OAuth / Portal

    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

    bash
    openclaw onboard --auth-choice qwen-oauth
  • Set a default model

    json5
    {  agents: {    defaults: {      model: { primary: "qwen-oauth/qwen3.5-plus" },    },  },}
  • Verify the model is available

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

    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

    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:

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

    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

    Was this useful?
    On this page

    On this page