Zum Hauptinhalt springen

Qwen

Qwen OAuth wurde entfernt. Die Free-Tier-OAuth-Integration (qwen-portal), die portal.qwen.ai-Endpunkte verwendete, ist nicht mehr verfügbar. Hintergrundinformationen finden Sie unter Issue #49557.
OpenClaw behandelt Qwen jetzt als erstklassigen gebündelten Provider mit der kanonischen ID qwen. Der gebündelte Provider zielt auf die Endpunkte von Qwen Cloud / Alibaba DashScope und Coding Plan und hält ältere modelstudio-IDs als Kompatibilitätsalias funktionsfähig.
  • Provider: qwen
  • Bevorzugte Umgebungsvariable: QWEN_API_KEY
  • Aus Kompatibilitätsgründen ebenfalls akzeptiert: MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
  • API-Stil: OpenAI-kompatibel
Wenn Sie qwen3.6-plus verwenden möchten, bevorzugen Sie den Endpunkt Standard (pay-as-you-go). Die Unterstützung im Coding Plan kann dem öffentlichen Katalog hinterherhinken.

Erste Schritte

Wählen Sie Ihren Tariftyp und folgen Sie den Einrichtungsschritten.
Am besten geeignet für: abonnementbasierten Zugriff über den Qwen Coding Plan.
1

Get your API key

Erstellen Sie einen API-Schlüssel oder kopieren Sie ihn von home.qwencloud.com/api-keys.
2

Run onboarding

Für den Endpunkt Global:
openclaw onboard --auth-choice qwen-api-key
Für den Endpunkt China:
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
Ältere modelstudio-*-auth-choice-IDs und modelstudio/...-Modell-Refs funktionieren weiterhin als Kompatibilitätsalias, aber neue Einrichtungsabläufe sollten die kanonischen qwen-*-auth-choice-IDs und qwen/...-Modell-Refs bevorzugen.

Tariftypen und Endpunkte

TarifRegionAuth choiceEndpunkt
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
Der Provider wählt den Endpunkt automatisch anhand Ihrer auth-choice aus. Kanonische Optionen verwenden die Familie qwen-*; modelstudio-* ist nur noch Kompatibilität. Sie können dies mit einer benutzerdefinierten baseUrl in der Konfiguration überschreiben.
Schlüssel verwalten: home.qwencloud.com/api-keys | Dokumentation: docs.qwencloud.com

Integrierter Katalog

OpenClaw liefert derzeit diesen gebündelten Qwen-Katalog mit aus. Der konfigurierte Katalog ist endpunktabhängig: Coding-Plan-Konfigurationen lassen Modelle aus, von denen nur bekannt ist, dass sie am Standard-Endpunkt funktionieren.
Modell-RefEingabeKontextHinweise
qwen/qwen3.5-plusText, Bild1,000,000Standardmodell
qwen/qwen3.6-plusText, Bild1,000,000Bevorzugen Sie Standard-Endpunkte, wenn Sie dieses Modell benötigen
qwen/qwen3-max-2026-01-23Text262,144Qwen-Max-Linie
qwen/qwen3-coder-nextText262,144Coding
qwen/qwen3-coder-plusText1,000,000Coding
qwen/MiniMax-M2.5Text1,000,000Thinking aktiviert
qwen/glm-5Text202,752GLM
qwen/glm-4.7Text202,752GLM
qwen/kimi-k2.5Text, Bild262,144Moonshot AI über Alibaba
Die Verfügbarkeit kann weiterhin je nach Endpunkt und Abrechnungstarif variieren, auch wenn ein Modell im gebündelten Katalog vorhanden ist.

Multimodale Erweiterungen

Die Erweiterung qwen stellt auch multimodale Fähigkeiten an den Standard- DashScope-Endpunkten bereit (nicht an den Coding-Plan-Endpunkten):
  • Video Understanding über qwen-vl-max-latest
  • Wan-Videogenerierung über wan2.6-t2v (Standard), wan2.6-i2v, wan2.6-r2v, wan2.6-r2v-flash, wan2.7-r2v
So verwenden Sie Qwen als Standard-Video-Provider:
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
    },
  },
}
Siehe Video Generation für gemeinsame Tool-Parameter, Provider-Auswahl und Failover-Verhalten.

Erweitert

