> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Qwen

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`](/pl/providers/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

<Tip>
  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.
</Tip>

## Zainstaluj Plugin

Zainstaluj oficjalny Plugin, a następnie uruchom ponownie Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/qwen-provider
openclaw gateway restart
```

## Pierwsze kroki

Wybierz typ planu i wykonaj kroki konfiguracji.

<Tabs>
  <Tab title="Coding Plan (subscription)">
    **Najlepsze do:** dostępu subskrypcyjnego przez Qwen Coding Plan.

    <Steps>
      <Step title="Get your API key">
        Utwórz lub skopiuj klucz API z [home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys).
      </Step>

      <Step title="Run onboarding">
        Dla punktu końcowego **Global**:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice qwen-api-key
        ```

        Dla punktu końcowego **China**:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice qwen-api-key-cn
        ```
      </Step>

      <Step title="Set a default model">
        ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
        {
          agents: {
            defaults: {
              model: { primary: "qwen/qwen3.5-plus" },
            },
          },
        }
        ```
      </Step>

      <Step title="Verify the model is available">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw models list --provider qwen
        ```
      </Step>
    </Steps>

    <Note>
      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.
    </Note>
  </Tab>

  <Tab title="Standard (pay-as-you-go)">
    **Najlepsze do:** dostępu rozliczanego według użycia przez punkt końcowy Standard Model Studio, w tym modeli takich jak `qwen3.6-plus`, które mogą nie być dostępne w Coding Plan.

    <Steps>
      <Step title="Get your API key">
        Utwórz lub skopiuj klucz API z [home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys).
      </Step>

      <Step title="Run onboarding">
        Dla punktu końcowego **Global**:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice qwen-standard-api-key
        ```

        Dla punktu końcowego **China**:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice qwen-standard-api-key-cn
        ```
      </Step>

      <Step title="Set a default model">
        ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
        {
          agents: {
            defaults: {
              model: { primary: "qwen/qwen3.5-plus" },
            },
          },
        }
        ```
      </Step>

      <Step title="Verify the model is available">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw models list --provider qwen
        ```
      </Step>
    </Steps>

    <Note>
      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.
    </Note>
  </Tab>

  <Tab title="Qwen OAuth / Portal">
    **Najlepsze do:** tokenu Qwen Portal dla `https://portal.qwen.ai/v1`.

    Zobacz [Qwen OAuth / Portal](/pl/providers/qwen-oauth), aby przejść do dedykowanej strony dostawcy
    i uwag migracyjnych.

    <Steps>
      <Step title="Provide your portal token">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice qwen-oauth
        ```
      </Step>

      <Step title="Set a default model">
        ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
        {
          agents: {
            defaults: {
              model: { primary: "qwen-oauth/qwen3.5-plus" },
            },
          },
        }
        ```
      </Step>

      <Step title="Verify the model is available">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw models list --provider qwen-oauth
        ```
      </Step>
    </Steps>

    <Note>
      `qwen-oauth` używa tej samej nazwy zmiennej środowiskowej `QWEN_API_KEY` co dostawca
      DashScope, ale podczas konfiguracji przez onboarding OpenClaw zapisuje dane uwierzytelniania
      pod identyfikatorem dostawcy `qwen-oauth`.
    </Note>
  </Tab>
</Tabs>

## Typy planów i punkty końcowe

| Plan                       | Region | Wybór uwierzytelniania     | Punkt końcowy                                    |
| -------------------------- | ------ | -------------------------- | ------------------------------------------------ |
| Standard (pay-as-you-go)   | China  | `qwen-standard-api-key-cn` | `dashscope.aliyuncs.com/compatible-mode/v1`      |
| Standard (pay-as-you-go)   | Global | `qwen-standard-api-key`    | `dashscope-intl.aliyuncs.com/compatible-mode/v1` |
| Coding Plan (subscription) | China  | `qwen-api-key-cn`          | `coding.dashscope.aliyuncs.com/v1`               |
| Coding Plan (subscription) | Global | `qwen-api-key`             | `coding-intl.dashscope.aliyuncs.com/v1`          |
| Qwen Portal                | Global | `qwen-oauth`               | `portal.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.

<Tip>
  **Zarządzanie kluczami:** [home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys) |
  **Dokumentacja:** [docs.qwencloud.com](https://docs.qwencloud.com/developer-guides/getting-started/introduction)
</Tip>

## 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 modelu         | Wejście      | Kontekst  | Uwagi                                                          |
| --------------------------- | ------------ | --------- | -------------------------------------------------------------- |
| `qwen/qwen3.5-plus`         | tekst, obraz | 1,000,000 | Model domyślny                                                 |
| `qwen/qwen3.6-plus`         | tekst, obraz | 1,000,000 | Preferuj punkty końcowe Standard, gdy potrzebujesz tego modelu |
| `qwen/qwen3-max-2026-01-23` | tekst        | 262,144   | Linia Qwen Max                                                 |
| `qwen/qwen3-coder-next`     | tekst        | 262,144   | Kodowanie                                                      |
| `qwen/qwen3-coder-plus`     | tekst        | 1,000,000 | Kodowanie                                                      |
| `qwen/MiniMax-M2.5`         | tekst        | 1,000,000 | Włączone rozumowanie                                           |
| `qwen/glm-5`                | tekst        | 202,752   | GLM                                                            |
| `qwen/glm-4.7`              | tekst        | 202,752   | GLM                                                            |
| `qwen/kimi-k2.5`            | tekst, obraz | 262,144   | Moonshot AI przez Alibaba                                      |
| `qwen-oauth/qwen3.5-plus`   | tekst, obraz | 1,000,000 | Domyślny model Qwen Portal                                     |

<Note>
  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.
</Note>

## 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:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
    },
  },
}
```

<Note>
  Zobacz [Generowanie wideo](/pl/tools/video-generation), aby poznać wspólne parametry narzędzia, wybór dostawcy i zachowanie przełączania awaryjnego.
</Note>

## Konfiguracja zaawansowana

<AccordionGroup>
  <Accordion title="Image and video understanding">
    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ść              |
    | ------------------- | -------------------- |
    | Model               | `qwen-vl-max-latest` |
    | Obsługiwane wejście | Obrazy, 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.
  </Accordion>

  <Accordion title="Qwen 3.6 Plus availability">
    `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.
  </Accordion>

  <Accordion title="Capability plan">
    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
  </Accordion>

  <Accordion title="Video generation details">
    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.
  </Accordion>

  <Accordion title="Zgodność użycia strumieniowego">
    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`
  </Accordion>

  <Accordion title="Regiony punktów końcowych multimodalnych">
    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`
  </Accordion>

  <Accordion title="Konfiguracja środowiska i demona">
    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`).
  </Accordion>
</AccordionGroup>

## Powiązane

<CardGroup cols={2}>
  <Card title="Wybór modelu" href="/pl/concepts/model-providers" icon="layers">
    Wybór dostawców, referencji modeli i zachowania przełączania awaryjnego.
  </Card>

  <Card title="Generowanie wideo" href="/pl/tools/video-generation" icon="video">
    Współdzielone parametry narzędzia wideo i wybór dostawcy.
  </Card>

  <Card title="Alibaba (ModelStudio)" href="/pl/providers/alibaba" icon="cloud">
    Starszy dostawca ModelStudio i uwagi dotyczące migracji.
  </Card>

  <Card title="Rozwiązywanie problemów" href="/pl/help/troubleshooting" icon="wrench">
    Ogólne rozwiązywanie problemów i FAQ.
  </Card>
</CardGroup>
