Providers
Qwen
Qwen Cloud ist ein offizielles externes Provider-Plugin für OpenClaw mit der kanonischen ID qwen. Es ist für die Qwen-Cloud-/Alibaba-DashScope-Endpunkte für Standard und Coding Plan vorgesehen, stellt Token Plan als qwen-token-plan bereit, behält modelstudio als Kompatibilitätsalias bei und verwaltet unabhängig die dokumentierte benutzerdefinierte Provider-ID bailian-token-plan von Alibaba.
| Eigenschaft | Wert |
|---|---|
| Provider | qwen |
| Token-Plan-Provider | qwen-token-plan |
| 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 dessen dedizierten Schlüssel sk-sp-.... Schlüssel für Token Plan, Coding Plan und nutzungsbasierte Abrechnung sind nicht untereinander 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 globalen/internationalen Endpunkt 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"Plantypen 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 |
| Standard (nutzungsbasiert) | China | qwen-standard-api-key-cn |
dashscope.aliyuncs.com/compatible-mode/v1 |
| Standard (nutzungsbasiert) | 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 Familie qwen-*; modelstudio-* bleibt ausschließlich zur Kompatibilität erhalten.
Überschreiben Sie dies mit einem benutzerdefinierten baseUrl in der Konfiguration.
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 | Schlussfolgerung 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 |
Token-Plan-Katalog
Token Plan verwendet eine separate Zulassungsliste mit exakter Zeichenfolgenübereinstimmung. Ausschließlich zur Bilderzeugung vorgesehene Planmodelle 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
unterstützen im integrierten Katalog Schlussfolgerungen. Bei Schlussfolgerungsmodellen der Familie qwen
ordnet der Provider die OpenClaw-Denkstufen dem Anfrageflag enable_thinking auf oberster Ebene von DashScope zu:
Bei deaktiviertem Denken wird enable_thinking: false gesendet, bei jeder anderen Stufe
enable_thinking: true. Benutzerdefinierte Modelle können sich für eine alternative
Denknutzlast der Chatvorlage entscheiden, indem im Modelleintrag
compat.thinkingFormat: "qwen-chat-template" festgelegt wird.
Token-Plan-Modelle sind ebenfalls als schlussfolgerungsfähig gekennzeichnet. kimi-k2.7-code und
MiniMax-M2.5 funktionieren ausschließlich mit aktiviertem Denken. Daher lässt OpenClaw das Denken aktiviert, selbst wenn
die Sitzung /think off anfordert. DeepSeek V4 ordnet minimal bis high
dem Aufwand high des Dienstes zu und ordnet xhigh oder max max zu. GLM 5.2 akzeptiert
den gesamten Bereich von minimal bis max; GLM 5.1 und GLM 5 akzeptieren Werte bis
xhigh, und alle drei verwenden standardmäßig high. Andere Hybridmodelle folgen dem
angeforderten Ein-/Aus-Zustand.
Multimodale Erweiterungen
Das Plugin qwen stellt multimodale Funktionen ausschließlich auf den Standard-Endpunkten von DashScope
bereit, nicht auf den Coding-Plan-Endpunkten:
- Bild- und Videoverständnis über
qwen3.6-plus - 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 (nutzungsbasierte Abrechnung) verwenden, damit die Medienanalyse funktioniert.
So legen Sie Qwen als Standard-Video-Provider fest:
{ agents: { defaults: { videoGenerationModel: { primary: "qwen/wan2.6-t2v" }, }, },}Beschränkungen für die 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. Referenzbild-/-videoeingaben erfordern entfernte http(s)-URLs; lokale
Dateipfade werden vorab abgelehnt, da der DashScope-Videoendpunkt keine
hochgeladenen lokalen Puffer für diese Referenzen akzeptiert.
Erweiterte Konfiguration
Verfügbarkeit von Qwen 3.6 und 3.7
qwen3.7-plus und qwen3.6-plus sind über Coding-Plan- und Standard-Endpunkte verfügbar. qwen3.7-max und qwen3.6-flash sind nur über Standard 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 passenden DashScope-AIGC-Host zu, bevor ein Videoauftrag übermittelt wird:
- Global/Intl:
https://dashscope-intl.aliyuncs.com - China:
https://dashscope.aliyuncs.com
Ein normaler models.providers.qwen.baseUrl, der entweder auf die Coding-Plan-
oder Standard-Qwen-Hosts verweist, leitet die Videogenerierung dennoch an den passenden
regionalen DashScope-Videoendpunkt weiter.
Kompatibilität der Streaming-Nutzungsdaten
Native Qwen-Endpunkte geben die Kompatibilität von Streaming-Nutzungsdaten für den gemeinsamen
openai-completions-Transport an. Daher übernehmen DashScope-kompatible benutzerdefinierte Provider-IDs,
die auf dieselben nativen Hosts verweisen, dasselbe Verhalten, ohne dass ausdrücklich
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 Plugin qwen wird als zentraler Ort des Anbieters für den vollständigen Qwen-
Cloud-Funktionsumfang positioniert, nicht nur für Coding-/Textmodelle.
- Text-/Chatmodelle: über das Plugin verfügbar
- Tool-Aufrufe, strukturierte Ausgabe, Denken: vom OpenAI-kompatiblen Transport übernommen
- Bildgenerierung: auf der Provider-Plugin-Ebene geplant
- Bild-/Videoverständnis: über das Plugin am Standard-Endpunkt verfügbar
- Sprache/Audio: auf der Provider-Plugin-Ebene geplant
- Speicher-Embeddings/Neusortierung: über die Embedding-Adapter-Schnittstelle geplant
- Videogenerierung: über das Plugin mittels der gemeinsamen Videogenerierungsfunktion verfügbar
Umgebungs- und Daemon-Einrichtung
Wenn der 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 (zum Beispiel in
~/.openclaw/.env oder über env.shellEnv).
Verwandte Themen
Auswahl von Providern, Modellreferenzen und Failover-Verhalten.
Gemeinsame Video-Tool-Parameter und Provider-Auswahl.
Mitgelieferter Provider für die Wan-Videogenerierung auf derselben DashScope-Plattform.
Allgemeine Fehlerbehebung und häufig gestellte Fragen.