Naar hoofdinhoud gaan

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 is verwijderd. De gratis OAuth-integratie (qwen-portal) die portal.qwen.ai-endpoints gebruikte, is niet langer beschikbaar. Zie Issue #49557 voor achtergrondinformatie.
OpenClaw behandelt Qwen nu als een volwaardige gebundelde provider met canonieke id qwen. De gebundelde provider richt zich op de Qwen Cloud / Alibaba DashScope- en Coding Plan-endpoints en laat verouderde modelstudio-ids werken als compatibiliteitsalias.
  • Provider: qwen
  • Voorkeurs-env-var: 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)-endpoint. Ondersteuning voor Coding Plan kan achterlopen op de openbare catalogus.

Aan de slag

Kies je abonnementstype en volg de installatiestappen.
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-endpoint:
openclaw onboard --auth-choice qwen-api-key
Voor het China-endpoint:
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-ids en modelstudio/...-modelrefs werken nog steeds als compatibiliteitsaliases, maar nieuwe installatiestromen moeten de voorkeur geven aan de canonieke qwen-* auth-choice-ids en qwen/...-modelrefs. Als je een exacte aangepaste models.providers.modelstudio-vermelding met een andere api-waarde definieert, is die aangepaste provider eigenaar van modelstudio/...-refs in plaats van de Qwen-compatibiliteitsalias.

Abonnementstypen en endpoints

AbonnementRegioAuth-keuzeEndpoint
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
De provider selecteert het endpoint 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 gebundelde Qwen-catalogus mee. De geconfigureerde catalogus is endpoint-bewust: Coding Plan-configuraties laten modellen weg waarvan alleen bekend is dat ze werken op het Standard-endpoint.
ModelrefInvoerContextOpmerkingen
qwen/qwen3.5-plustekst, afbeelding1,000,000Standaardmodel
qwen/qwen3.6-plustekst, afbeelding1,000,000Geef de voorkeur aan Standard-endpoints wanneer je dit model nodig hebt
qwen/qwen3-max-2026-01-23tekst262,144Qwen Max-lijn
qwen/qwen3-coder-nexttekst262,144Programmeren
qwen/qwen3-coder-plustekst1,000,000Programmeren
qwen/MiniMax-M2.5tekst1,000,000Redeneren ingeschakeld
qwen/glm-5tekst202,752GLM
qwen/glm-4.7tekst202,752GLM
qwen/kimi-k2.5tekst, afbeelding262,144Moonshot AI via Alibaba
Beschikbaarheid kan nog steeds verschillen per endpoint en factureringsplan, zelfs wanneer een model aanwezig is in de gebundelde catalogus.

Denkbesturing

Voor Qwen Cloud-modellen met redeneermogelijkheden koppelt de gebundelde provider de denkniveaus van OpenClaw aan DashScope’s top-level enable_thinking-aanvraagvlag. Uitgeschakeld denken verzendt enable_thinking: false; andere denkniveaus verzenden enable_thinking: true.

Multimodale add-ons

De qwen-plugin biedt ook multimodale mogelijkheden op de Standard DashScope-endpoints (niet op de Coding Plan-endpoints):
  • 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 gebundelde Qwen-plugin registreert mediabegrip voor afbeeldingen en video op de Standard DashScope-endpoints (niet op de Coding Plan-endpoints).
EigenschapWaarde
Modelqwen-vl-max-latest
Ondersteunde invoerAfbeeldingen, video
Mediabegrip wordt automatisch opgelost vanuit de geconfigureerde Qwen-auth — er is geen aanvullende configuratie nodig. Zorg dat je een Standard (pay-as-you-go) endpoint gebruikt voor ondersteuning van mediabegrip.
qwen3.6-plus is beschikbaar op de Standard (pay-as-you-go) Model Studio- endpoints:
  • China: dashscope.aliyuncs.com/compatible-mode/v1
  • Global: dashscope-intl.aliyuncs.com/compatible-mode/v1
Als de Coding Plan-endpoints een fout “unsupported model” retourneren voor qwen3.6-plus, schakel dan over naar Standard (pay-as-you-go) in plaats van het Coding Plan- endpoint/sleutelpaar.De gebundelde Qwen-catalogus van OpenClaw adverteert qwen3.6-plus niet op Coding Plan-endpoints, maar expliciet geconfigureerde qwen/qwen3.6-plus-vermeldingen onder models.providers.qwen.models worden gerespecteerd op Coding Plan-baseUrls, zodat je dat model kunt inschakelen als Aliyun het voor je abonnement activeert. De upstream-API bepaalt nog steeds of de aanroep slaagt.
De qwen-plugin wordt gepositioneerd als de vendor-thuisbasis voor het volledige Qwen Cloud-oppervlak, niet alleen coding-/tekstmodellen.
  • Tekst-/chatmodellen: nu gebundeld
  • Toolaanroepen, gestructureerde uitvoer, denken: overgenomen van het OpenAI-compatibele transport
  • Afbeeldingsgeneratie: gepland op de provider-pluginlaag
  • Afbeeldings-/videobegrip: nu gebundeld op het Standard-endpoint
  • Spraak/audio: gepland op de provider-pluginlaag
  • Geheugen-embeddings/reranking: gepland via het embedding-adapteroppervlak
  • Videogeneratie: nu gebundeld via de gedeelde videogeneratiemogelijkheid
Voor videogeneratie koppelt OpenClaw de geconfigureerde Qwen-regio aan de overeenkomende 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-endpoint houdt.Huidige gebundelde 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-endpoint geen geüploade lokale buffers voor die referenties accepteert.
Native Model Studio-endpoints adverteren compatibiliteit met streaminggebruik op het gedeelde openai-completions-transport. OpenClaw baseert dat nu op endpoint- mogelijkheden, zodat DashScope-compatibele aangepaste provider-ids die zich richten op dezelfde native hosts hetzelfde streaminggebruiksgedrag erven in plaats van specifiek de ingebouwde qwen-provider-id te vereisen.Compatibiliteit met 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-endpoints, niet de Coding Plan-endpoints:
  • 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, modelverwijzingen en failover-gedrag kiezen.

Videogeneratie

Gedeelde videotoolparameters en providerselectie.

Alibaba (ModelStudio)

Verouderde ModelStudio-provider en migratie-opmerkingen.

Probleemoplossing

Algemene probleemoplossing en veelgestelde vragen.