Providers

Qwen

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

Властивість Значення
Постачальник qwen
Постачальник Token Plan qwen-token-plan
Постачальник Portal qwen-oauth
Бажана змінна середовища QWEN_API_KEY
Змінна середовища Token Plan QWEN_TOKEN_PLAN_API_KEY
Також приймаються (сумісність) MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
Стиль API сумісний з OpenAI

Установлення Plugin

qwen постачається як офіційний зовнішній Plugin і не входить до складу ядра. Установіть його та перезапустіть Gateway:

bash
openclaw plugins install @openclaw/qwen-provideropenclaw gateway restart

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

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

Coding Plan (передплата)

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

  • Отримайте ключ API

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

  • Запустіть початкове налаштування

    Для глобальної кінцевої точки:

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

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

    bash
    openclaw onboard --auth-choice qwen-api-key-cn
  • Установіть модель за замовчуванням

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • Перевірте доступність моделі

    bash
    openclaw models list --provider qwen
  • Standard (оплата за використання)

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

  • Отримайте ключ API

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

  • Запустіть початкове налаштування

    Для глобальної кінцевої точки:

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

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

    bash
    openclaw onboard --auth-choice qwen-standard-api-key-cn
  • Установіть модель за замовчуванням

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • Перевірте доступність моделі

    bash
    openclaw models list --provider qwen
  • Token Plan (командна редакція)

    Найкраще підходить для: командного доступу за передплатою на основі кредитів до Qwen і підтримуваних сторонніх моделей через Alibaba Cloud Model Studio.

  • Отримайте виділений ключ

    Призначте місце Token Plan і створіть для нього виділений ключ sk-sp-.... Ключі Token Plan, Coding Plan і ключі з оплатою за використання не є взаємозамінними. Див. огляд глобального Token Plan або огляд Token Plan для Китаю.

  • Запустіть початкове налаштування

    Для глобальної / міжнародної кінцевої точки в Сінгапурі:

    bash
    openclaw onboard --auth-choice qwen-token-plan

    Для кінцевої точки в Китаї, розташованої в Пекіні:

    bash
    openclaw onboard --auth-choice qwen-token-plan-cn
  • Перевірте постачальника

    bash
    openclaw models list --provider qwen-token-planopenclaw agent --model qwen-token-plan/qwen3.7-plus --message "Reply with: token plan ready"
  • Qwen OAuth / Portal

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

    Див. окрему сторінку постачальника Qwen OAuth / Portal і примітки щодо міграції.

  • Надайте токен Portal

    bash
    openclaw onboard --auth-choice qwen-oauth
  • Установіть модель за замовчуванням

    json5
    {  agents: {    defaults: {      model: { primary: "qwen-oauth/qwen3.5-plus" },    },  },}
  • Перевірте доступність моделі

    bash
    openclaw models list --provider qwen-oauth
  • Типи планів і кінцеві точки

    План Регіон Вибір автентифікації Кінцева точка
    Coding Plan (передплата) Китай qwen-api-key-cn coding.dashscope.aliyuncs.com/v1
    Coding Plan (передплата) Глобальний qwen-api-key coding-intl.dashscope.aliyuncs.com/v1
    Qwen Portal Глобальний qwen-oauth portal.qwen.ai/v1
    Standard (оплата за використання) Китай qwen-standard-api-key-cn dashscope.aliyuncs.com/compatible-mode/v1
    Standard (оплата за використання) Глобальний qwen-standard-api-key dashscope-intl.aliyuncs.com/compatible-mode/v1
    Token Plan (командна редакція) Китай qwen-token-plan-cn token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
    Token Plan (командна редакція) Глобальний qwen-token-plan token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

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

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

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

    Посилання на модель Вхідні дані Контекст Примітки
    qwen/qwen3.5-plus текст, зображення 1,000,000 Модель за замовчуванням
    qwen/qwen3.6-flash текст, зображення 1,000,000 Лише кінцеві точки Standard
    qwen/qwen3.6-plus текст, зображення 1,000,000 Coding Plan + Standard
    qwen/qwen3.7-max текст 1,000,000 Лише кінцеві точки Standard
    qwen/qwen3.7-plus текст, зображення 1,000,000 Coding Plan + Standard
    qwen/qwen3-max-2026-01-23 текст 262,144 Лінійка Qwen Max
    qwen/qwen3-coder-next текст 262,144 Програмування
    qwen/qwen3-coder-plus текст 1,000,000 Програмування
    qwen/MiniMax-M2.5 текст 1,000,000 Міркування ввімкнено
    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

    Каталог Token Plan

    Token Plan використовує окремий список дозволених точних рядків. Моделі плану, призначені лише для генерування зображень, тут не наведено, оскільки вони використовують інші API.

    Посилання на модель Вхідні дані Контекст
    qwen-token-plan/qwen3.7-max текст 1,000,000
    qwen-token-plan/qwen3.7-plus текст, зображення 1,000,000
    qwen-token-plan/qwen3.6-plus текст, зображення 1,000,000
    qwen-token-plan/qwen3.6-flash текст, зображення 1,000,000
    qwen-token-plan/deepseek-v4-pro текст 1,000,000
    qwen-token-plan/deepseek-v4-flash текст 1,000,000
    qwen-token-plan/deepseek-v3.2 текст 131,072
    qwen-token-plan/kimi-k2.7-code текст, зображення 262,144
    qwen-token-plan/kimi-k2.6 текст, зображення 262,144
    qwen-token-plan/kimi-k2.5 текст, зображення 262,144
    qwen-token-plan/glm-5.2 текст 1,000,000
    qwen-token-plan/glm-5.1 текст 202,752
    qwen-token-plan/glm-5 текст 202,752
    qwen-token-plan/MiniMax-M2.5 текст 196,608

    Керування міркуванням

    qwen3.7-max, qwen3.7-plus, qwen3.6-flash і qwen3.6-plus мають підтримку міркування у вбудованому каталозі. Для моделей із міркуванням сімейства qwen провайдер зіставляє рівні мислення OpenClaw із прапорцем запиту верхнього рівня enable_thinking у DashScope: вимкнене мислення надсилає enable_thinking: false, а будь-який інший рівень — enable_thinking: true. Власні моделі можуть використовувати альтернативне корисне навантаження мислення для шаблону чату, якщо в записі моделі встановити compat.thinkingFormat: "qwen-chat-template".

    Моделі Token Plan також позначено як такі, що підтримують міркування. kimi-k2.7-code і MiniMax-M2.5 працюють лише з мисленням, тому OpenClaw залишає мислення ввімкненим, навіть коли сеанс запитує /think off. Для DeepSeek V4 рівні від minimal до high зіставляються з рівнем зусиль high сервісу, а xhigh або max — із max. GLM 5.2 підтримує весь діапазон від minimal до max; GLM 5.1 і GLM 5 підтримують рівні до xhigh, а типовим рівнем для всіх трьох є high. Інші гібридні моделі дотримуються запитаного стану ввімкнення або вимкнення.

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

    Plugin 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; додаткова конфігурація не потрібна. Щоб розпізнавання медіафайлів працювало, переконайтеся, що використовуєте кінцеву точку Standard (з оплатою за використання).

    Щоб зробити Qwen типовим провайдером відео:

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

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

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

    Доступність Qwen 3.6 і 3.7

    qwen3.7-plus і qwen3.6-plus доступні на кінцевих точках Coding Plan і Standard. qwen3.7-max і qwen3.6-flash доступні лише на Standard. Кінцеві точки Standard (з оплатою за використання):

    • Китай: dashscope.aliyuncs.com/compatible-mode/v1
    • Глобальна: dashscope-intl.aliyuncs.com/compatible-mode/v1

    OpenClaw не включає qwen3.7-max і qwen3.6-flash до каталогів Coding Plan. Якщо кінцева точка Coding Plan повертає помилку «модель не підтримується» для будь-якої з них, перейдіть на відповідну кінцеву точку Standard і ключ.

    Регіональна маршрутизація генерування відео

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

    • Глобальний/міжнародний: https://dashscope-intl.aliyuncs.com
    • Китай: https://dashscope.aliyuncs.com

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

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

    Власні кінцеві точки Qwen оголошують сумісність обліку використання під час потокового передавання у спільному транспорті openai-completions, тому власні ідентифікатори провайдерів, сумісних із DashScope і націлених на ті самі власні хости, успадковують таку саму поведінку без обов’язкової прив’язки саме до вбудованого ідентифікатора провайдера qwen. Це стосується кінцевих точок Coding Plan, Standard і Token Plan:

    • 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
    • https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
    • https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
    План можливостей

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

    • Моделі тексту/чату: доступні через Plugin
    • Виклики інструментів, структурований вивід, мислення: успадковуються від транспорту, сумісного з OpenAI
    • Генерування зображень: заплановано на рівні Plugin провайдера
    • Розпізнавання зображень і відео: доступне через Plugin на кінцевій точці Standard
    • Мовлення/аудіо: заплановано на рівні Plugin провайдера
    • Векторні подання пам’яті/повторне ранжування: заплановано через поверхню адаптера векторних подань
    • Генерування відео: доступне через Plugin завдяки спільній можливості генерування відео
    Налаштування середовища й фонової служби

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

    Пов’язані матеріали

    Was this useful?
    On this page

    On this page