Naar hoofdinhoud gaan
OpenClaw behandelt Qwen nu als een volwaardige provider-Plugin met canonieke id qwen. De provider-Plugin richt zich op de Qwen Cloud / Alibaba DashScope- en Coding Plan-eindpunten, houdt verouderde modelstudio-id’s werkend als compatibiliteitsalias, en stelt ook de Qwen Portal-tokenflow beschikbaar als provider qwen-oauth.
  • Provider: qwen
  • Portal-provider: qwen-oauth
  • Voorkeursomgevingsvariabele: QWEN_API_KEY
  • Ook geaccepteerd voor compatibiliteit: MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
  • API-stijl: OpenAI-compatibel
Als je qwen3.6-plus wilt, geef dan de voorkeur aan het Standard (pay-as-you-go)-eindpunt. Ondersteuning voor Coding Plan kan achterlopen op de openbare catalogus.

Plugin installeren

Installeer de officiële Plugin en herstart daarna Gateway:
openclaw plugins install @openclaw/qwen-provider
openclaw gateway restart

Aan de slag

Kies je plantype en volg de installatiestappen.
Het beste voor: toegang op abonnementsbasis via het Qwen Coding Plan.
1

Haal je API-sleutel op

Maak of kopieer een API-sleutel via home.qwencloud.com/api-keys.
2

Voer onboarding uit

Voor het Global-eindpunt:
openclaw onboard --auth-choice qwen-api-key
Voor het China-eindpunt:
openclaw onboard --auth-choice qwen-api-key-cn
3

Stel een standaardmodel in

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

Controleer of het model beschikbaar is

openclaw models list --provider qwen
Verouderde modelstudio-* auth-choice-id’s en modelstudio/...-modelrefs werken nog als compatibiliteitsaliassen, maar nieuwe installatieflows moeten de voorkeur geven aan de canonieke qwen-* auth-choice-id’s en qwen/...-modelrefs. Als je een exacte aangepaste models.providers.modelstudio-vermelding definieert met een andere api-waarde, is die aangepaste provider eigenaar van modelstudio/...-refs in plaats van de Qwen-compatibiliteitsalias.

Plantypen en eindpunten

PlanRegioAuth-keuzeEindpunt
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
Qwen PortalGlobalqwen-oauthportal.qwen.ai/v1
De provider selecteert het eindpunt automatisch op basis van je auth-keuze. Canonieke keuzes gebruiken de qwen-*-familie; modelstudio-* blijft alleen voor compatibiliteit. Je kunt dit overschrijven met een aangepaste baseUrl in de configuratie.
Sleutels beheren: home.qwencloud.com/api-keys | Documentatie: docs.qwencloud.com

Ingebouwde catalogus

OpenClaw levert momenteel deze statische Qwen-catalogus mee. De geconfigureerde catalogus is eindpuntbewust: Coding Plan-configuraties laten modellen weg waarvan alleen bekend is dat ze werken op het Standard-eindpunt.
ModelrefInvoerContextOpmerkingen
qwen/qwen3.5-plustekst, afbeelding1,000,000Standaardmodel
qwen/qwen3.6-plustekst, afbeelding1,000,000Geef de voorkeur aan Standard-eindpunten wanneer je dit model nodig hebt
qwen/qwen3-max-2026-01-23tekst262,144Qwen Max-lijn
qwen/qwen3-coder-nexttekst262,144Coderen
qwen/qwen3-coder-plustekst1,000,000Coderen
qwen/MiniMax-M2.5tekst1,000,000Reasoning ingeschakeld
qwen/glm-5tekst202,752GLM
qwen/glm-4.7tekst202,752GLM
qwen/kimi-k2.5tekst, afbeelding262,144Moonshot AI via Alibaba
qwen-oauth/qwen3.5-plustekst, afbeelding1,000,000Qwen Portal-standaard
Beschikbaarheid kan nog steeds verschillen per eindpunt en factureringsplan, zelfs wanneer een model in de statische catalogus aanwezig is.

Denkbesturing

Voor Qwen Cloud-modellen met reasoning schakelt de provider OpenClaw- denkniveaus om naar DashScope’s top-level aanvraagvlag enable_thinking. Uitgeschakeld denken verstuurt enable_thinking: false; andere denkniveaus versturen enable_thinking: true.

Multimodale add-ons

De qwen-Plugin stelt ook multimodale mogelijkheden beschikbaar op de Standard DashScope-eindpunten (niet de Coding Plan-eindpunten):
  • Videobegrip via qwen-vl-max-latest
  • Wan-videogeneratie via wan2.6-t2v (standaard), wan2.6-i2v, wan2.6-r2v, wan2.6-r2v-flash, wan2.7-r2v
Om Qwen als standaardvideoprovider te gebruiken:
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
    },
  },
}
Zie Videogeneratie voor gedeelde toolparameters, providerselectie en failovergedrag.

