Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 standart kimliği qwen olan birinci sınıf paketlenmiş 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 kimliklerinin uyumluluk takma adı olarak çalışmasını sürdürür.
  • 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 istiyorsanız Standard (pay-as-you-go) uç noktasını tercih edin. Coding Plan desteği, herkese açık kataloğun gerisinde kalabilir.

​
Başlarken

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

Get your API key

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

Run onboarding

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

Set a default model

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

Verify the model is available

openclaw models list --provider qwen
Eski modelstudio-* auth-choice kimlikleri ve modelstudio/... model başvuruları hâlâ uyumluluk takma adları olarak çalışır, ancak yeni kurulum akışları standart qwen-* auth-choice kimliklerini ve qwen/... model başvuruları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/... başvurularına sahip olur.

​
Plan türleri ve uç noktalar

PlanBölgeKimlik doğrulama seçimiUç nokta
Standard (pay-as-you-go)Chinaqwen-standard-api-key-cndashscope.aliyuncs.com/compatible-mode/v1
Standard (pay-as-you-go)Globalqwen-standard-api-keydashscope-intl.aliyuncs.com/compatible-mode/v1
Coding Plan (subscription)Chinaqwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Coding Plan (subscription)Globalqwen-api-keycoding-intl.dashscope.aliyuncs.com/v1
Sağlayıcı, auth choice seçiminize göre uç noktayı otomatik olarak seçer. Standart seçimler qwen-* ailesini kullanır; modelstudio-* yalnızca uyumluluk için kalır. 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ındadır: Coding Plan yapılandırmaları, yalnızca Standard uç noktasında çalıştığı bilinen modelleri hariç tutar.
Model başvurusuGirdiBağ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ını 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 değişebilir.

​
Düşünme Kontrolleri

Akıl yürütme etkin Qwen Cloud modelleri için paketlenmiş 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, Standard DashScope uç noktalarında da çok modlu yetenekler sunar (Coding Plan uç noktalarında değil):
  • 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 oluşturma
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 devretme davranışı için Video Oluşturma bölümüne bakın.

​
Gelişmiş yapılandırma

Paketlenmiş Qwen Plugin, Standard DashScope uç noktalarında görüntüler ve video için medya anlamayı 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ümlenir; ek yapılandırma gerekmez. Medya anlama desteği için Standard (pay-as-you-go) uç noktası kullandığınızdan emin olun.
qwen3.6-plus, Standard (pay-as-you-go) 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 “unsupported model” hatası döndürürse, Coding Plan uç noktası/anahtar çifti yerine Standard (pay-as-you-go) kullanın.OpenClaw’ın paketlenmiş Qwen kataloğu, Coding Plan uç noktalarında qwen3.6-plus ilan etmez, 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 bunu etkinleştirirse bu modeli dahil etmeyi seçebilirsiniz. Çağrının başarılı olup olmayacağına yine yukarı akış API karar verir.
qwen Plugin, yalnızca kodlama/metin modelleri için değil, tam Qwen Cloud yüzeyi için sağlayıcı evi olarak konumlandırılıyor.
  • Metin/sohbet modelleri: şimdi paketlenmiş
  • Araç çağırma, yapılandırılmış çıktı, düşünme: OpenAI uyumlu aktarımdan devralınır
  • Görüntü oluşturma: sağlayıcı-Plugin katmanında planlanıyor
  • Görüntü/video anlama: şimdi Standard uç noktasında paketlenmiş
  • Konuşma/ses: sağlayıcı-Plugin katmanında planlanıyor
  • Bellek gömmeleri/yeniden sıralama: gömme bağdaştırıcısı yüzeyi üzerinden planlanıyor
  • Video oluşturma: paylaşılan video oluşturma yeteneği üzerinden şimdi paketlenmiş
Video oluşturma 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 bile video oluşturmayı doğru bölgesel DashScope video uç noktasında tuttuğu anlamına gelir.Mevcut paketlenmiş Qwen video oluşturma 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 desteklenir
  • Referans görüntü/video modu şu anda uzak http(s) URL’leri gerektirir. DashScope video uç noktası bu referanslar için yüklenmiş yerel arabellekleri kabul etmediğinden yerel dosya yolları baştan reddedilir.
Yerel Model Studio uç noktaları, paylaşılan openai-completions aktarımında akış kullanım uyumluluğunu duyurur. OpenClaw artık bunu uç nokta yeteneklerine göre anahtarlar; bu nedenle 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 makineleri hem de Standard DashScope uyumlu ana makineler 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 oluşturma), 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
  • China Standard temel URL: https://dashscope.aliyuncs.com/compatible-mode/v1
Gateway bir daemon olarak çalışıyorsa (launchd/systemd), QWEN_API_KEY değerinin bu işlem için 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 oluşturma

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.