Przejdź do głównej treści

Qwen

Qwen OAuth zostało usunięte. Integracja darmowej warstwy OAuth (qwen-portal), która używała endpointów portal.qwen.ai, nie jest już dostępna. Tło znajdziesz w Issue #49557.
OpenClaw traktuje teraz Qwen jako pełnoprawnego dołączonego dostawcę z kanonicznym identyfikatorem qwen. Dołączony dostawca kieruje ruch do endpointów Qwen Cloud / Alibaba DashScope oraz Coding Plan i zachowuje starsze identyfikatory modelstudio jako alias zgodności.
  • Dostawca: qwen
  • Preferowana zmienna środowiskowa: QWEN_API_KEY
  • Akceptowane także dla zgodności: MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
  • Styl API: zgodny z OpenAI
Jeśli chcesz używać qwen3.6-plus, wybierz endpoint Standard (pay-as-you-go). Obsługa Coding Plan może pozostawać w tyle za publicznym katalogiem.

Pierwsze kroki

Wybierz typ planu i wykonaj kroki konfiguracji.
Najlepsze dla: dostępu opartego na subskrypcji przez Qwen Coding Plan.
1

Pobierz swój klucz API

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

Uruchom onboarding

Dla endpointu Global:
openclaw onboard --auth-choice qwen-api-key
Dla endpointu China:
openclaw onboard --auth-choice qwen-api-key-cn
3

Ustaw model domyślny

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

Sprawdź, czy model jest dostępny

openclaw models list --provider qwen
Starsze identyfikatory auth-choice z rodziny modelstudio-* oraz odwołania do modeli modelstudio/... nadal działają jako aliasy zgodności, ale nowe przepływy konfiguracji powinny preferować kanoniczne identyfikatory auth-choice z rodziny qwen-* oraz odwołania do modeli qwen/....

Typy planów i endpointy

PlanRegionAuth choiceEndpoint
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 (subskrypcja)Chinaqwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Coding Plan (subskrypcja)Globalqwen-api-keycoding-intl.dashscope.aliyuncs.com/v1
Dostawca automatycznie wybiera endpoint na podstawie Twojego auth choice. Kanoniczne wybory używają rodziny qwen-*; modelstudio-* pozostaje tylko dla zgodności. Możesz nadpisać to przez niestandardowe baseUrl w konfiguracji.
Zarządzanie kluczami: home.qwencloud.com/api-keys | Dokumentacja: docs.qwencloud.com

Wbudowany katalog

OpenClaw obecnie dostarcza ten dołączony katalog Qwen. Skonfigurowany katalog jest świadomy endpointu: konfiguracje Coding Plan pomijają modele, o których wiadomo, że działają tylko na endpointach Standard.
Odwołanie do modeluWejścieKontekstUwagi
qwen/qwen3.5-plustext, image1,000,000Model domyślny
qwen/qwen3.6-plustext, image1,000,000Gdy potrzebujesz tego modelu, preferuj endpointy Standard
qwen/qwen3-max-2026-01-23text262,144Linia Qwen Max
qwen/qwen3-coder-nexttext262,144Kodowanie
qwen/qwen3-coder-plustext1,000,000Kodowanie
qwen/MiniMax-M2.5text1,000,000Obsługa rozumowania włączona
qwen/glm-5text202,752GLM
qwen/glm-4.7text202,752GLM
qwen/kimi-k2.5text, image262,144Moonshot AI przez Alibaba
Dostępność nadal może się różnić w zależności od endpointu i planu rozliczeniowego, nawet jeśli model występuje w dołączonym katalogu.

Dodatki multimodalne

Rozszerzenie qwen udostępnia także możliwości multimodalne na endpointach Standard DashScope (nie na endpointach 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 Video Generation, aby poznać wspólne parametry narzędzia, wybór dostawcy i zachowanie failover.

Zaawansowane

Dołączony Plugin Qwen rejestruje rozumienie mediów dla obrazów i wideo na endpointach Standard DashScope (nie na endpointach Coding Plan).
WłaściwośćWartość
Modelqwen-vl-max-latest
Obsługiwane wejścieObrazy, wideo
Rozumienie mediów jest automatycznie rozpoznawane na podstawie skonfigurowanego uwierzytelniania Qwen — nie jest potrzebna żadna dodatkowa konfiguracja. Upewnij się, że używasz endpointu Standard (pay-as-you-go), jeśli chcesz obsługi rozumienia mediów.
qwen3.6-plus jest dostępny na endpointach Standard (pay-as-you-go) Model Studio:
  • China: dashscope.aliyuncs.com/compatible-mode/v1
  • Global: dashscope-intl.aliyuncs.com/compatible-mode/v1
Jeśli endpointy Coding Plan zwracają błąd „unsupported model” dla qwen3.6-plus, przełącz się na Standard (pay-as-you-go) zamiast pary endpoint/klucz Coding Plan.
Rozszerzenie qwen jest pozycjonowane jako dom dostawcy dla pełnej powierzchni Qwen Cloud, a nie tylko modeli do kodowania/tekstu.
  • Modele tekstowe/czatowe: dołączone teraz
  • Wywoływanie narzędzi, strukturalne wyjście, myślenie: dziedziczone z transportu zgodnego z OpenAI
  • Generowanie obrazów: planowane na warstwie Pluginu dostawcy
  • Rozumienie obrazów/wideo: dołączone teraz na endpointach Standard
  • Mowa/audio: planowane na warstwie Pluginu dostawcy
  • Osadzania/reranking pamięci: planowane przez powierzchnię adaptera osadzania
  • Generowanie wideo: dołączone teraz przez współdzieloną możliwość generowania wideo
W przypadku generowania wideo OpenClaw mapuje skonfigurowany region Qwen na pasujący host DashScope AIGC przed wysłaniem zadania:
  • Global/Intl: https://dashscope-intl.aliyuncs.com
  • China: https://dashscope.aliyuncs.com
Oznacza to, że zwykłe models.providers.qwen.baseUrl wskazujące na hosty Qwen Coding Plan lub Standard nadal utrzymuje generowanie wideo na prawidłowym regionalnym endpointcie wideo DashScope.Bieżące limity dołączonego generowania wideo Qwen:
  • Maksymalnie 1 wyjściowe wideo na żądanie
  • Maksymalnie 1 obraz wejściowy
  • Maksymalnie 4 wejściowe wideo
  • Maksymalnie 10 sekund czasu trwania
  • Obsługuje size, aspectRatio, resolution, audio i watermark
  • Tryb obrazu/wideo referencyjnego obecnie wymaga zdalnych URL-i http(s). Lokalne ścieżki plików są odrzucane od razu, ponieważ endpoint wideo DashScope nie akceptuje przesłanych lokalnych buforów dla takich odniesień.
Natywne endpointy Model Studio deklarują zgodność użycia strumieniowego na współdzielonym transporcie openai-completions. OpenClaw opiera to teraz na możliwościach endpointu, więc niestandardowe identyfikatory 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ść natywnego użycia strumieniowego dotyczy zarówno hostów Coding Plan, jak i hostów Standard 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ą endpointów Standard DashScope, a nie endpointów Coding Plan:
  • Global/Intl Standard base URL: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
  • China Standard base 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, odwołań do modeli i zachowania failover.

Video generation

Wspólne 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.