Providers
Qwen
Qwen Cloud ist ein offizielles externes Provider-Plugin für OpenClaw mit der kanonischen ID qwen. Es ist auf die Endpunkte Qwen Cloud / Alibaba DashScope Standard und Coding Plan ausgerichtet, stellt Token Plan als qwen-token-plan bereit, behält modelstudio als Kompatibilitätsalias bei, verwaltet unabhängig die von Alibaba dokumentierte benutzerdefinierte Provider-ID bailian-token-plan und stellt den Token-Ablauf des Qwen Portal als qwen-oauth bereit.
| Eigenschaft | Wert |
|---|---|
| Provider | qwen |
| Token-Plan-Provider | qwen-token-plan |
| Portal-Provider | qwen-oauth |
| Bevorzugte Umgebungsvariable | QWEN_API_KEY |
| Token-Plan-Umgebungsvariable | QWEN_TOKEN_PLAN_API_KEY |
| Ebenfalls akzeptiert (Kompat.) | MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY |
| API-Stil | OpenAI-kompatibel |
Plugin installieren
qwen wird als offizielles externes Plugin ausgeliefert und ist nicht im Kern gebündelt. Installieren Sie es und starten Sie den Gateway neu:
openclaw plugins install @openclaw/qwen-provideropenclaw gateway restartErste Schritte
Wählen Sie Ihren Plantyp und führen Sie die Einrichtungsschritte aus.
Coding Plan (Abonnement)
Am besten geeignet für: abonnementbasierten Zugriff über den Qwen Coding Plan.
API-Schlüssel abrufen
Erstellen oder kopieren Sie einen API-Schlüssel unter home.qwencloud.com/api-keys.
Onboarding ausführen
Für den globalen Endpunkt:
openclaw onboard --auth-choice qwen-api-keyFür den Endpunkt in China:
openclaw onboard --auth-choice qwen-api-key-cnStandardmodell festlegen
{ agents: { defaults: { model: { primary: "qwen/qwen3.5-plus" }, }, },}Verfügbarkeit des Modells überprüfen
openclaw models list --provider qwenStandard (nutzungsbasierte Abrechnung)
Am besten geeignet für: nutzungsbasierten Zugriff über den Standard-Endpunkt von Model Studio, einschließlich qwen3.7-max und qwen3.6-flash, die im Coding Plan nicht verfügbar sind.
API-Schlüssel abrufen
Erstellen oder kopieren Sie einen API-Schlüssel unter home.qwencloud.com/api-keys.
Onboarding ausführen
Für den globalen Endpunkt:
openclaw onboard --auth-choice qwen-standard-api-keyFür den Endpunkt in China:
openclaw onboard --auth-choice qwen-standard-api-key-cnStandardmodell festlegen
{ agents: { defaults: { model: { primary: "qwen/qwen3.5-plus" }, }, },}Verfügbarkeit des Modells überprüfen
openclaw models list --provider qwenToken Plan (Team Edition)
Am besten geeignet für: guthabenbasierten Team-Abonnementzugriff auf Qwen und unterstützte Modelle von Drittanbietern über Alibaba Cloud Model Studio.
Dedizierten Schlüssel abrufen
Weisen Sie einen Token-Plan-Platz zu und erstellen Sie den zugehörigen dedizierten Schlüssel sk-sp-.... Schlüssel für Token Plan, Coding Plan und nutzungsbasierte Abrechnung sind nicht austauschbar. Weitere Informationen finden Sie in der Übersicht zum globalen Token Plan oder der Übersicht zum Token Plan für China.
Onboarding ausführen
Für den Endpunkt Global / International in Singapur:
openclaw onboard --auth-choice qwen-token-planFür den Endpunkt in China in Peking:
openclaw onboard --auth-choice qwen-token-plan-cnProvider überprüfen
openclaw models list --provider qwen-token-planopenclaw agent --model qwen-token-plan/qwen3.7-plus --message "Antworten Sie mit: Token Plan bereit"Qwen OAuth / Portal
Am besten geeignet für: ein Qwen-Portal-Token für https://portal.qwen.ai/v1.
Informationen zum dedizierten Provider und Hinweise zur Migration finden Sie unter Qwen OAuth / Portal.
Portal-Token angeben
openclaw onboard --auth-choice qwen-oauthStandardmodell festlegen
{ agents: { defaults: { model: { primary: "qwen-oauth/qwen3.5-plus" }, }, },}Verfügbarkeit des Modells überprüfen
openclaw models list --provider qwen-oauthPlantypen und Endpunkte
| Plan | Region | Authentifizierungsauswahl | Endpunkt |
|---|---|---|---|
| Coding Plan (Abonnement) | China | qwen-api-key-cn |
coding.dashscope.aliyuncs.com/v1 |
| Coding Plan (Abonnement) | Global | qwen-api-key |
coding-intl.dashscope.aliyuncs.com/v1 |
| Qwen Portal | Global | qwen-oauth |
portal.qwen.ai/v1 |
| Standard (nutzungsbasierte Abrechnung) | China | qwen-standard-api-key-cn |
dashscope.aliyuncs.com/compatible-mode/v1 |
| Standard (nutzungsbasierte Abrechnung) | Global | qwen-standard-api-key |
dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| Token Plan (Team Edition) | China | qwen-token-plan-cn |
token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 |
| Token Plan (Team Edition) | Global | qwen-token-plan |
token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 |
Der Provider wählt den Endpunkt automatisch anhand Ihrer Authentifizierungsauswahl aus. Kanonische Auswahlmöglichkeiten verwenden die qwen-*-Familie; modelstudio-* dient nur der Kompatibilität.
Sie können dies in der Konfiguration mit einer benutzerdefinierten baseUrl überschreiben.
Integrierter Katalog
OpenClaw liefert diesen statischen Qwen-Katalog aus. Der Katalog berücksichtigt den Endpunkt: Coding-Plan-Konfigurationen lassen Modelle aus, die nur mit dem Standard-Endpunkt funktionieren.
| Modellreferenz | Eingabe | Kontext | Hinweise |
|---|---|---|---|
qwen/qwen3.5-plus |
Text, Bild | 1,000,000 | Standardmodell |
qwen/qwen3.6-flash |
Text, Bild | 1,000,000 | Nur Standard-Endpunkte |
qwen/qwen3.6-plus |
Text, Bild | 1,000,000 | Coding Plan + Standard |
qwen/qwen3.7-max |
Text | 1,000,000 | Nur Standard-Endpunkte |
qwen/qwen3.7-plus |
Text, Bild | 1,000,000 | Coding Plan + Standard |
qwen/qwen3-max-2026-01-23 |
Text | 262,144 | Qwen-Max-Reihe |
qwen/qwen3-coder-next |
Text | 262,144 | Programmierung |
qwen/qwen3-coder-plus |
Text | 1,000,000 | Programmierung |
qwen/MiniMax-M2.5 |
Text | 1,000,000 | Schlussfolgerungen aktiviert |
qwen/glm-5 |
Text | 202,752 | GLM |
qwen/glm-4.7 |
Text | 202,752 | GLM |
qwen/kimi-k2.5 |
Text, Bild | 262,144 | Moonshot AI über Alibaba |
qwen-oauth/qwen3.5-plus |
Text, Bild | 1,000,000 | Qwen-Portal-Standard |
Token-Plan-Katalog
Token Plan verwendet eine separate Positivliste mit exakten Zeichenfolgen. Planmodelle, die ausschließlich der Bilderzeugung dienen, sind hier nicht enthalten, da sie andere APIs verwenden.
| Modellreferenz | Eingabe | Kontext |
|---|---|---|
qwen-token-plan/qwen3.7-max |
Text | 1,000,000 |
qwen-token-plan/qwen3.7-plus |
Text, Bild | 1,000,000 |
qwen-token-plan/qwen3.6-plus |
Text, Bild | 1,000,000 |
qwen-token-plan/qwen3.6-flash |
Text, Bild | 1,000,000 |
qwen-token-plan/deepseek-v4-pro |
Text | 1,000,000 |
qwen-token-plan/deepseek-v4-flash |
Text | 1,000,000 |
qwen-token-plan/deepseek-v3.2 |
Text | 131,072 |
qwen-token-plan/kimi-k2.7-code |
Text, Bild | 262,144 |
qwen-token-plan/kimi-k2.6 |
Text, Bild | 262,144 |
qwen-token-plan/kimi-k2.5 |
Text, Bild | 262,144 |
qwen-token-plan/glm-5.2 |
Text | 1,000,000 |
qwen-token-plan/glm-5.1 |
Text | 202,752 |
qwen-token-plan/glm-5 |
Text | 202,752 |
qwen-token-plan/MiniMax-M2.5 |
Text | 196,608 |
Steuerung des Denkprozesses
qwen3.7-max, qwen3.7-plus, qwen3.6-flash und qwen3.6-plus sind
im integrierten Katalog für Reasoning aktiviert. Bei Reasoning-Modellen der
qwen-Familie ordnet der Provider die Thinking-Stufen von OpenClaw dem
Top-Level-Anfrage-Flag enable_thinking von DashScope zu: Bei deaktiviertem
Thinking wird enable_thinking: false gesendet, bei jeder anderen Stufe
enable_thinking: true. Benutzerdefinierte Modelle können ein alternatives
Thinking-Payload für Chat-Templates aktivieren, indem im Modelleintrag
compat.thinkingFormat: "qwen-chat-template" festgelegt wird.
Token-Plan-Modelle sind ebenfalls als Reasoning-fähig gekennzeichnet.
kimi-k2.7-code und MiniMax-M2.5 unterstützen ausschließlich Thinking.
Daher lässt OpenClaw Thinking aktiviert, selbst wenn die Sitzung /think off
anfordert. DeepSeek V4 ordnet minimal bis high der Aufwandsstufe high des
Dienstes und xhigh oder max der Stufe max zu. GLM 5.2 akzeptiert den
gesamten Bereich von minimal bis max; GLM 5.1 und GLM 5 akzeptieren Stufen
bis xhigh, wobei alle drei standardmäßig high verwenden. Andere
Hybridmodelle folgen dem angeforderten Ein-/Aus-Zustand.
Multimodale Erweiterungen
Das qwen-Plugin stellt multimodale Funktionen ausschließlich an den
Standard-Endpunkten von DashScope bereit, nicht an den
Coding-Plan-Endpunkten:
- Bild- und Videoverständnis ü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
Die Medienanalyse wird automatisch anhand der konfigurierten Qwen-Authentifizierung aufgelöst; es ist keine zusätzliche Konfiguration erforderlich. Stellen Sie sicher, dass Sie einen Standard-Endpunkt (nutzungsabhängige Abrechnung) verwenden, damit die Medienanalyse funktioniert.
So legen Sie Qwen als Standard-Provider für Videos fest:
{ agents: { defaults: { videoGenerationModel: { primary: "qwen/wan2.6-t2v" }, }, },}Beschränkungen der Videogenerierung: 1 Ausgabevideo pro Anfrage, bis zu
1 Eingabebild (Bild-zu-Video), bis zu 4 Eingabevideos (Video-zu-Video),
maximal 10 Sekunden Dauer. Unterstützt size, aspectRatio, resolution,
audio und watermark. Referenzbilder und -videos müssen über entfernte
http(s)-URLs bereitgestellt werden; lokale Dateipfade werden vorab abgelehnt,
da der DashScope-Videoendpunkt für diese Referenzen keine hochgeladenen lokalen
Puffer akzeptiert.
Erweiterte Konfiguration
Verfügbarkeit von Qwen 3.6 und 3.7
qwen3.7-plus und qwen3.6-plus sind an Coding-Plan- und Standard-Endpunkten verfügbar. qwen3.7-max und qwen3.6-flash sind nur an Standard-Endpunkten verfügbar. Die Standard-Endpunkte (nutzungsabhängige Abrechnung) sind:
- China:
dashscope.aliyuncs.com/compatible-mode/v1 - Global:
dashscope-intl.aliyuncs.com/compatible-mode/v1
OpenClaw lässt qwen3.7-max und qwen3.6-flash in Coding-Plan-Katalogen aus.
Wenn ein Coding-Plan-Endpunkt für eines der Modelle den Fehler „unsupported model“ zurückgibt,
wechseln Sie zum entsprechenden Standard-Endpunkt und Schlüssel.
Regionsrouting für die Videogenerierung
OpenClaw ordnet die konfigurierte Qwen-Region dem entsprechenden AIGC-Host von DashScope zu, bevor ein Videoauftrag übermittelt wird:
- Global/Intl:
https://dashscope-intl.aliyuncs.com - China:
https://dashscope.aliyuncs.com
Eine normale models.providers.qwen.baseUrl, die auf einen Coding-Plan-
oder Standard-Qwen-Host verweist, leitet die Videogenerierung weiterhin
an den entsprechenden regionalen DashScope-Videoendpunkt weiter.
Kompatibilität der Streaming-Nutzungsdaten
Native Qwen-Endpunkte weisen für den gemeinsamen
openai-completions-Transport Kompatibilität mit Streaming-Nutzungsdaten
aus. Daher übernehmen DashScope-kompatible benutzerdefinierte Provider-IDs,
die auf dieselben nativen Hosts verweisen, dieses Verhalten, ohne dass
speziell die integrierte Provider-ID qwen erforderlich ist. Dies gilt für
Coding-Plan-, Standard- und Token-Plan-Endpunkte:
https://coding.dashscope.aliyuncs.com/v1https://coding-intl.dashscope.aliyuncs.com/v1https://dashscope.aliyuncs.com/compatible-mode/v1https://dashscope-intl.aliyuncs.com/compatible-mode/v1https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
Funktionsplan
Das qwen-Plugin wird als zentrale Provider-Komponente für den gesamten
Qwen-Cloud-Funktionsumfang positioniert, nicht nur für Coding-/Textmodelle.
- Text-/Chatmodelle: über das Plugin verfügbar
- Tool-Aufrufe, strukturierte Ausgabe, Thinking: vom OpenAI-kompatiblen Transport übernommen
- Bildgenerierung: auf Ebene des Provider-Plugins geplant
- Bild-/Videoverständnis: über das Plugin am Standard-Endpunkt verfügbar
- Sprache/Audio: auf Ebene des Provider-Plugins geplant
- Speicher-Embeddings/Neusortierung: über die Oberfläche des Embedding-Adapters geplant
- Videogenerierung: über das Plugin und die gemeinsame Videogenerierungsfunktion verfügbar
Einrichtung von Umgebung und Daemon
Wenn das Gateway als Daemon (launchd/systemd) ausgeführt wird, stellen Sie
sicher, dass QWEN_API_KEY oder QWEN_TOKEN_PLAN_API_KEY für diesen Prozess
verfügbar ist (beispielsweise in ~/.openclaw/.env oder über
env.shellEnv).
Verwandte Themen
Auswahl von Providern, Modellreferenzen und Failover-Verhalten.
Gemeinsame Parameter des Video-Tools und Provider-Auswahl.
Mitgelieferter Provider für die Wan-Videogenerierung auf derselben DashScope-Plattform.
Allgemeine Fehlerbehebung und häufig gestellte Fragen.