Zum Hauptinhalt springen

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 wurde entfernt. Die OAuth-Integration der kostenlosen Stufe (qwen-portal), die portal.qwen.ai-Endpunkte verwendete, ist nicht mehr verfügbar. Siehe Issue #49557 für Hintergrundinformationen.
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 ab und sorgt dafür, dass ältere modelstudio-IDs als Kompatibilitätsalias weiter funktionieren.
  • 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 Standard-Endpunkt (Pay-as-you-go). Die Unterstützung im Coding Plan kann hinter dem öffentlichen Katalog zurückbleiben.

​
Erste Schritte

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

API-Schlüssel abrufen

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

Onboarding ausführen

Für den globalen Endpunkt:
openclaw onboard --auth-choice qwen-api-key
Für den China-Endpunkt:
openclaw onboard --auth-choice qwen-api-key-cn
3

Standardmodell festlegen

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

Verfügbarkeit des Modells prüfen

openclaw models list --provider qwen
Ältere modelstudio-*-Auth-Choice-IDs und modelstudio/...-Modellreferenzen funktionieren weiterhin als Kompatibilitätsalias, aber neue Einrichtungsabläufe sollten die kanonischen qwen-*-Auth-Choice-IDs und qwen/...-Modellreferenzen bevorzugen. Wenn Sie einen exakt passenden benutzerdefinierten Eintrag models.providers.modelstudio mit einem anderen api-Wert definieren, besitzt dieser benutzerdefinierte Provider die modelstudio/...-Referenzen anstelle des Qwen-Kompatibilitätsalias.

​
Plantypen und Endpunkte

PlanRegionAuth-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 (Abonnement)Chinaqwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Coding Plan (Abonnement)Globalqwen-api-keycoding-intl.dashscope.aliyuncs.com/v1
Der Provider wählt den Endpunkt automatisch anhand Ihrer Auth-Choice aus. Kanonische Optionen verwenden die qwen-*-Familie; modelstudio-* bleibt nur für Kompatibilität erhalten. 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 aus. Der konfigurierte Katalog ist endpunktbewusst: Coding-Plan-Konfigurationen lassen Modelle aus, von denen nur bekannt ist, dass sie am Standard-Endpunkt funktionieren.
ModellreferenzEingabeKontextHinweise
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-Reihe
qwen/qwen3-coder-nextText262,144Coding
qwen/qwen3-coder-plusText1,000,000Coding
qwen/MiniMax-M2.5Text1,000,000Reasoning 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 Abrechnungsplan variieren, auch wenn ein Modell im gebündelten Katalog vorhanden ist.

​
Thinking-Steuerung

Für Qwen-Cloud-Modelle mit Reasoning-Unterstützung ordnet der gebündelte Provider die Thinking-Stufen von OpenClaw dem DashScope-Anfrageflag enable_thinking auf oberster Ebene zu. Deaktiviertes Thinking sendet enable_thinking: false; andere Thinking-Stufen senden enable_thinking: true.

​
Multimodale Add-ons

Das qwen-Plugin stellt außerdem multimodale Funktionen auf den Standard- DashScope-Endpunkten bereit (nicht auf den Coding-Plan-Endpunkten):
  • Videoverstehen ü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-Provider für Video: 
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
    },
  },
}
Siehe Videogenerierung für gemeinsame Tool-Parameter, Provider-Auswahl und Failover-Verhalten.

​
Erweiterte Konfiguration

Das gebündelte Qwen-Plugin registriert Medienverstehen für Bilder und Videos auf den Standard-DashScope-Endpunkten (nicht auf den Coding-Plan-Endpunkten).
EigenschaftWert
Modellqwen-vl-max-latest
Unterstützte EingabeBilder, Video
Medienverstehen 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 Unterstützung beim Medienverstehen verwenden.
qwen3.6-plus ist auf 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 wegen eines „nicht unterstützten Modells“ zurückgeben, wechseln Sie zu Standard (Pay-as-you-go) statt zum Endpunkt-/Schlüsselpaar des Coding Plan.Der gebündelte Qwen-Katalog von OpenClaw bewirbt qwen3.6-plus nicht auf Coding- Plan-Endpunkten, aber explizit konfigurierte qwen/qwen3.6-plus-Einträge unter models.providers.qwen.models werden auf Coding-Plan-BaseUrls berücksichtigt, sodass Sie dieses Modell aktivieren können, falls Aliyun es für Ihr Abonnement freischaltet. Die Upstream-API entscheidet weiterhin, ob der Aufruf erfolgreich ist.
Das qwen-Plugin wird als Hersteller-Home für die gesamte Qwen- Cloud-Oberfläche positioniert, nicht nur für Coding-/Textmodelle.
  • Text-/Chatmodelle: jetzt gebündelt
  • Tool-Aufrufe, strukturierte Ausgabe, Thinking: vom OpenAI-kompatiblen Transport geerbt
  • Bildgenerierung: auf der Provider-Plugin-Ebene geplant
  • Bild-/Videoverstehen: jetzt auf dem Standard-Endpunkt gebündelt
  • Sprache/Audio: auf der Provider-Plugin-Ebene geplant
  • Memory Embeddings/Reranking: über die Embedding-Adapter-Oberfläche geplant
  • Videogenerierung: jetzt über die gemeinsame Videogenerierungsfunktion 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 entweder auf die Coding-Plan- oder Standard-Qwen-Hosts zeigt, die Videogenerierung weiterhin auf dem korrekten regionalen DashScope-Videoendpunkt hält.Aktuelle gebündelte Limits für Qwen-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-/Referenzvideomodus erfordert derzeit entfernte http(s)-URLs. Lokale Dateipfade werden frühzeitig abgelehnt, weil der DashScope-Videoendpunkt keine hochgeladenen lokalen Buffer für diese Referenzen akzeptiert.
Native Model-Studio-Endpunkte geben die Kompatibilität der Streaming-Nutzung für den gemeinsamen openai-completions-Transport an. OpenClaw leitet dies jetzt aus den Endpunktfähigkeiten ab, sodass DashScope-kompatible benutzerdefinierte Provider-IDs, die auf dieselben nativen Hosts zielen, dasselbe Streaming-Nutzungsverhalten erben, anstatt speziell die integrierte qwen-Provider-ID zu benötigen.Die Kompatibilität der nativen Streaming-Nutzung 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 (Videoverstehen und Wan-Videogenerierung) verwenden die Standard-DashScope-Endpunkte, nicht die Coding-Plan-Endpunkte:
  • Globale/Intl-Standard-Basis-URL: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
  • China-Standard-Basis-URL: https://dashscope.aliyuncs.com/compatible-mode/v1
Wenn der Gateway als Daemon ausgeführt wird (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).

​
Verwandte Themen

Modellauswahl

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

Videogenerierung

Gemeinsame Parameter für Video-Tools und Provider-Auswahl.

Alibaba (ModelStudio)

Legacy-ModelStudio-Provider und Migrationshinweise.

Fehlerbehebung

Allgemeine Fehlerbehebung und FAQ.