Przejdź do głównej treści
OpenClaw traktuje teraz Qwen jako pełnoprawny Plugin dostawcy o kanonicznym identyfikatorze qwen. Plugin dostawcy obsługuje punkty końcowe Qwen Cloud / Alibaba DashScope oraz Coding Plan, utrzymuje działanie starszych identyfikatorów modelstudio jako aliasu zgodności i udostępnia też przepływ tokenu Qwen Portal jako dostawcę qwen-oauth.
  • Dostawca: qwen
  • Dostawca portalu: qwen-oauth
  • Preferowana zmienna środowiskowa: QWEN_API_KEY
  • Akceptowane także ze względu na zgodność: MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
  • Styl API: zgodny z OpenAI
Jeśli chcesz używać qwen3.6-plus, preferuj punkt końcowy Standard (pay-as-you-go). Obsługa Coding Plan może pozostawać w tyle za publicznym katalogiem.

Zainstaluj Plugin

Zainstaluj oficjalny Plugin, a następnie uruchom ponownie Gateway:
openclaw plugins install @openclaw/qwen-provider
openclaw gateway restart

Pierwsze kroki

Wybierz typ planu i wykonaj kroki konfiguracji.
Najlepsze do: dostępu subskrypcyjnego przez Qwen Coding Plan.
1

Get your API key

Utwórz lub skopiuj klucz API z home.qwencloud.com/api-keys.
2

Run onboarding

Dla punktu końcowego Global:
openclaw onboard --auth-choice qwen-api-key
Dla punktu końcowego China:
openclaw onboard --auth-choice qwen-api-key-cn
3

Set a default model

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

Verify the model is available

openclaw models list --provider qwen
Starsze identyfikatory auth-choice modelstudio-* i odwołania do modeli modelstudio/... nadal działają jako aliasy zgodności, ale nowe przepływy konfiguracji powinny preferować kanoniczne identyfikatory auth-choice qwen-* oraz odwołania do modeli qwen/.... Jeśli zdefiniujesz dokładny niestandardowy wpis models.providers.modelstudio z inną wartością api, ten niestandardowy dostawca przejmuje odwołania modelstudio/... zamiast aliasu zgodności Qwen.

Typy planów i punkty końcowe

PlanRegionWybór uwierzytelnianiaPunkt końcowy
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 (subscription)Chinaqwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Coding Plan (subscription)Globalqwen-api-keycoding-intl.dashscope.aliyuncs.com/v1
Qwen PortalGlobalqwen-oauthportal.qwen.ai/v1
Dostawca automatycznie wybiera punkt końcowy na podstawie wybranego uwierzytelniania. Kanoniczne wybory używają rodziny qwen-*; modelstudio-* pozostaje tylko dla zgodności. Możesz nadpisać to niestandardowym baseUrl w konfiguracji.
Zarządzanie kluczami: home.qwencloud.com/api-keys | Dokumentacja: docs.qwencloud.com

Wbudowany katalog

OpenClaw obecnie dostarcza ten statyczny katalog Qwen. Skonfigurowany katalog uwzględnia punkt końcowy: konfiguracje Coding Plan pomijają modele, o których wiadomo, że działają tylko w punkcie końcowym Standard.
Odwołanie do modeluWejścieKontekstUwagi
qwen/qwen3.5-plustekst, obraz1,000,000Model domyślny
qwen/qwen3.6-plustekst, obraz1,000,000Preferuj punkty końcowe Standard, gdy potrzebujesz tego modelu
qwen/qwen3-max-2026-01-23tekst262,144Linia Qwen Max
qwen/qwen3-coder-nexttekst262,144Kodowanie
qwen/qwen3-coder-plustekst1,000,000Kodowanie
qwen/MiniMax-M2.5tekst1,000,000Włączone rozumowanie
qwen/glm-5tekst202,752GLM
qwen/glm-4.7tekst202,752GLM
qwen/kimi-k2.5tekst, obraz262,144Moonshot AI przez Alibaba
qwen-oauth/qwen3.5-plustekst, obraz1,000,000Domyślny model Qwen Portal
Dostępność może nadal różnić się w zależności od punktu końcowego i planu rozliczeniowego, nawet gdy model znajduje się w statycznym katalogu.

Kontrolki myślenia

W przypadku modeli Qwen Cloud z włączonym rozumowaniem dostawca mapuje poziomy myślenia OpenClaw na najwyższego poziomu flagę żądania DashScope enable_thinking. Wyłączone myślenie wysyła enable_thinking: false; inne poziomy myślenia wysyłają enable_thinking: true.

Dodatki multimodalne

Plugin qwen udostępnia też możliwości multimodalne w punktach końcowych DashScope Standard (nie w punktach końcowych Coding Plan):
  • Rozumienie wideo przez qwen-vl-max-latest
  • Generowanie wideo Wan przez wan2.6-t2v (domyślnie), wan2.6-i2v, wan2.6-r2v, wan2.6-r2v-flash, wan2.7-r2v
Aby używać Qwen jako domyślnego dostawcy wideo:
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
    },
  },
}
Zobacz Generowanie wideo, aby poznać wspólne parametry narzędzia, wybór dostawcy i zachowanie przełączania awaryjnego.