Geavanceerde configuratie

De Qwen-Plugin registreert mediabegrip voor afbeeldingen en video op de Standard DashScope-eindpunten (niet de Coding Plan-eindpunten).
EigenschapWaarde
Modelqwen-vl-max-latest
Ondersteunde invoerAfbeeldingen, video
Mediabegrip wordt automatisch opgelost vanuit de geconfigureerde Qwen-authenticatie: er is geen aanvullende configuratie nodig. Zorg ervoor dat je een Standard (pay-as-you-go)- eindpunt gebruikt voor ondersteuning voor mediabegrip.
qwen3.6-plus is beschikbaar op de Standard (pay-as-you-go) Model Studio- eindpunten:
  • China: dashscope.aliyuncs.com/compatible-mode/v1
  • Global: dashscope-intl.aliyuncs.com/compatible-mode/v1
Als de Coding Plan-eindpunten een fout “unsupported model” retourneren voor qwen3.6-plus, schakel dan over naar Standard (pay-as-you-go) in plaats van het Coding Plan- eindpunt/sleutelpaar.De statische Qwen-catalogus van OpenClaw adverteert qwen3.6-plus niet op Coding Plan-eindpunten, maar expliciet geconfigureerde qwen/qwen3.6-plus-vermeldingen onder models.providers.qwen.models worden gehonoreerd op Coding Plan-baseUrls, zodat je dat model kunt inschakelen als Aliyun het op je abonnement activeert. De upstream-API beslist nog steeds of de aanroep slaagt.
De qwen-Plugin wordt gepositioneerd als de leveranciershome voor het volledige Qwen Cloud-oppervlak, niet alleen voor codeer-/tekstmodellen.
  • Tekst-/chatmodellen: beschikbaar via de Plugin
  • Toolaanroepen, gestructureerde uitvoer, denken: overgenomen van het OpenAI-compatibele transport
  • Afbeeldingsgeneratie: gepland op de provider-Plugin-laag
  • Beeld-/videobegrip: beschikbaar via de Plugin op het Standard-eindpunt
  • Spraak/audio: gepland op de provider-Plugin-laag
  • Geheugen-embeddings/reranking: gepland via het embedding-adapteroppervlak
  • Videogeneratie: beschikbaar via de Plugin via de gedeelde videogeneratie-capability
Voor videogeneratie koppelt OpenClaw de geconfigureerde Qwen-regio aan de bijbehorende DashScope AIGC-host voordat de taak wordt ingediend:
  • Global/Intl: https://dashscope-intl.aliyuncs.com
  • China: https://dashscope.aliyuncs.com
Dat betekent dat een normale models.providers.qwen.baseUrl die naar de Coding Plan- of Standard Qwen-hosts wijst, videogeneratie nog steeds op het juiste regionale DashScope-video-eindpunt houdt.Huidige limieten voor Qwen-videogeneratie:
  • Maximaal 1 uitvoervideo per aanvraag
  • Maximaal 1 invoerafbeelding
  • Maximaal 4 invoervideo’s
  • Maximaal 10 seconden duur
  • Ondersteunt size, aspectRatio, resolution, audio en watermark
  • Referentieafbeeldings-/videomodus vereist momenteel externe http(s)-URL’s. Lokale bestandspaden worden vooraf geweigerd omdat het DashScope-video-eindpunt geen geüploade lokale buffers voor die referenties accepteert.
Native Model Studio-eindpunten adverteren compatibiliteit voor streaminggebruik op het gedeelde openai-completions-transport. OpenClaw baseert dat nu op eindpuntmogelijkheden, zodat DashScope-compatibele aangepaste provider-id’s die op dezelfde native hosts zijn gericht, hetzelfde streaminggebruiksgedrag overnemen in plaats van specifiek de ingebouwde provider-id qwen te vereisen.Compatibiliteit voor native streaminggebruik geldt voor zowel de Coding Plan-hosts als de Standard DashScope-compatibele 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 oppervlakken (videobegrip en Wan-videogeneratie) gebruiken de Standard DashScope-eindpunten, niet de Coding Plan-eindpunten:
  • Global/Intl Standard-basis-URL: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
  • China Standard-basis-URL: https://dashscope.aliyuncs.com/compatible-mode/v1
Als de Gateway als daemon draait (launchd/systemd), zorg er dan voor dat QWEN_API_KEY beschikbaar is voor dat proces (bijvoorbeeld in ~/.openclaw/.env of via env.shellEnv).

Gerelateerd

Modelselectie

Providers, modelreferenties en failovergedrag kiezen.

Videogeneratie

Gedeelde videotoolparameters en providerselectie.

Alibaba (ModelStudio)

Verouderde ModelStudio-provider en migratieopmerkingen.

Probleemoplossing

Algemene probleemoplossing en veelgestelde vragen.