Das gebündelte Qwen-Plugin registriert Media Understanding für Bilder und Video an den Standard-DashScope-Endpunkten (nicht an den Coding-Plan-Endpunkten).
EigenschaftWert
Modellqwen-vl-max-latest
Unterstützte EingabeBilder, Video
Media Understanding wird automatisch aus der konfigurierten Qwen-Authentifizierung aufgelöst — es ist keine zusätzliche Konfiguration erforderlich. Stellen Sie sicher, dass Sie einen Standard-Endpunkt (pay-as-you-go) für die Unterstützung von Media Understanding verwenden.
qwen3.6-plus ist an den Standard-Model-Studio-Endpunkten (pay-as-you-go) verfügbar:
  • China: dashscope.aliyuncs.com/compatible-mode/v1
  • Global: dashscope-intl.aliyuncs.com/compatible-mode/v1
Wenn die Coding-Plan-Endpunkte für qwen3.6-plus einen Fehler „unsupported model“ zurückgeben, wechseln Sie zu Standard (pay-as-you-go) statt zum Endpunkt-/Schlüsselpaar des Coding Plan.
Die Erweiterung qwen wird als Anbieter-Heimat für die vollständige Qwen- Cloud-Oberfläche positioniert, nicht nur für Coding-/Text-Modelle.
  • Text-/Chat-Modelle: jetzt gebündelt
  • Tool Calling, strukturierte Ausgabe, Thinking: vom OpenAI-kompatiblen Transport geerbt
  • Bildgenerierung: auf der Ebene des Provider-Plugins geplant
  • Bild-/Videoverständnis: jetzt am Standard-Endpunkt gebündelt
  • Sprache/Audio: auf der Ebene des Provider-Plugins geplant
  • Memory-Embeddings/Reranking: über die Oberfläche des Embedding-Adapters geplant
  • Videogenerierung: jetzt über die gemeinsame Video-Generation-Capability gebündelt
Für die Videogenerierung ordnet OpenClaw die konfigurierte Qwen-Region dem passenden DashScope-AIGC-Host zu, bevor der Auftrag übermittelt wird:
  • Global/Intl: https://dashscope-intl.aliyuncs.com
  • China: https://dashscope.aliyuncs.com
Das bedeutet, dass eine normale models.providers.qwen.baseUrl, die auf einen der Coding-Plan- oder Standard-Qwen-Hosts zeigt, die Videogenerierung weiterhin auf dem korrekten regionalen DashScope-Video-Endpunkt hält.Aktuelle gebündelte Qwen-Grenzwerte für die Videogenerierung:
  • Bis zu 1 Ausgabevideo pro Anfrage
  • Bis zu 1 Eingabebild
  • Bis zu 4 Eingabevideos
  • Bis zu 10 Sekunden Dauer
  • Unterstützt size, aspectRatio, resolution, audio und watermark
  • Der Referenzbild-/Videomodus erfordert derzeit entfernte http(s)-URLs. Lokale Dateipfade werden sofort abgelehnt, weil der DashScope-Video-Endpunkt keine hochgeladenen lokalen Buffer für diese Referenzen akzeptiert.
Native Model-Studio-Endpunkte melden Streaming-Nutzungskompatibilität für den gemeinsamen Transport openai-completions. OpenClaw richtet sich jetzt nach den Endpunkt-Capabilities, sodass DashScope-kompatible benutzerdefinierte Provider-IDs, die auf dieselben nativen Hosts zielen, dasselbe Streaming-Nutzungsverhalten erben, statt ausdrücklich die integrierte Provider-ID qwen zu erfordern.Native Streaming-Nutzungskompatibilität gilt sowohl für die Coding-Plan-Hosts als auch für die Standard-DashScope-kompatiblen Hosts:
  • 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
Multimodale Oberflächen (Video Understanding und Wan-Videogenerierung) verwenden die Standard-DashScope-Endpunkte, nicht die Coding-Plan-Endpunkte:
  • Global/Intl Standard-Basis-URL: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
  • China Standard-Basis-URL: https://dashscope.aliyuncs.com/compatible-mode/v1
Wenn das Gateway als Daemon läuft (launchd/systemd), stellen Sie sicher, dass QWEN_API_KEY für diesen Prozess verfügbar ist (zum Beispiel in ~/.openclaw/.env oder über env.shellEnv).

Verwandt

Modellauswahl

Auswahl von Providern, Modell-Referenzen und Failover-Verhalten.

Video Generation

Gemeinsame Parameter des Video-Tools und Provider-Auswahl.

Alibaba (ModelStudio)

Älterer ModelStudio-Provider und Migrationshinweise.

Fehlerbehebung

Allgemeine Fehlerbehebung und FAQ.