Konfiguracja zaawansowana

Plugin Qwen rejestruje rozumienie mediów dla obrazów i wideo w punktach końcowych DashScope Standard (nie w punktach końcowych Coding Plan).
WłaściwośćWartość
Modelqwen-vl-max-latest
Obsługiwane wejścieObrazy, wideo
Rozumienie mediów jest automatycznie rozwiązywane na podstawie skonfigurowanego uwierzytelniania Qwen — nie jest potrzebna dodatkowa konfiguracja. Upewnij się, że używasz punktu końcowego Standard (pay-as-you-go) do obsługi rozumienia mediów.
qwen3.6-plus jest dostępny w punktach końcowych Standard (pay-as-you-go) Model Studio:
  • China: dashscope.aliyuncs.com/compatible-mode/v1
  • Global: dashscope-intl.aliyuncs.com/compatible-mode/v1
Jeśli punkty końcowe Coding Plan zwracają błąd „unsupported model” dla qwen3.6-plus, przełącz się na Standard (pay-as-you-go) zamiast pary punkt końcowy/klucz Coding Plan.Statyczny katalog Qwen w OpenClaw nie reklamuje qwen3.6-plus w punktach końcowych Coding Plan, ale jawnie skonfigurowane wpisy qwen/qwen3.6-plus pod models.providers.qwen.models są respektowane dla baseUrl Coding Plan, więc możesz włączyć ten model, jeśli Aliyun udostępni go w Twojej subskrypcji. O tym, czy wywołanie się powiedzie, nadal decyduje upstream API.
Plugin qwen jest pozycjonowany jako miejsce dostawcy dla pełnej powierzchni Qwen Cloud, nie tylko modeli kodowania/tekstu.
  • Modele tekstu/czatu: dostępne przez Plugin
  • Wywoływanie narzędzi, dane wyjściowe strukturalne, myślenie: dziedziczone z transportu zgodnego z OpenAI
  • Generowanie obrazów: planowane na warstwie Pluginu dostawcy
  • Rozumienie obrazów/wideo: dostępne przez Plugin w punkcie końcowym Standard
  • Mowa/audio: planowane na warstwie Pluginu dostawcy
  • Osadzenia pamięci/reranking: planowane przez powierzchnię adaptera osadzeń
  • Generowanie wideo: dostępne przez Plugin za pośrednictwem współdzielonej możliwości generowania wideo
W przypadku generowania wideo OpenClaw mapuje skonfigurowany region Qwen na odpowiadający mu host DashScope AIGC przed przesłaniem zadania:
  • Global/Intl: https://dashscope-intl.aliyuncs.com
  • China: https://dashscope.aliyuncs.com
Oznacza to, że zwykły models.providers.qwen.baseUrl wskazujący na hosty Coding Plan albo Standard Qwen nadal utrzymuje generowanie wideo we właściwym regionalnym punkcie końcowym wideo DashScope.Obecne limity generowania wideo Qwen:
  • Do 1 wyjściowego wideo na żądanie
  • Do 1 obrazu wejściowego
  • Do 4 wideo wejściowych
  • Do 10 sekund czasu trwania
  • Obsługuje size, aspectRatio, resolution, audio i watermark
  • Tryb obrazu/wideo referencyjnego obecnie wymaga zdalnych adresów URL http(s). Lokalne ścieżki plików są odrzucane z góry, ponieważ punkt końcowy wideo DashScope nie akceptuje przesyłanych lokalnych buforów dla tych referencji.
Natywne punkty końcowe Model Studio deklarują zgodność użycia strumieniowego we współdzielonym transporcie openai-completions. OpenClaw opiera to teraz na możliwościach punktu końcowego, więc identyfikatory niestandardowych dostawców zgodnych z DashScope, kierujące na te same natywne hosty, dziedziczą to samo zachowanie użycia strumieniowego zamiast wymagać konkretnie wbudowanego identyfikatora dostawcy qwen.Zgodność użycia natywnego strumieniowania dotyczy zarówno hostów planu kodowania, jak i standardowych hostów zgodnych z DashScope:
  • 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
Powierzchnie multimodalne (rozumienie wideo i generowanie wideo Wan) używają standardowych punktów końcowych DashScope, a nie punktów końcowych planu kodowania:
  • Globalny/międzynarodowy standardowy bazowy URL: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
  • Chiński standardowy bazowy URL: https://dashscope.aliyuncs.com/compatible-mode/v1
Jeśli Gateway działa jako demon (launchd/systemd), upewnij się, że QWEN_API_KEY jest dostępny dla tego procesu (na przykład w ~/.openclaw/.env lub przez env.shellEnv).

Powiązane

Wybór modelu

Wybór dostawców, referencji modeli i zachowania przełączania awaryjnego.

Generowanie wideo

Współdzielone parametry narzędzia wideo i wybór dostawcy.

Alibaba (ModelStudio)

Starszy dostawca ModelStudio i uwagi dotyczące migracji.

Rozwiązywanie problemów

Ogólne rozwiązywanie problemów i FAQ.