Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Qwen OAuth видалено. Інтеграція OAuth безкоштовного рівня (qwen-portal), яка використовувала кінцеві точки portal.qwen.ai, більше недоступна. Див. Issue #49557 для контексту.
OpenClaw тепер розглядає Qwen як першокласного вбудованого провайдера з канонічним ідентифікатором qwen. Вбудований провайдер націлений на кінцеві точки Qwen Cloud / Alibaba DashScope і Coding Plan та зберігає роботу застарілих ідентифікаторів modelstudio як псевдоніма сумісності.
  • Провайдер: qwen
  • Бажана змінна середовища: QWEN_API_KEY
  • Також приймається для сумісності: MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
  • Стиль API: сумісний з OpenAI
Якщо вам потрібен qwen3.6-plus, віддавайте перевагу кінцевій точці Standard (оплата за використання). Підтримка Coding Plan може відставати від публічного каталогу.

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

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

Отримайте свій API-ключ

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

Запустіть onboarding

Для кінцевої точки Global:
openclaw onboard --auth-choice qwen-api-key
Для кінцевої точки China:
openclaw onboard --auth-choice qwen-api-key-cn
3

Установіть модель за замовчуванням

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

Перевірте, що модель доступна

openclaw models list --provider qwen
Застарілі ідентифікатори auth-choice modelstudio-* і посилання на моделі modelstudio/... досі працюють як псевдоніми сумісності, але нові потоки налаштування мають віддавати перевагу канонічним ідентифікаторам auth-choice qwen-* і посиланням на моделі qwen/.... Якщо ви визначите точний користувацький запис models.providers.modelstudio з іншим значенням api, цей користувацький провайдер володітиме посиланнями modelstudio/... замість псевдоніма сумісності Qwen.

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

ПланРегіонВибір автентифікаціїКінцева точка
Standard (оплата за використання)Chinaqwen-standard-api-key-cndashscope.aliyuncs.com/compatible-mode/v1
Standard (оплата за використання)Globalqwen-standard-api-keydashscope-intl.aliyuncs.com/compatible-mode/v1
Coding Plan (підписка)Chinaqwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Coding Plan (підписка)Globalqwen-api-keycoding-intl.dashscope.aliyuncs.com/v1
Провайдер автоматично вибирає кінцеву точку на основі вашого вибору автентифікації. Канонічні варіанти використовують сімейство qwen-*; modelstudio-* залишається лише для сумісності. Ви можете перевизначити це за допомогою користувацького baseUrl у конфігурації.
Керування ключами: home.qwencloud.com/api-keys | Документація: docs.qwencloud.com

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

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Кодування
qwen/qwen3-coder-plusтекст1,000,000Кодування
qwen/MiniMax-M2.5текст1,000,000Увімкнено reasoning
qwen/glm-5текст202,752GLM
qwen/glm-4.7текст202,752GLM
qwen/kimi-k2.5текст, зображення262,144Moonshot AI через Alibaba
Доступність усе ще може відрізнятися залежно від кінцевої точки й тарифного плану, навіть коли модель наявна у вбудованому каталозі.

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

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

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

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 як провайдера відео за замовчуванням:
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
    },
  },
}
Див. Генерація відео щодо спільних параметрів інструмента, вибору провайдера та поведінки failover.

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

Вбудований Plugin Qwen реєструє розуміння медіа для зображень і відео на кінцевих точках DashScope Standard (не на кінцевих точках Coding Plan).
ВластивістьЗначення
Модельqwen-vl-max-latest
Підтримуваний вхідЗображення, відео
Розуміння медіа автоматично визначається з налаштованої автентифікації Qwen — додаткова конфігурація не потрібна. Переконайтеся, що ви використовуєте кінцеву точку Standard (оплата за використання) для підтримки розуміння медіа.
qwen3.6-plus доступна на кінцевих точках Standard (оплата за використання) 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 (оплата за використання) замість пари кінцева точка/ключ Coding Plan.Вбудований каталог Qwen в OpenClaw не рекламує qwen3.6-plus на кінцевих точках Coding Plan, але явно налаштовані записи qwen/qwen3.6-plus у models.providers.qwen.models поважаються на baseUrls Coding Plan, тож ви можете ввімкнути цю модель, якщо Aliyun увімкне її для вашої підписки. Вищестоящий API усе одно вирішує, чи буде виклик успішним.
Plugin qwen позиціонується як домівка постачальника для всієї поверхні Qwen Cloud, а не лише для моделей кодування/тексту.
  • Текстові/чат-моделі: вбудовано зараз
  • Виклики інструментів, структурований вивід, мислення: успадковано від сумісного з OpenAI транспорту
  • Генерація зображень: заплановано на рівні provider-plugin
  • Розуміння зображень/відео: вбудовано зараз на кінцевій точці Standard
  • Мовлення/аудіо: заплановано на рівні provider-plugin
  • Ембеддинги пам’яті/переранжування: заплановано через поверхню адаптера ембеддингів
  • Генерація відео: вбудовано зараз через спільну можливість генерації відео
Для генерації відео 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 оголошують сумісність використання streaming у спільному транспорті openai-completions. OpenClaw тепер прив’язує це до можливостей кінцевої точки, тому користувацькі ідентифікатори провайдерів, сумісні з DashScope і націлені на ті самі нативні хости, успадковують таку саму поведінку streaming-usage замість вимоги саме вбудованого ідентифікатора провайдера qwen.Сумісність native-streaming usage застосовується і до хостів Coding Plan, і до сумісних із DashScope хостів Standard:
  • 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 Standard, а не кінцеві точки Coding Plan:
  • Базовий URL Standard Global/Intl: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
  • Базовий URL Standard China: https://dashscope.aliyuncs.com/compatible-mode/v1
Якщо Gateway працює як демон (launchd/systemd), переконайтеся, що QWEN_API_KEY доступний цьому процесу (наприклад, у ~/.openclaw/.env або через env.shellEnv).

Пов’язане

Вибір моделі

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

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

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

Alibaba (ModelStudio)

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

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

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