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:

bash
openclaw plugins install @openclaw/qwen-provideropenclaw gateway restart

Erste 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:

    bash
    openclaw onboard --auth-choice qwen-api-key

    Für den Endpunkt in China:

    bash
    openclaw onboard --auth-choice qwen-api-key-cn
  • Standardmodell festlegen

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • Verfügbarkeit des Modells überprüfen

    bash
    openclaw models list --provider qwen
  • Standard (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:

    bash
    openclaw onboard --auth-choice qwen-standard-api-key

    Für den Endpunkt in China:

    bash
    openclaw onboard --auth-choice qwen-standard-api-key-cn
  • Standardmodell festlegen

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • Verfügbarkeit des Modells überprüfen

    bash
    openclaw models list --provider qwen
  • Token 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:

    bash
    openclaw onboard --auth-choice qwen-token-plan

    Für den Endpunkt in China in Peking:

    bash
    openclaw onboard --auth-choice qwen-token-plan-cn
  • Provider überprüfen

    bash
    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:

    json5
    {  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/v1
    • https://coding-intl.dashscope.aliyuncs.com/v1
    • https://dashscope.aliyuncs.com/compatible-mode/v1
    • https://dashscope-intl.aliyuncs.com/compatible-mode/v1
    • https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
    • https://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

    Was this useful?
    On this page

    On this page