Providers

Qwen

OpenClaw тепер розглядає Qwen як повноцінний Plugin провайдера з канонічним id qwen. Plugin провайдера орієнтований на кінцеві точки Qwen Cloud / Alibaba DashScope і Coding Plan, зберігає працездатність застарілих id modelstudio як сумісного псевдоніма, а також надає потік токенів Qwen Portal як провайдера qwen-oauth.

Провайдер: qwen
Провайдер Portal: qwen-oauth
Бажана змінна середовища: QWEN_API_KEY
Також приймаються для сумісності: MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
Стиль API: сумісний з OpenAI

Установлення плагіна

Установіть офіційний плагін, а потім перезапустіть Gateway:

bash

openclaw plugins install @openclaw/qwen-provideropenclaw gateway restart

Початок роботи

Виберіть тип плану й виконайте кроки налаштування.

Coding Plan (subscription)

Найкраще для: доступу на основі підписки через Qwen Coding Plan.

Get your API key

Створіть або скопіюйте ключ API з home.qwencloud.com/api-keys.

Run onboarding

Для кінцевої точки Global:

bash

openclaw onboard --auth-choice qwen-api-key

Для кінцевої точки China:

bash

openclaw onboard --auth-choice qwen-api-key-cn

Set a default model

json5

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

Verify the model is available

bash

openclaw models list --provider qwen

Standard (pay-as-you-go)

Найкраще для: доступу з оплатою за використання через кінцеву точку Standard Model Studio, зокрема до моделей на кшталт qwen3.6-plus, які можуть бути недоступні в Coding Plan.

Get your API key

Створіть або скопіюйте ключ API з home.qwencloud.com/api-keys.

Run onboarding

Для кінцевої точки Global:

bash

openclaw onboard --auth-choice qwen-standard-api-key

Для кінцевої точки China:

bash

openclaw onboard --auth-choice qwen-standard-api-key-cn

Set a default model

json5

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

Verify the model is available

bash

openclaw models list --provider qwen

Qwen OAuth / Portal

Найкраще для: токена Qwen Portal для https://portal.qwen.ai/v1.

Див. Qwen OAuth / Portal, щоб перейти до окремої сторінки провайдера й приміток щодо міграції.

Provide your portal token

bash

openclaw onboard --auth-choice qwen-oauth

Set a default model

json5

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

Verify the model is available

bash

openclaw models list --provider qwen-oauth

Типи планів і кінцеві точки

