Ana içeriğe atla
OpenClaw artık Qwen’i kanonik kimliği qwen olan birinci sınıf sağlayıcı Plugin’i olarak ele alır. Sağlayıcı Plugin’i Qwen Cloud / Alibaba DashScope ve Coding Plan uç noktalarını hedefler, eski modelstudio kimliklerini uyumluluk takma adı olarak çalışır durumda tutar ve Qwen Portal belirteci akışını da qwen-oauth sağlayıcısı olarak sunar.
  • Sağlayıcı: qwen
  • Portal sağlayıcısı: qwen-oauth
  • Tercih edilen ortam değişkeni: QWEN_API_KEY
  • Uyumluluk için de kabul edilir: MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
  • API stili: OpenAI uyumlu
qwen3.6-plus istiyorsanız Standard (kullandıkça öde) uç noktasını tercih edin. Coding Plan desteği genel kataloğun gerisinde kalabilir.

Plugin’i yükle

Resmi Plugin’i yükleyin, ardından Gateway’i yeniden başlatın:
openclaw plugins install @openclaw/qwen-provider
openclaw gateway restart

Başlarken

Plan türünüzü seçin ve kurulum adımlarını izleyin.
En uygun kullanım: Qwen Coding Plan üzerinden abonelik tabanlı erişim.
1

API anahtarınızı alın

home.qwencloud.com/api-keys adresinden bir API anahtarı oluşturun veya kopyalayın.
2

İlk kurulumu çalıştırın

Global uç nokta için:
openclaw onboard --auth-choice qwen-api-key
China uç noktası için:
openclaw onboard --auth-choice qwen-api-key-cn
3

Varsayılan model ayarlayın

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

Modelin kullanılabilir olduğunu doğrulayın

openclaw models list --provider qwen
Eski modelstudio-* auth-choice kimlikleri ve modelstudio/... model referansları uyumluluk takma adları olarak çalışmaya devam eder, ancak yeni kurulum akışları kanonik qwen-* auth-choice kimliklerini ve qwen/... model referanslarını tercih etmelidir. Başka bir api değerine sahip tam eşleşen özel bir models.providers.modelstudio girdisi tanımlarsanız, bu özel sağlayıcı Qwen uyumluluk takma adı yerine modelstudio/... referanslarının sahibi olur.

Plan türleri ve uç noktalar

PlanBölgeKimlik doğrulama seçimiUç nokta
Standard (kullandıkça öde)Chinaqwen-standard-api-key-cndashscope.aliyuncs.com/compatible-mode/v1
Standard (kullandıkça öde)Globalqwen-standard-api-keydashscope-intl.aliyuncs.com/compatible-mode/v1
Coding Plan (abonelik)Chinaqwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Coding Plan (abonelik)Globalqwen-api-keycoding-intl.dashscope.aliyuncs.com/v1
Qwen PortalGlobalqwen-oauthportal.qwen.ai/v1
Sağlayıcı, kimlik doğrulama seçiminize göre uç noktayı otomatik seçer. Kanonik seçimler qwen-* ailesini kullanır; modelstudio-* yalnızca uyumluluk için kalır. Yapılandırmada özel bir baseUrl ile bunu geçersiz kılabilirsiniz.
Anahtarları yönetin: home.qwencloud.com/api-keys | Belgeler: docs.qwencloud.com

Yerleşik katalog

OpenClaw şu anda bu Qwen statik kataloğunu gönderir. Yapılandırılan katalog uç nokta duyarlıdır: Coding Plan yapılandırmaları yalnızca Standard uç noktada çalıştığı bilinen modelleri dışarıda bırakır.
Model referansıGirdiBağlamNotlar
qwen/qwen3.5-plusmetin, görüntü1,000,000Varsayılan model
qwen/qwen3.6-plusmetin, görüntü1,000,000Bu modele ihtiyacınız olduğunda Standard uç noktaları tercih edin
qwen/qwen3-max-2026-01-23metin262,144Qwen Max serisi
qwen/qwen3-coder-nextmetin262,144Kodlama
qwen/qwen3-coder-plusmetin1,000,000Kodlama
qwen/MiniMax-M2.5metin1,000,000Akıl yürütme etkin
qwen/glm-5metin202,752GLM
qwen/glm-4.7metin202,752GLM
qwen/kimi-k2.5metin, görüntü262,144Alibaba üzerinden Moonshot AI
qwen-oauth/qwen3.5-plusmetin, görüntü1,000,000Qwen Portal varsayılanı
Bir model statik katalogda mevcut olsa bile kullanılabilirlik uç noktaya ve faturalandırma planına göre değişebilir.

Düşünme denetimleri

Akıl yürütme etkin Qwen Cloud modelleri için sağlayıcı, OpenClaw düşünme düzeylerini DashScope’un üst düzey enable_thinking istek bayrağına eşler. Devre dışı düşünme enable_thinking: false gönderir; diğer düşünme düzeyleri enable_thinking: true gönderir.

Çok modlu eklentiler

qwen Plugin’i ayrıca Standard DashScope uç noktalarında (Coding Plan uç noktalarında değil) çok modlu yetenekler sunar:
  • qwen-vl-max-latest üzerinden video anlama
  • wan2.6-t2v (varsayılan), wan2.6-i2v, wan2.6-r2v, wan2.6-r2v-flash, wan2.7-r2v üzerinden Wan video üretimi
