Ana içeriğe atla

​
Qwen

Qwen OAuth kaldırıldı. portal.qwen.ai uç noktalarını kullanan ücretsiz katman OAuth entegrasyonu (qwen-portal) artık kullanılamıyor. Arka plan için Issue #49557 bölümüne bakın.
OpenClaw artık Qwen’i, kanonik kimliği qwen olan birinci sınıf paketlenmiş bir sağlayıcı olarak ele alır. Paketlenmiş sağlayıcı, Qwen Cloud / Alibaba DashScope ve Coding Plan uç noktalarını hedefler ve eski modelstudio kimliklerini uyumluluk takma adı olarak çalışır durumda tutar.
  • Sağlayıcı: qwen
  • Tercih edilen ortam değişkeni: QWEN_API_KEY
  • Uyumluluk için ayrıca kabul edilir: MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
  • API stili: OpenAI uyumlu
qwen3.6-plus kullanmak istiyorsanız, Standard (kullandıkça öde) uç noktasını tercih edin. Coding Plan desteği, genel kataloğun gerisinde kalabilir.

​
Başlangıç

Plan türünüzü seçin ve kurulum adımlarını izleyin.
En iyi kullanım alanı: 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

Onboarding çalıştırın

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

Varsayılan bir model ayarlayın

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

Modelin kullanılabildiğini doğrulayın

openclaw models list --provider qwen
Eski modelstudio-* auth-choice kimlikleri ve modelstudio/... model referansları uyumluluk takma adları olarak hâlâ çalışır, ancak yeni kurulum akışları kanonik qwen-* auth-choice kimliklerini ve qwen/... model referanslarını tercih etmelidir.

​
Plan türleri ve uç noktalar

PlanBölgeAuth choiceUç nokta
Standard (kullandıkça öde)Çinqwen-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)Çinqwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Coding Plan (abonelik)Globalqwen-api-keycoding-intl.dashscope.aliyuncs.com/v1
Sağlayıcı, auth choice’a göre uç noktayı otomatik seçer. Kanonik seçimler qwen-* ailesini kullanır; modelstudio-* yalnızca uyumluluk içindir. Yapılandırmada özel bir baseUrl ile geçersiz kılabilirsiniz.
Anahtarları yönetin: home.qwencloud.com/api-keys | Belgeler: docs.qwencloud.com

​
Yerleşik katalog

OpenClaw şu anda bu paketlenmiş Qwen kataloğuyla gelir. Yapılandırılan katalog uç nokta farkındalığına sahiptir: Coding Plan yapılandırmaları, yalnızca Standard uç noktada çalıştığı bilinen modelleri dışarıda bırakır.
Model refGirdiBağlamNotlar
qwen/qwen3.5-plusmetin, görüntü1,000,000Varsayılan model
qwen/qwen3.6-plusmetin, görüntü1,000,000Bu modele ihtiyaç duyduğunuzda 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
Bir model paketlenmiş katalogda bulunsa bile kullanılabilirlik, uç noktaya ve faturalandırma planına göre yine de değişebilir.

​
Çok modlu eklentiler

qwen uzantısı ayrıca Standard DashScope uç noktalarında (Coding Plan uç noktalarında değil) çok modlu yetenekler de 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
Varsayılan video sağlayıcısı olarak Qwen 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 Generation bölümüne bakın.

​
Gelişmiş

Paketlenmiş Qwen Plugin’i, görüntüler ve video için medya anlamayı Standard DashScope uç noktalarında kaydeder (Coding Plan uç noktalarında değil).
Ö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ülür — ek yapılandırma gerekmez. Medya anlama desteği için bir Standard (kullandıkça öde) uç noktası kullandığınızdan emin olun.
qwen3.6-plus, Standard (kullandıkça öde) Model Studio uç noktalarında kullanılabilir:
  • Çin: dashscope.aliyuncs.com/compatible-mode/v1
  • Global: dashscope-intl.aliyuncs.com/compatible-mode/v1
Coding Plan uç noktaları qwen3.6-plus için “unsupported model” hatası döndürüyorsa, Coding Plan uç noktası/anahtar ikilisi yerine Standard (kullandıkça öde) kullanın.
qwen uzantısı, yalnızca kodlama/metin modelleri için değil, tam Qwen Cloud yüzeyinin satıcı ana evi olarak konumlandırılıyor.
  • Metin/sohbet modelleri: şimdi paketlenmiş durumda
  • Araç çağırma, yapılandırılmış çıktı, thinking: OpenAI uyumlu taşıma üzerinden devralınır
  • Görüntü üretimi: sağlayıcı Plugin katmanında planlanıyor
  • Görüntü/video anlama: şimdi Standard uç noktada paketlenmiş durumda
  • Konuşma/ses: sağlayıcı Plugin katmanında planlanıyor
  • Bellek embedding/reranking: embedding bağdaştırıcı yüzeyi üzerinden planlanıyor
  • Video üretimi: paylaşılan video üretimi yeteneği üzerinden şimdi paketlenmiş durumda
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
  • Çin: https://dashscope.aliyuncs.com
Bu, Coding Plan ya da Standard Qwen ana makinelerinden birini işaret eden normal bir models.providers.qwen.baseUrl değerinin bile video üretimini doğru bölgesel DashScope video uç noktasında tuttuğu anlamına gelir.Mevcut paketlenmiş Qwen video üretimi sınırları:
  • İstek başına en fazla 1 çıktı videosu
  • En fazla 1 giriş görüntüsü
  • En fazla 4 giriş 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üklenmiş yerel tamponları kabul etmez.
Yerel Model Studio uç noktaları, paylaşılan openai-completions taşımasında akış kullanım uyumluluğu sunduğunu bildirir. OpenClaw bunu artık uç nokta yeteneklerine göre belirler; böylece aynı yerel ana makineleri 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 makinelerine hem de Standard DashScope uyumlu ana makinelere uygulanır:
  • 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, Standard DashScope uç noktalarını kullanır:
  • Global/Intl Standard temel URL: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
  • Çin Standard 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 erişilebilir 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.