План	Регіон	Вибір автентифікації	Кінцева точка
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`

Провайдер автоматично вибирає кінцеву точку на основі вашого вибору автентифікації. Канонічні варіанти використовують сімейство qwen-*; modelstudio-* залишається лише для сумісності. Ви можете перевизначити це за допомогою користувацького baseUrl у конфігурації.

Вбудований каталог

OpenClaw наразі постачає цей статичний каталог Qwen. Налаштований каталог враховує кінцеву точку: конфігурації Coding Plan пропускають моделі, про які відомо, що вони працюють лише на кінцевій точці Standard.

Посилання на модель	Вхідні дані	Контекст	Примітки
`qwen/qwen3.5-plus`	текст, зображення	1,000,000	Модель за замовчуванням
`qwen/qwen3.6-plus`	текст, зображення	1,000,000	Надавайте перевагу кінцевим точкам Standard, коли вам потрібна ця модель
`qwen/qwen3-max-2026-01-23`	текст	262,144	Лінійка Qwen Max
`qwen/qwen3-coder-next`	текст	262,144	Coding
`qwen/qwen3-coder-plus`	текст	1,000,000	Coding
`qwen/MiniMax-M2.5`	текст	1,000,000	Reasoning увімкнено
`qwen/glm-5`	текст	202,752	GLM
`qwen/glm-4.7`	текст	202,752	GLM
`qwen/kimi-k2.5`	текст, зображення	262,144	Moonshot AI через Alibaba
`qwen-oauth/qwen3.5-plus`	текст, зображення	1,000,000	Типове значення Qwen Portal

Елементи керування Thinking

Для моделей Qwen Cloud із підтримкою reasoning провайдер зіставляє рівні thinking OpenClaw із прапорцем запиту верхнього рівня DashScope enable_thinking. Вимкнене thinking надсилає enable_thinking: false; інші рівні thinking надсилають enable_thinking: true.

Мультимодальні доповнення

Плагін qwen також надає мультимодальні можливості на кінцевих точках DashScope Standard (не на кінцевих точках Coding Plan):

Розуміння відео через qwen-vl-max-latest
Генерація відео Wan через wan2.6-t2v (за замовчуванням), wan2.6-i2v, wan2.6-r2v, wan2.6-r2v-flash, wan2.7-r2v

Щоб використовувати Qwen як стандартного провайдера відео:

json5

{  agents: {    defaults: {      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },    },  },}

Розширена конфігурація

Image and video understanding

Плагін Qwen реєструє розуміння медіа для зображень і відео на кінцевих точках DashScope Standard (не на кінцевих точках Coding Plan).

Властивість	Значення
Модель	`qwen-vl-max-latest`
Підтримувані вхідні дані	зображення, відео

Розуміння медіа автоматично визначається з налаштованої автентифікації Qwen — додаткова конфігурація не потрібна. Переконайтеся, що ви використовуєте кінцеву точку Standard (pay-as-you-go) для підтримки розуміння медіа.

Qwen 3.6 Plus availability

qwen3.6-plus доступна на кінцевих точках Standard (pay-as-you-go) Model Studio:

China: dashscope.aliyuncs.com/compatible-mode/v1
Global: dashscope-intl.aliyuncs.com/compatible-mode/v1

Якщо кінцеві точки Coding Plan повертають помилку "unsupported model" для qwen3.6-plus, перейдіть на Standard (pay-as-you-go) замість пари кінцева точка/ключ Coding Plan.

Статичний каталог Qwen в OpenClaw не оголошує qwen3.6-plus на кінцевих точках Coding Plan, але явно налаштовані записи qwen/qwen3.6-plus у models.providers.qwen.models враховуються на baseUrl Coding Plan, тож ви можете ввімкнути цю модель, якщо Aliyun увімкне її у вашій підписці. Вихідний API все одно вирішує, чи буде виклик успішним.

Capability plan

Плагін qwen позиціонується як домівка постачальника для всієї поверхні Qwen Cloud, а не лише для моделей coding/text.

Текстові/чат-моделі: доступні через плагін
Виклики інструментів, структурований вивід, thinking: успадковуються від транспорту, сумісного з OpenAI
Генерація зображень: заплановано на рівні плагіна провайдера
Розуміння зображень/відео: доступне через плагін на кінцевій точці Standard
Мовлення/аудіо: заплановано на рівні плагіна провайдера
Ембеддинги пам’яті/повторне ранжування: заплановано через поверхню адаптера ембеддингів
Генерація відео: доступна через плагін через спільну можливість генерації відео

Video generation details

Для генерації відео OpenClaw зіставляє налаштований регіон Qwen із відповідним хостом DashScope AIGC перед надсиланням завдання:

Global/Intl: https://dashscope-intl.aliyuncs.com
China: https://dashscope.aliyuncs.com

Це означає, що звичайний models.providers.qwen.baseUrl, який вказує або на хости Coding Plan, або на хости Standard Qwen, усе одно утримує генерацію відео на правильній регіональній кінцевій точці відео DashScope.

Поточні обмеження генерації відео Qwen:

До 1 вихідного відео на запит
До 1 вхідного зображення
До 4 вхідних відео
Тривалість до 10 секунд
Підтримує size, aspectRatio, resolution, audio і watermark
Режим референсного зображення/відео наразі вимагає віддалених URL http(s). Локальні шляхи до файлів відхиляються заздалегідь, оскільки кінцева точка відео DashScope не приймає завантажені локальні буфери для таких референсів.

Сумісність використання потокового передавання

Нативні кінцеві точки Model Studio оголошують сумісність використання потокового передавання на спільному транспорті openai-completions. Тепер OpenClaw визначає це за можливостями кінцевої точки, тож сумісні з DashScope ідентифікатори користувацьких провайдерів, націлені на ті самі нативні хости, успадковують ту саму поведінку використання потокового передавання замість вимоги використовувати саме вбудований ідентифікатор провайдера qwen.

Сумісність використання нативного потокового передавання застосовується як до хостів Coding Plan, так і до стандартних сумісних із 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

Регіони мультимодальних кінцевих точок

Мультимодальні поверхні (розуміння відео та генерація відео Wan) використовують стандартні кінцеві точки DashScope, а не кінцеві точки Coding Plan:

Глобальна/міжнародна стандартна базова URL-адреса: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
Китайська стандартна базова URL-адреса: https://dashscope.aliyuncs.com/compatible-mode/v1

Налаштування середовища та демона

Якщо Gateway працює як демон (launchd/systemd), переконайтеся, що QWEN_API_KEY доступний цьому процесу (наприклад, у ~/.openclaw/.env або через env.shellEnv).

Пов’язане

Вибір моделі

Вибір провайдерів, посилань на моделі та поведінки відмовостійкого перемикання.

Генерація відео

Спільні параметри відеоінструмента та вибір провайдера.

Alibaba (ModelStudio)

Застарілий провайдер ModelStudio та нотатки щодо міграції.

Усунення несправностей

Загальне усунення несправностей і поширені запитання.

Was this useful?

Qwen

Установлення плагіна

Початок роботи

Coding Plan (subscription)

Get your API key

Run onboarding

Set a default model

Verify the model is available

Standard (pay-as-you-go)

Get your API key

Run onboarding

Set a default model

Verify the model is available

Qwen OAuth / Portal

Provide your portal token

Set a default model

Verify the model is available

Типи планів і кінцеві точки

Вбудований каталог

Елементи керування Thinking

Мультимодальні доповнення

Розширена конфігурація

Пов’язане

On this page

Molty