Qwen’i varsayılan video sağlayıcısı olarak kullanmak için:
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
    },
  },
}
Paylaşılan araç parametreleri, sağlayıcı seçimi ve yük devretme davranışı için Video Üretimi sayfasına bakın.

Gelişmiş yapılandırma

Qwen Plugin’i, Standard DashScope uç noktalarında (Coding Plan uç noktalarında değil) görüntüler ve video için medya anlama kaydı yapar.
ÖzellikDeğer
Modelqwen-vl-max-latest
Desteklenen girdiGörüntüler, video
Medya anlama, yapılandırılmış Qwen kimlik doğrulamasından otomatik olarak çözümlenir; ek yapılandırma gerekmez. Medya anlama desteği için Standard (kullandıkça öde) uç nokta kullandığınızdan emin olun.
qwen3.6-plus, Standard (kullandıkça öde) Model Studio uç noktalarında kullanılabilir:
  • China: dashscope.aliyuncs.com/compatible-mode/v1
  • Global: dashscope-intl.aliyuncs.com/compatible-mode/v1
Coding Plan uç noktaları qwen3.6-plus için “desteklenmeyen model” hatası döndürürse, Coding Plan uç noktası/anahtar çifti yerine Standard (kullandıkça öde) seçeneğine geçin.OpenClaw’ın Qwen statik kataloğu, Coding Plan uç noktalarında qwen3.6-plus reklamı yapmaz, ancak models.providers.qwen.models altında açıkça yapılandırılmış qwen/qwen3.6-plus girdileri Coding Plan baseUrl’lerinde dikkate alınır; böylece Aliyun aboneliğinizde etkinleştirirse bu modeli kullanıma alabilirsiniz. Çağrının başarılı olup olmayacağına yine üst API karar verir.
qwen Plugin’i, yalnızca kodlama/metin modelleri için değil, tam Qwen Cloud yüzeyi için sağlayıcı merkezi olarak konumlandırılıyor.
  • Metin/sohbet modelleri: Plugin üzerinden kullanılabilir
  • Araç çağırma, yapılandırılmış çıktı, düşünme: OpenAI uyumlu aktarımdan devralınır
  • Görüntü üretimi: sağlayıcı-Plugin katmanında planlanıyor
  • Görüntü/video anlama: Plugin üzerinden Standard uç noktada kullanılabilir
  • Konuşma/ses: sağlayıcı-Plugin katmanında planlanıyor
  • Bellek embedding’leri/yeniden sıralama: embedding bağdaştırıcısı yüzeyi üzerinden planlanıyor
  • Video üretimi: paylaşılan video üretimi yeteneği üzerinden Plugin aracılığıyla kullanılabilir
Video üretimi için OpenClaw, işi göndermeden önce yapılandırılmış Qwen bölgesini eşleşen DashScope AIGC ana makinesine eşler:
  • Global/Intl: https://dashscope-intl.aliyuncs.com
  • China: https://dashscope.aliyuncs.com
Bu, Coding Plan veya Standard Qwen ana makinelerinden birini işaret eden normal bir models.providers.qwen.baseUrl değerinin video üretimini yine doğru bölgesel DashScope video uç noktasında tuttuğu anlamına gelir.Geçerli Qwen video üretimi sınırları:
  • İstek başına en fazla 1 çıktı videosu
  • En fazla 1 girdi görüntüsü
  • En fazla 4 girdi videosu
  • En fazla 10 saniye süre
  • size, aspectRatio, resolution, audio ve watermark destekler
  • Referans görüntü/video modu şu anda uzak http(s) URL’leri gerektirir. Yerel dosya yolları en baştan reddedilir çünkü DashScope video uç noktası bu referanslar için yüklenen yerel tamponları kabul etmez.
Yerel Model Studio uç noktaları, paylaşılan openai-completions taşıması üzerinde akış kullanımı uyumluluğunu duyurur. OpenClaw artık bunu uç nokta yeteneklerine göre belirler; bu nedenle aynı yerel ana bilgisayarları hedefleyen DashScope uyumlu özel sağlayıcı kimlikleri, özellikle yerleşik qwen sağlayıcı kimliğini gerektirmek yerine aynı akış-kullanımı davranışını devralır.Yerel akış kullanımı uyumluluğu, hem Coding Plan ana bilgisayarları hem de Standart DashScope uyumlu ana bilgisayarlar için geçerlidir:
  • 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
Çok modlu yüzeyler (video anlama ve Wan video üretimi), Coding Plan uç noktalarını değil, Standart DashScope uç noktalarını kullanır:
  • Global/Intl Standart temel URL: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
  • Çin Standart temel URL: https://dashscope.aliyuncs.com/compatible-mode/v1
Gateway bir daemon olarak çalışıyorsa (launchd/systemd), QWEN_API_KEY değerinin bu süreç tarafından kullanılabilir olduğundan emin olun (örneğin ~/.openclaw/.env içinde veya env.shellEnv aracılığıyla).

İlgili

Model seçimi

Sağlayıcıları, model referanslarını ve yük devretme davranışını seçme.

Video üretimi

Paylaşılan video aracı parametreleri ve sağlayıcı seçimi.

Alibaba (ModelStudio)

Eski ModelStudio sağlayıcısı ve geçiş notları.

Sorun giderme

Genel sorun giderme ve SSS.