diff --git a/docs/uk/providers/comfy.md b/docs/uk/providers/comfy.md index c8a8d05f5..bd1b234ca 100644 --- a/docs/uk/providers/comfy.md +++ b/docs/uk/providers/comfy.md @@ -1,28 +1,30 @@ --- read_when: - Ви хочете використовувати локальні робочі процеси ComfyUI з OpenClaw - - Ви хочете використовувати Comfy Cloud із робочими процесами зображень, відео або музики - - Вам потрібні ключі конфігурації вбудованого плагіна comfy -summary: Налаштування генерації зображень, відео та музики через робочі процеси ComfyUI в OpenClaw + - Ви хочете використовувати Comfy Cloud із робочими процесами для зображень, відео або музики + - Вам потрібні ключі конфігурації bundled Plugin comfy +summary: Налаштування робочого процесу ComfyUI для генерації зображень, відео та музики в OpenClaw title: ComfyUI x-i18n: - generated_at: "2026-04-06T01:05:21Z" + generated_at: "2026-04-12T10:12:17Z" model: gpt-5.4 provider: openai - source_hash: e645f32efdffdf4cd498684f1924bb953a014d3656b48f4b503d64e38c61ba9c + source_hash: 85db395b171f37f80b34b22f3e7707bffc1fd9138e7d10687eef13eaaa55cf24 source_path: providers/comfy.md workflow: 15 --- # ComfyUI -OpenClaw постачається з вбудованим плагіном `comfy` для запусків ComfyUI на основі робочих процесів. +OpenClaw постачається з вбудованим Plugin `comfy` для запусків ComfyUI на основі робочих процесів. Plugin повністю керується робочими процесами, тому OpenClaw не намагається зіставляти загальні параметри `size`, `aspectRatio`, `resolution`, `durationSeconds` або елементи керування в стилі TTS з вашим графом. -- Провайдер: `comfy` -- Моделі: `comfy/workflow` -- Спільні поверхні: `image_generate`, `video_generate`, `music_generate` -- Автентифікація: не потрібна для локального ComfyUI; `COMFY_API_KEY` або `COMFY_CLOUD_API_KEY` для Comfy Cloud -- API: ComfyUI `/prompt` / `/history` / `/view` і Comfy Cloud `/api/*` +| Властивість | Деталі | +| ---------------- | -------------------------------------------------------------------------------- | +| Провайдер | `comfy` | +| Моделі | `comfy/workflow` | +| Спільні поверхні | `image_generate`, `video_generate`, `music_generate` | +| Автентифікація | Немає для локального ComfyUI; `COMFY_API_KEY` або `COMFY_CLOUD_API_KEY` для Comfy Cloud | +| API | ComfyUI `/prompt` / `/history` / `/view` і Comfy Cloud `/api/*` | ## Що підтримується @@ -33,14 +35,140 @@ OpenClaw постачається з вбудованим плагіном `comf - Генерація музики або аудіо через спільний інструмент `music_generate` - Завантаження результатів із налаштованого вузла або з усіх відповідних вузлів виводу -Вбудований плагін керується робочими процесами, тому OpenClaw не намагається зіставляти загальні -`size`, `aspectRatio`, `resolution`, `durationSeconds` або елементи керування у стилі TTS -з вашим графом. +## Початок роботи -## Структура конфігурації +Оберіть між запуском ComfyUI на власному комп’ютері або використанням Comfy Cloud. -Comfy підтримує спільні налаштування з'єднання верхнього рівня, а також розділи -робочих процесів для кожної можливості: + + + **Найкраще підходить для:** запуску власного екземпляра ComfyUI на вашому комп’ютері або в LAN. + + + + Переконайтеся, що ваш локальний екземпляр ComfyUI запущений (типово `http://127.0.0.1:8188`). + + + Експортуйте або створіть JSON-файл робочого процесу ComfyUI. Зверніть увагу на ID вузлів для вузла введення запиту та вузла виводу, з якого OpenClaw має читати дані. + + + Установіть `mode: "local"` і вкажіть файл вашого робочого процесу. Ось мінімальний приклад для зображень: + + ```json5 + { + models: { + providers: { + comfy: { + mode: "local", + baseUrl: "http://127.0.0.1:8188", + image: { + workflowPath: "./workflows/flux-api.json", + promptNodeId: "6", + outputNodeId: "9", + }, + }, + }, + }, + } + ``` + + + Спрямуйте OpenClaw на модель `comfy/workflow` для можливості, яку ви налаштували: + + ```json5 + { + agents: { + defaults: { + imageGenerationModel: { + primary: "comfy/workflow", + }, + }, + }, + } + ``` + + + ```bash + openclaw models list --provider comfy + ``` + + + + + + + **Найкраще підходить для:** запуску робочих процесів у Comfy Cloud без керування локальними ресурсами GPU. + + + + Зареєструйтеся на [comfy.org](https://comfy.org) і згенеруйте API-ключ на інформаційній панелі свого облікового запису. + + + Надайте ключ одним із цих способів: + + ```bash + # Змінна середовища (рекомендовано) + export COMFY_API_KEY="your-key" + + # Альтернативна змінна середовища + export COMFY_CLOUD_API_KEY="your-key" + + # Або безпосередньо в конфігурації + openclaw config set models.providers.comfy.apiKey "your-key" + ``` + + + Експортуйте або створіть JSON-файл робочого процесу ComfyUI. Зверніть увагу на ID вузлів для вузла введення запиту та вузла виводу. + + + Установіть `mode: "cloud"` і вкажіть файл вашого робочого процесу: + + ```json5 + { + models: { + providers: { + comfy: { + mode: "cloud", + image: { + workflowPath: "./workflows/flux-api.json", + promptNodeId: "6", + outputNodeId: "9", + }, + }, + }, + }, + } + ``` + + + У режимі cloud для `baseUrl` типово використовується `https://cloud.comfy.org`. Вам потрібно вказати `baseUrl`, лише якщо ви використовуєте власну cloud-адресу. + + + + ```json5 + { + agents: { + defaults: { + imageGenerationModel: { + primary: "comfy/workflow", + }, + }, + }, + } + ``` + + + ```bash + openclaw models list --provider comfy + ``` + + + + + + +## Конфігурація + +Comfy підтримує спільні налаштування з’єднання верхнього рівня, а також розділи робочих процесів для окремих можливостей (`image`, `video`, `music`): ```json5 { @@ -70,140 +198,164 @@ Comfy підтримує спільні налаштування з'єднанн } ``` -Спільні ключі: +### Спільні ключі -- `mode`: `local` або `cloud` -- `baseUrl`: типово `http://127.0.0.1:8188` для локального режиму або `https://cloud.comfy.org` для хмарного -- `apiKey`: необов'язкова вбудована альтернатива ключу через змінні середовища -- `allowPrivateNetwork`: дозволяє приватний/LAN `baseUrl` у хмарному режимі +| Ключ | Тип | Опис | +| --------------------- | ---------------------- | ------------------------------------------------------------------------------------ | +| `mode` | `"local"` or `"cloud"` | Режим з’єднання. | +| `baseUrl` | string | Типово `http://127.0.0.1:8188` для local або `https://cloud.comfy.org` для cloud. | +| `apiKey` | string | Необов’язковий ключ у конфігурації, альтернатива змінним середовища `COMFY_API_KEY` / `COMFY_CLOUD_API_KEY`. | +| `allowPrivateNetwork` | boolean | Дозволяє приватний/LAN `baseUrl` у режимі cloud. | -Ключі для кожної можливості в `image`, `video` або `music`: +### Ключі для окремих можливостей -- `workflow` або `workflowPath`: обов'язково -- `promptNodeId`: обов'язково -- `promptInputName`: типово `text` -- `outputNodeId`: необов'язково -- `pollIntervalMs`: необов'язково -- `timeoutMs`: необов'язково +Ці ключі застосовуються всередині розділів `image`, `video` або `music`: -Розділи зображень і відео також підтримують: +| Ключ | Обов’язково | Типово | Опис | +| ---------------------------- | ----------- | -------- | --------------------------------------------------------------------------- | +| `workflow` or `workflowPath` | Так | -- | Шлях до JSON-файлу робочого процесу ComfyUI. | +| `promptNodeId` | Так | -- | ID вузла, який отримує текстовий запит. | +| `promptInputName` | Ні | `"text"` | Назва входу у вузлі запиту. | +| `outputNodeId` | Ні | -- | ID вузла, з якого читати результат. Якщо не вказано, використовуються всі відповідні вузли виводу. | +| `pollIntervalMs` | Ні | -- | Інтервал опитування в мілісекундах для завершення завдання. | +| `timeoutMs` | Ні | -- | Тайм-аут у мілісекундах для виконання робочого процесу. | -- `inputImageNodeId`: обов'язково, коли ви передаєте еталонне зображення -- `inputImageInputName`: типово `image` +Розділи `image` і `video` також підтримують: -## Зворотна сумісність +| Ключ | Обов’язково | Типово | Опис | +| --------------------- | ------------------------------------- | --------- | --------------------------------------------------- | +| `inputImageNodeId` | Так (коли передається еталонне зображення) | -- | ID вузла, який отримує завантажене еталонне зображення. | +| `inputImageInputName` | Ні | `"image"` | Назва входу у вузлі зображення. | -Наявна конфігурація зображень верхнього рівня все ще працює: +## Деталі робочих процесів -```json5 -{ - models: { - providers: { - comfy: { - workflowPath: "./workflows/flux-api.json", - promptNodeId: "6", - outputNodeId: "9", - }, - }, - }, -} -``` + + + Установіть модель зображень за замовчуванням на `comfy/workflow`: -OpenClaw розглядає цю застарілу форму як конфігурацію робочого процесу зображень. - -## Робочі процеси зображень - -Установіть типову модель зображень: - -```json5 -{ - agents: { - defaults: { - imageGenerationModel: { - primary: "comfy/workflow", - }, - }, - }, -} -``` - -Приклад редагування з еталонним зображенням: - -```json5 -{ - models: { - providers: { - comfy: { - image: { - workflowPath: "./workflows/edit-api.json", - promptNodeId: "6", - inputImageNodeId: "7", - inputImageInputName: "image", - outputNodeId: "9", + ```json5 + { + agents: { + defaults: { + imageGenerationModel: { + primary: "comfy/workflow", + }, }, }, - }, - }, -} -``` + } + ``` -## Робочі процеси відео + **Приклад редагування з використанням еталонного зображення:** -Установіть типову модель відео: + Щоб увімкнути редагування зображень із завантаженим еталонним зображенням, додайте `inputImageNodeId` до конфігурації `image`: -```json5 -{ - agents: { - defaults: { - videoGenerationModel: { - primary: "comfy/workflow", + ```json5 + { + models: { + providers: { + comfy: { + image: { + workflowPath: "./workflows/edit-api.json", + promptNodeId: "6", + inputImageNodeId: "7", + inputImageInputName: "image", + outputNodeId: "9", + }, + }, + }, }, - }, - }, -} -``` + } + ``` -Робочі процеси відео Comfy наразі підтримують перетворення тексту на відео та -зображення на відео через налаштований граф. OpenClaw не передає вхідні відео -до робочих процесів Comfy. + -## Робочі процеси музики + + Установіть модель відео за замовчуванням на `comfy/workflow`: -Вбудований плагін реєструє провайдера генерації музики для визначених робочим процесом -аудіо- або музичних результатів, доступних через спільний інструмент `music_generate`: + ```json5 + { + agents: { + defaults: { + videoGenerationModel: { + primary: "comfy/workflow", + }, + }, + }, + } + ``` -```text -/tool music_generate prompt="Warm ambient synth loop with soft tape texture" -``` + Робочі процеси Comfy для відео підтримують текст-у-відео та зображення-у-відео через налаштований граф. -Використовуйте розділ конфігурації `music`, щоб указати JSON вашого аудіоробочого процесу та -вузол виводу. + + OpenClaw не передає вхідні відео в робочі процеси Comfy. Як вхідні дані підтримуються лише текстові запити та окремі еталонні зображення. + -## Comfy Cloud + -Використовуйте `mode: "cloud"` плюс один із варіантів: + + Вбудований Plugin реєструє провайдера генерації музики для визначених робочим процесом аудіо- або музичних результатів, доступного через спільний інструмент `music_generate`: -- `COMFY_API_KEY` -- `COMFY_CLOUD_API_KEY` -- `models.providers.comfy.apiKey` + ```text + /tool music_generate prompt="Warm ambient synth loop with soft tape texture" + ``` -Хмарний режим, як і раніше, використовує ті самі розділи робочих процесів `image`, `video` і `music`. + Використовуйте розділ конфігурації `music`, щоб вказати JSON вашого аудіоробочого процесу та вузол виводу. -## Live тести + -Для вбудованого плагіна є покриття Live тестами за явним увімкненням: + + Наявна конфігурація зображень верхнього рівня (без вкладеного розділу `image`) як і раніше працює: -```bash -OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts -``` + ```json5 + { + models: { + providers: { + comfy: { + workflowPath: "./workflows/flux-api.json", + promptNodeId: "6", + outputNodeId: "9", + }, + }, + }, + } + ``` -Live тест пропускає окремі сценарії для зображень, відео або музики, якщо відповідний -розділ робочого процесу Comfy не налаштовано. + OpenClaw розглядає цю застарілу форму як конфігурацію робочого процесу для зображень. Вам не потрібно негайно виконувати міграцію, але для нових налаштувань рекомендуються вкладені розділи `image` / `video` / `music`. -## Пов'язане + + Якщо ви використовуєте лише генерацію зображень, застаріла пласка конфігурація та новий вкладений розділ `image` функціонально еквівалентні. + -- [Генерація зображень](/uk/tools/image-generation) -- [Генерація відео](/uk/tools/video-generation) -- [Генерація музики](/uk/tools/music-generation) -- [Каталог провайдерів](/uk/providers/index) -- [Довідник із конфігурації](/uk/gateway/configuration-reference#agent-defaults) + + + + Для вбудованого Plugin існує live-покриття за явним увімкненням: + + ```bash + OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts + ``` + + Live-тест пропускає окремі сценарії для зображень, відео або музики, якщо не налаштовано відповідний розділ робочого процесу Comfy. + + + + +## Пов’язане + + + + Налаштування та використання інструмента генерації зображень. + + + Налаштування та використання інструмента генерації відео. + + + Налаштування генерації музики та аудіо. + + + Огляд усіх провайдерів і посилань на моделі. + + + Повний довідник із конфігурації, включно з типовими значеннями агентів. + + diff --git a/docs/uk/providers/huggingface.md b/docs/uk/providers/huggingface.md index e3109b051..2a9d54453 100644 --- a/docs/uk/providers/huggingface.md +++ b/docs/uk/providers/huggingface.md @@ -1,50 +1,70 @@ --- read_when: - Ви хочете використовувати Hugging Face Inference з OpenClaw - - Вам потрібна env var токена HF або варіант auth для CLI -summary: Налаштування Hugging Face Inference (auth + вибір моделі) + - Вам потрібна змінна середовища токена HF або варіант автентифікації CLI +summary: Налаштування Hugging Face Inference (автентифікація + вибір моделі) title: Hugging Face (Inference) x-i18n: - generated_at: "2026-04-05T18:14:27Z" + generated_at: "2026-04-12T10:12:24Z" model: gpt-5.4 provider: openai - source_hash: 692d2caffbaf991670260da393c67ae7e6349b9e1e3ed5cb9a514f8a77192e86 + source_hash: 7787fce1acfe81adb5380ab1c7441d661d03c574da07149c037d3b6ba3c8e52a source_path: providers/huggingface.md workflow: 15 --- # Hugging Face (Inference) -[Hugging Face Inference Providers](https://huggingface.co/docs/inference-providers) пропонують сумісні з OpenAI chat completions через єдиний router API. Ви отримуєте доступ до багатьох моделей (DeepSeek, Llama та інших) з одним токеном. OpenClaw використовує **сумісний з OpenAI endpoint** (лише chat completions); для text-to-image, embeddings або speech використовуйте [клієнти HF inference](https://huggingface.co/docs/api-inference/quicktour) напряму. +[Провайдери Hugging Face Inference](https://huggingface.co/docs/inference-providers) пропонують OpenAI-сумісні chat completions через єдиний router API. Ви отримуєте доступ до багатьох моделей (DeepSeek, Llama та інших) з одним токеном. OpenClaw використовує **OpenAI-сумісний endpoint** (лише chat completions); для text-to-image, embeddings або speech використовуйте [HF inference clients](https://huggingface.co/docs/api-inference/quicktour) напряму. - Провайдер: `huggingface` -- Auth: `HUGGINGFACE_HUB_TOKEN` або `HF_TOKEN` (fine-grained token з дозволом **Make calls to Inference Providers**) -- API: сумісний з OpenAI (`https://router.huggingface.co/v1`) -- Оплата: один токен HF; [тарифи](https://huggingface.co/docs/inference-providers/pricing) відповідають тарифам провайдерів із безкоштовним рівнем. +- Автентифікація: `HUGGINGFACE_HUB_TOKEN` або `HF_TOKEN` (fine-grained token з дозволом **Make calls to Inference Providers**) +- API: OpenAI-сумісний (`https://router.huggingface.co/v1`) +- Оплата: один токен HF; [тарифи](https://huggingface.co/docs/inference-providers/pricing) відповідають ставкам провайдерів і мають безкоштовний рівень. -## Швидкий початок +## Початок роботи -1. Створіть fine-grained token у [Hugging Face → Settings → Tokens](https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained) з дозволом **Make calls to Inference Providers**. -2. Запустіть onboarding і виберіть **Hugging Face** у випадному списку провайдерів, а потім введіть свій API-ключ, коли з’явиться запит: + + + Перейдіть до [Hugging Face Settings Tokens](https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained) і створіть новий fine-grained token. -```bash -openclaw onboard --auth-choice huggingface-api-key -``` + + Для токена має бути ввімкнено дозвіл **Make calls to Inference Providers**, інакше API-запити буде відхилено. + -3. У випадному списку **Default Hugging Face model** виберіть потрібну модель (список завантажується з Inference API, коли у вас є дійсний токен; інакше показується вбудований список). Ваш вибір зберігається як типова модель. -4. Ви також можете встановити або змінити типову модель пізніше в конфігурації: + + + Виберіть **Hugging Face** у випадаючому списку провайдера, а потім введіть свій API-ключ, коли з’явиться запит: -```json5 -{ - agents: { - defaults: { - model: { primary: "huggingface/deepseek-ai/DeepSeek-R1" }, - }, - }, -} -``` + ```bash + openclaw onboard --auth-choice huggingface-api-key + ``` -## Неінтерактивний приклад + + + У випадаючому списку **Default Hugging Face model** виберіть потрібну модель. Список завантажується з Inference API, якщо у вас є дійсний токен; інакше показується вбудований список. Ваш вибір зберігається як модель за замовчуванням. + + Ви також можете встановити або змінити модель за замовчуванням пізніше в config: + + ```json5 + { + agents: { + defaults: { + model: { primary: "huggingface/deepseek-ai/DeepSeek-R1" }, + }, + }, + } + ``` + + + + ```bash + openclaw models list --provider huggingface + ``` + + + +### Неінтерактивне налаштування ```bash openclaw onboard --non-interactive \ @@ -53,148 +73,172 @@ openclaw onboard --non-interactive \ --huggingface-api-key "$HF_TOKEN" ``` -Це встановить `huggingface/deepseek-ai/DeepSeek-R1` як типову модель. +Це встановить `huggingface/deepseek-ai/DeepSeek-R1` як модель за замовчуванням. -## Примітка щодо середовища +## ID моделей -Якщо Gateway працює як служба (launchd/systemd), переконайтеся, що `HUGGINGFACE_HUB_TOKEN` або `HF_TOKEN` -доступний цьому процесу (наприклад, у `~/.openclaw/.env` або через -`env.shellEnv`). +Посилання на моделі використовують формат `huggingface//` (Hub-style ID). Список нижче взято з **GET** `https://router.huggingface.co/v1/models`; ваш каталог може містити більше. -## Виявлення моделей і випадний список onboarding +| Модель | Ref (додайте префікс `huggingface/`) | +| ---------------------- | ------------------------------------ | +| DeepSeek R1 | `deepseek-ai/DeepSeek-R1` | +| DeepSeek V3.2 | `deepseek-ai/DeepSeek-V3.2` | +| Qwen3 8B | `Qwen/Qwen3-8B` | +| Qwen2.5 7B Instruct | `Qwen/Qwen2.5-7B-Instruct` | +| Qwen3 32B | `Qwen/Qwen3-32B` | +| Llama 3.3 70B Instruct | `meta-llama/Llama-3.3-70B-Instruct` | +| Llama 3.1 8B Instruct | `meta-llama/Llama-3.1-8B-Instruct` | +| GPT-OSS 120B | `openai/gpt-oss-120b` | +| GLM 4.7 | `zai-org/GLM-4.7` | +| Kimi K2.5 | `moonshotai/Kimi-K2.5` | -OpenClaw виявляє моделі, викликаючи **Inference endpoint напряму**: + +Ви можете додати `:fastest` або `:cheapest` до будь-якого ID моделі. Установіть порядок за замовчуванням у [налаштуваннях Inference Provider](https://hf.co/settings/inference-providers); див. [Inference Providers](https://huggingface.co/docs/inference-providers) і **GET** `https://router.huggingface.co/v1/models` для повного списку. + -```bash -GET https://router.huggingface.co/v1/models -``` +## Додаткові подробиці -(Необов’язково: надішліть `Authorization: Bearer $HUGGINGFACE_HUB_TOKEN` або `$HF_TOKEN`, щоб отримати повний список; деякі endpoint повертають підмножину без auth.) Відповідь має формат OpenAI `{ "object": "list", "data": [ { "id": "Qwen/Qwen3-8B", "owned_by": "Qwen", ... }, ... ] }`. + + + OpenClaw виявляє моделі, викликаючи **endpoint Inference напряму**: -Коли ви налаштовуєте API-ключ Hugging Face (через onboarding, `HUGGINGFACE_HUB_TOKEN` або `HF_TOKEN`), OpenClaw використовує цей GET для виявлення доступних моделей chat completion. Під час **інтерактивного налаштування**, після введення токена, ви побачите випадний список **Default Hugging Face model**, заповнений з цього списку (або з вбудованого каталогу, якщо запит не вдався). Під час runtime (наприклад, під час запуску Gateway), коли ключ присутній, OpenClaw знову викликає **GET** `https://router.huggingface.co/v1/models`, щоб оновити каталог. Список об’єднується з вбудованим каталогом (для метаданих, як-от контекстне вікно і вартість). Якщо запит не вдається або ключ не задано, використовується лише вбудований каталог. + ```bash + GET https://router.huggingface.co/v1/models + ``` -## Назви моделей і редаговані параметри + (Необов’язково: надсилайте `Authorization: Bearer $HUGGINGFACE_HUB_TOKEN` або `$HF_TOKEN` для повного списку; деякі endpoint без автентифікації повертають лише підмножину.) Відповідь має формат OpenAI `{ "object": "list", "data": [ { "id": "Qwen/Qwen3-8B", "owned_by": "Qwen", ... }, ... ] }`. -- **Назва з API:** Відображувана назва моделі **гідратується з GET /v1/models**, коли API повертає `name`, `title` або `display_name`; інакше вона виводиться з id моделі (наприклад, `deepseek-ai/DeepSeek-R1` → “DeepSeek R1”). -- **Перевизначення відображуваної назви:** Ви можете встановити власну мітку для кожної моделі в конфігурації, щоб вона відображалася у CLI та UI так, як вам потрібно: + Коли ви налаштовуєте API-ключ Hugging Face (через онбординг, `HUGGINGFACE_HUB_TOKEN` або `HF_TOKEN`), OpenClaw використовує цей GET для виявлення доступних моделей chat-completion. Під час **інтерактивного налаштування**, після введення токена, ви побачите випадаючий список **Default Hugging Face model**, заповнений із цього списку (або з вбудованого каталогу, якщо запит не вдасться). Під час виконання (наприклад, під час запуску Gateway), якщо ключ наявний, OpenClaw знову викликає **GET** `https://router.huggingface.co/v1/models`, щоб оновити каталог. Список об’єднується з вбудованим каталогом (для метаданих, як-от context window і вартість). Якщо запит не вдається або ключ не задано, використовується лише вбудований каталог. -```json5 -{ - agents: { - defaults: { - models: { - "huggingface/deepseek-ai/DeepSeek-R1": { alias: "DeepSeek R1 (fast)" }, - "huggingface/deepseek-ai/DeepSeek-R1:cheapest": { alias: "DeepSeek R1 (cheap)" }, + + + + - **Назва з API:** Відображувана назва моделі **заповнюється з GET /v1/models**, коли API повертає `name`, `title` або `display_name`; інакше вона виводиться з ID моделі (наприклад, `deepseek-ai/DeepSeek-R1` стає "DeepSeek R1"). + - **Перевизначення відображуваної назви:** Ви можете задати власну мітку для кожної моделі в config, щоб вона відображалася в CLI та UI так, як вам потрібно: + + ```json5 + { + agents: { + defaults: { + models: { + "huggingface/deepseek-ai/DeepSeek-R1": { alias: "DeepSeek R1 (fast)" }, + "huggingface/deepseek-ai/DeepSeek-R1:cheapest": { alias: "DeepSeek R1 (cheap)" }, + }, + }, }, - }, - }, -} -``` + } + ``` -- **Суфікси політик:** Вбудована документація й допоміжні функції OpenClaw для Hugging Face наразі розглядають ці два суфікси як вбудовані варіанти політик: - - **`:fastest`** — найвища пропускна здатність. - - **`:cheapest`** — найнижча вартість за вихідний токен. + - **Суфікси політик:** У вбудованій документації та helper-утилітах Hugging Face в OpenClaw ці два суфікси наразі розглядаються як вбудовані варіанти політик: + - **`:fastest`** — найвища пропускна здатність. + - **`:cheapest`** — найнижча вартість за вихідний токен. - Ви можете додати їх як окремі записи в `models.providers.huggingface.models` або встановити `model.primary` із цим суфіксом. Ви також можете задати типовий порядок провайдерів у [Inference Provider settings](https://hf.co/settings/inference-providers) (без суфікса = використовувати цей порядок). + Ви можете додати їх як окремі записи в `models.providers.huggingface.models` або встановити `model.primary` із суфіксом. Ви також можете задати порядок провайдерів за замовчуванням у [налаштуваннях Inference Provider](https://hf.co/settings/inference-providers) (без суфікса = використовувати цей порядок). -- **Об’єднання конфігурації:** Наявні записи в `models.providers.huggingface.models` (наприклад, у `models.json`) зберігаються під час об’єднання конфігурації. Тому будь-які власні `name`, `alias` або параметри моделі, які ви там задасте, буде збережено. + - **Об’єднання config:** Наявні записи в `models.providers.huggingface.models` (наприклад, у `models.json`) зберігаються під час об’єднання config. Тож будь-які власні `name`, `alias` або параметри моделі, які ви там задали, буде збережено. -## Ідентифікатори моделей і приклади конфігурації + -Посилання на моделі використовують формат `huggingface//` (id у стилі Hub). Наведений нижче список узято з **GET** `https://router.huggingface.co/v1/models`; ваш каталог може містити більше. + + Якщо Gateway працює як демон (launchd/systemd), переконайтеся, що `HUGGINGFACE_HUB_TOKEN` або `HF_TOKEN` доступні цьому процесу (наприклад, у `~/.openclaw/.env` або через `env.shellEnv`). -**Приклади id (з inference endpoint):** + + OpenClaw приймає і `HUGGINGFACE_HUB_TOKEN`, і `HF_TOKEN` як псевдоніми змінних середовища. Працює будь-яка з них; якщо задано обидві, пріоритет має `HUGGINGFACE_HUB_TOKEN`. + -| Модель | Ref (з префіксом `huggingface/`) | -| ---------------------- | ----------------------------------- | -| DeepSeek R1 | `deepseek-ai/DeepSeek-R1` | -| DeepSeek V3.2 | `deepseek-ai/DeepSeek-V3.2` | -| Qwen3 8B | `Qwen/Qwen3-8B` | -| Qwen2.5 7B Instruct | `Qwen/Qwen2.5-7B-Instruct` | -| Qwen3 32B | `Qwen/Qwen3-32B` | -| Llama 3.3 70B Instruct | `meta-llama/Llama-3.3-70B-Instruct` | -| Llama 3.1 8B Instruct | `meta-llama/Llama-3.1-8B-Instruct` | -| GPT-OSS 120B | `openai/gpt-oss-120b` | -| GLM 4.7 | `zai-org/GLM-4.7` | -| Kimi K2.5 | `moonshotai/Kimi-K2.5` | + -Ви можете додати `:fastest` або `:cheapest` до id моделі. Задайте типовий порядок у [Inference Provider settings](https://hf.co/settings/inference-providers); див. [Inference Providers](https://huggingface.co/docs/inference-providers) і **GET** `https://router.huggingface.co/v1/models` для повного списку. - -### Повні приклади конфігурації - -**Основна DeepSeek R1 із резервною Qwen:** - -```json5 -{ - agents: { - defaults: { - model: { - primary: "huggingface/deepseek-ai/DeepSeek-R1", - fallbacks: ["huggingface/Qwen/Qwen3-8B"], + + ```json5 + { + agents: { + defaults: { + model: { + primary: "huggingface/deepseek-ai/DeepSeek-R1", + fallbacks: ["huggingface/Qwen/Qwen3-8B"], + }, + models: { + "huggingface/deepseek-ai/DeepSeek-R1": { alias: "DeepSeek R1" }, + "huggingface/Qwen/Qwen3-8B": { alias: "Qwen3 8B" }, + }, + }, }, - models: { - "huggingface/deepseek-ai/DeepSeek-R1": { alias: "DeepSeek R1" }, - "huggingface/Qwen/Qwen3-8B": { alias: "Qwen3 8B" }, + } + ``` + + + + ```json5 + { + agents: { + defaults: { + model: { primary: "huggingface/Qwen/Qwen3-8B" }, + models: { + "huggingface/Qwen/Qwen3-8B": { alias: "Qwen3 8B" }, + "huggingface/Qwen/Qwen3-8B:cheapest": { alias: "Qwen3 8B (cheapest)" }, + "huggingface/Qwen/Qwen3-8B:fastest": { alias: "Qwen3 8B (fastest)" }, + }, + }, }, - }, - }, -} -``` + } + ``` + -**Qwen як типова, з варіантами `:cheapest` і `:fastest`:** - -```json5 -{ - agents: { - defaults: { - model: { primary: "huggingface/Qwen/Qwen3-8B" }, - models: { - "huggingface/Qwen/Qwen3-8B": { alias: "Qwen3 8B" }, - "huggingface/Qwen/Qwen3-8B:cheapest": { alias: "Qwen3 8B (cheapest)" }, - "huggingface/Qwen/Qwen3-8B:fastest": { alias: "Qwen3 8B (fastest)" }, + + ```json5 + { + agents: { + defaults: { + model: { + primary: "huggingface/deepseek-ai/DeepSeek-V3.2", + fallbacks: [ + "huggingface/meta-llama/Llama-3.3-70B-Instruct", + "huggingface/openai/gpt-oss-120b", + ], + }, + models: { + "huggingface/deepseek-ai/DeepSeek-V3.2": { alias: "DeepSeek V3.2" }, + "huggingface/meta-llama/Llama-3.3-70B-Instruct": { alias: "Llama 3.3 70B" }, + "huggingface/openai/gpt-oss-120b": { alias: "GPT-OSS 120B" }, + }, + }, }, - }, - }, -} -``` + } + ``` + -**DeepSeek + Llama + GPT-OSS з alias:** - -```json5 -{ - agents: { - defaults: { - model: { - primary: "huggingface/deepseek-ai/DeepSeek-V3.2", - fallbacks: [ - "huggingface/meta-llama/Llama-3.3-70B-Instruct", - "huggingface/openai/gpt-oss-120b", - ], + + ```json5 + { + agents: { + defaults: { + model: { primary: "huggingface/Qwen/Qwen2.5-7B-Instruct:cheapest" }, + models: { + "huggingface/Qwen/Qwen2.5-7B-Instruct": { alias: "Qwen2.5 7B" }, + "huggingface/Qwen/Qwen2.5-7B-Instruct:cheapest": { alias: "Qwen2.5 7B (cheap)" }, + "huggingface/deepseek-ai/DeepSeek-R1:fastest": { alias: "DeepSeek R1 (fast)" }, + "huggingface/meta-llama/Llama-3.1-8B-Instruct": { alias: "Llama 3.1 8B" }, + }, + }, }, - models: { - "huggingface/deepseek-ai/DeepSeek-V3.2": { alias: "DeepSeek V3.2" }, - "huggingface/meta-llama/Llama-3.3-70B-Instruct": { alias: "Llama 3.3 70B" }, - "huggingface/openai/gpt-oss-120b": { alias: "GPT-OSS 120B" }, - }, - }, - }, -} -``` + } + ``` + + -**Кілька моделей Qwen і DeepSeek із суфіксами політик:** +## Пов’язане -```json5 -{ - agents: { - defaults: { - model: { primary: "huggingface/Qwen/Qwen2.5-7B-Instruct:cheapest" }, - models: { - "huggingface/Qwen/Qwen2.5-7B-Instruct": { alias: "Qwen2.5 7B" }, - "huggingface/Qwen/Qwen2.5-7B-Instruct:cheapest": { alias: "Qwen2.5 7B (cheap)" }, - "huggingface/deepseek-ai/DeepSeek-R1:fastest": { alias: "DeepSeek R1 (fast)" }, - "huggingface/meta-llama/Llama-3.1-8B-Instruct": { alias: "Llama 3.1 8B" }, - }, - }, - }, -} -``` + + + Огляд усіх провайдерів, посилань на моделі та поведінки резервного перемикання. + + + Як вибирати й налаштовувати моделі. + + + Офіційна документація Hugging Face Inference Providers. + + + Повний довідник із config. + + diff --git a/docs/uk/providers/inferrs.md b/docs/uk/providers/inferrs.md index e67768258..ace359bcd 100644 --- a/docs/uk/providers/inferrs.md +++ b/docs/uk/providers/inferrs.md @@ -1,15 +1,15 @@ --- read_when: - - Ви хочете запускати OpenClaw із локальним сервером inferrs - - Ви обслуговуєте Gemma або іншу модель через inferrs + - Ви хочете запустити OpenClaw через локальний сервер inferrs + - Ви надаєте Gemma або іншу модель через inferrs - Вам потрібні точні прапорці сумісності OpenClaw для inferrs -summary: Запускайте OpenClaw через inferrs (локальний сервер, сумісний з OpenAI) +summary: Запустіть OpenClaw через inferrs (локальний сервер, сумісний з OpenAI) title: inferrs x-i18n: - generated_at: "2026-04-08T14:17:00Z" + generated_at: "2026-04-12T10:12:18Z" model: gpt-5.4 provider: openai - source_hash: 03b9d5a9935c75fd369068bacb7807a5308cd0bd74303b664227fb664c3a2098 + source_hash: 847dcc131fe51dfe163dcd60075dbfaa664662ea2a5c3986ccb08ddd37e8c31f source_path: providers/inferrs.md workflow: 15 --- @@ -17,33 +17,33 @@ x-i18n: # inferrs [inferrs](https://github.com/ericcurtin/inferrs) може обслуговувати локальні моделі через -API `/v1`, сумісний з OpenAI. OpenClaw працює з `inferrs` через загальний -шлях `openai-completions`. +OpenAI-сумісний API `/v1`. OpenClaw працює з `inferrs` через загальний шлях +`openai-completions`. -Наразі `inferrs` найкраще розглядати як спеціальний самостійно розгорнутий -бекенд, сумісний з OpenAI, а не як окремий plugin постачальника OpenClaw. +Наразі `inferrs` найкраще розглядати як користувацький саморозміщений +OpenAI-сумісний бекенд, а не як окремий Plugin провайдера OpenClaw. -## Швидкий старт +## Початок роботи -1. Запустіть `inferrs` із моделлю. - -Приклад: - -```bash -inferrs serve google/gemma-4-E2B-it \ - --host 127.0.0.1 \ - --port 8080 \ - --device metal -``` - -2. Переконайтеся, що сервер доступний. - -```bash -curl http://127.0.0.1:8080/health -curl http://127.0.0.1:8080/v1/models -``` - -3. Додайте явний запис постачальника OpenClaw і вкажіть на нього свою типову модель. + + + ```bash + inferrs serve google/gemma-4-E2B-it \ + --host 127.0.0.1 \ + --port 8080 \ + --device metal + ``` + + + ```bash + curl http://127.0.0.1:8080/health + curl http://127.0.0.1:8080/v1/models + ``` + + + Додайте явний запис провайдера та вкажіть на нього вашу модель за замовчуванням. Дивіться повний приклад конфігурації нижче. + + ## Повний приклад конфігурації @@ -88,92 +88,127 @@ curl http://127.0.0.1:8080/v1/models } ``` -## Чому `requiresStringContent` має значення +## Додатково -Деякі маршрути Chat Completions в `inferrs` приймають лише рядковий -`messages[].content`, а не структуровані масиви частин вмісту. + + + Деякі маршрути Chat Completions в `inferrs` приймають лише рядковий + `messages[].content`, а не структуровані масиви частин вмісту. -Якщо запуски OpenClaw завершуються помилкою на кшталт: + + Якщо запуски OpenClaw завершуються помилкою на кшталт: -```text -messages[1].content: invalid type: sequence, expected a string -``` + ```text + messages[1].content: invalid type: sequence, expected a string + ``` -установіть: + встановіть `compat.requiresStringContent: true` у записі моделі. + -```json5 -compat: { - requiresStringContent: true -} -``` + ```json5 + compat: { + requiresStringContent: true + } + ``` -OpenClaw перетворить частини вмісту, що містять лише текст, на звичайні рядки перед надсиланням -запиту. + OpenClaw згорне частини вмісту, що складаються лише з тексту, у звичайні рядки перед надсиланням запиту. -## Gemma і застереження щодо схеми інструментів + -Деякі поточні комбінації `inferrs` + Gemma приймають невеликі прямі -запити до `/v1/chat/completions`, але все одно не працюють на повних ходах -середовища агента OpenClaw. + + Деякі поточні комбінації `inferrs` + Gemma приймають невеликі прямі + запити до `/v1/chat/completions`, але все одно завершуються помилкою на повних + ходах runtime агента OpenClaw. -Якщо це трапляється, спочатку спробуйте таке: + Якщо таке трапляється, спершу спробуйте це: -```json5 -compat: { - requiresStringContent: true, - supportsTools: false -} -``` + ```json5 + compat: { + requiresStringContent: true, + supportsTools: false + } + ``` -Це вимикає поверхню схеми інструментів OpenClaw для моделі та може зменшити навантаження від prompt -на суворіші локальні бекенди. + Це вимикає поверхню схеми інструментів OpenClaw для моделі й може зменшити навантаження на підказку для суворіших локальних бекендів. -Якщо маленькі прямі запити все ще працюють, але звичайні ходи агента OpenClaw -продовжують аварійно завершуватися всередині `inferrs`, то решта проблеми зазвичай пов’язана -з поведінкою моделі/сервера на боці upstream, а не з транспортним шаром OpenClaw. + Якщо малі прямі запити й далі працюють, але звичайні ходи агента OpenClaw все ще + аварійно завершуються всередині `inferrs`, то решта проблеми зазвичай пов’язана з + поведінкою моделі/сервера вище за течією, а не з транспортним шаром OpenClaw. -## Ручний smoke-тест + -Після налаштування перевірте обидва шари: + + Після налаштування перевірте обидва шари: -```bash -curl http://127.0.0.1:8080/v1/chat/completions \ - -H 'content-type: application/json' \ - -d '{"model":"google/gemma-4-E2B-it","messages":[{"role":"user","content":"What is 2 + 2?"}],"stream":false}' + ```bash + curl http://127.0.0.1:8080/v1/chat/completions \ + -H 'content-type: application/json' \ + -d '{"model":"google/gemma-4-E2B-it","messages":[{"role":"user","content":"What is 2 + 2?"}],"stream":false}' + ``` -openclaw infer model run \ - --model inferrs/google/gemma-4-E2B-it \ - --prompt "What is 2 + 2? Reply with one short sentence." \ - --json -``` + ```bash + openclaw infer model run \ + --model inferrs/google/gemma-4-E2B-it \ + --prompt "What is 2 + 2? Reply with one short sentence." \ + --json + ``` -Якщо перша команда працює, а друга — ні, скористайтеся наведеними нижче -примітками з усунення несправностей. + Якщо перша команда працює, а друга — ні, перегляньте розділ усунення несправностей нижче. + + + + + `inferrs` розглядається як OpenAI-сумісний бекенд `/v1` у стилі проксі, а не як + нативна кінцева точка OpenAI. + + - Формування запитів, притаманне лише нативному OpenAI, тут не застосовується + - Немає `service_tier`, немає Responses `store`, немає підказок кешу промптів і немає формування payload сумісності reasoning для OpenAI + - Приховані заголовки атрибуції OpenClaw (`originator`, `version`, `User-Agent`) + не додаються для користувацьких базових URL `inferrs` + + + ## Усунення несправностей -- `curl /v1/models` не працює: `inferrs` не запущено, він недоступний або не - прив’язаний до очікуваного хоста/порту. -- `messages[].content ... expected a string`: установіть - `compat.requiresStringContent: true`. -- Прямі маленькі виклики `/v1/chat/completions` проходять, але `openclaw infer model run` - не працює: спробуйте `compat.supportsTools: false`. -- OpenClaw більше не отримує помилок схеми, але `inferrs` усе ще аварійно завершується на більших - ходах агента: вважайте це обмеженням `inferrs` або моделі на боці upstream і зменште навантаження prompt або змініть локальний бекенд/модель. + + + `inferrs` не запущено, він недоступний або не прив’язаний до очікуваного + хоста/порту. Переконайтеся, що сервер запущений і слухає на адресі, яку ви + налаштували. + -## Поведінка в стилі проксі + + Установіть `compat.requiresStringContent: true` у записі моделі. Дивіться + розділ `requiresStringContent` вище для подробиць. + -`inferrs` розглядається як бекенд `/v1`, сумісний з OpenAI, у стилі проксі, а не як -рідна кінцева точка OpenAI. + + Спробуйте встановити `compat.supportsTools: false`, щоб вимкнути поверхню схеми інструментів. + Дивіться застереження щодо схеми інструментів для Gemma вище. + -- тут не застосовується формування запитів лише для рідного OpenAI -- немає `service_tier`, немає `store` для Responses, немає підказок кешу prompt і немає - формування payload сумісності міркувань OpenAI -- приховані заголовки атрибуції OpenClaw (`originator`, `version`, `User-Agent`) - не додаються для спеціальних базових URL `inferrs` + + Якщо OpenClaw більше не отримує помилок схеми, але `inferrs` усе ще аварійно завершується на більших + ходах агента, вважайте це обмеженням `inferrs` або моделі вище за течією. Зменште + навантаження на промпт або перейдіть на інший локальний бекенд чи модель. + + -## Див. також + +Для загальної довідки дивіться [Усунення несправностей](/uk/help/troubleshooting) і [FAQ](/uk/help/faq). + -- [Локальні моделі](/uk/gateway/local-models) -- [Усунення несправностей Gateway](/uk/gateway/troubleshooting#local-openai-compatible-backend-passes-direct-probes-but-agent-runs-fail) -- [Постачальники моделей](/uk/concepts/model-providers) +## Дивіться також + + + + Запуск OpenClaw із локальними серверами моделей. + + + Налагодження локальних OpenAI-сумісних бекендів, які проходять прямі перевірки, але не проходять запуски агента. + + + Огляд усіх провайдерів, посилань на моделі та поведінки перемикання при відмові. + + diff --git a/docs/uk/providers/moonshot.md b/docs/uk/providers/moonshot.md index 63195ee32..2aee77c06 100644 --- a/docs/uk/providers/moonshot.md +++ b/docs/uk/providers/moonshot.md @@ -1,156 +1,233 @@ --- read_when: - - Ви хочете налаштувати Moonshot K2 (Moonshot Open Platform) або Kimi Coding - - Вам потрібно зрозуміти окремі кінцеві точки, ключі та посилання на моделі - - Ви хочете готову конфігурацію для копіювання для будь-якого з провайдерів -summary: Налаштування Moonshot K2 vs Kimi Coding (окремі провайдери + ключі) + - Ви хочете налаштування Moonshot K2 (Moonshot Open Platform) та Kimi Coding окремо. + - Вам потрібно зрозуміти окремі ендпойнти, ключі та посилання на моделі. + - Вам потрібна конфігурація для копіювання/вставлення для будь-якого з провайдерів. +summary: Налаштуйте Moonshot K2 та Kimi Coding (окремі провайдери + ключі) title: Moonshot AI x-i18n: - generated_at: "2026-04-05T18:14:34Z" + generated_at: "2026-04-12T10:12:17Z" model: gpt-5.4 provider: openai - source_hash: a80c71ef432b778e296bd60b7d9ec7c72d025d13fd9bdae474b3d58436d15695 + source_hash: 3f261f83a9b37e4fffb0cd0803e0c64f27eae8bae91b91d8a781a030663076f8 source_path: providers/moonshot.md workflow: 15 --- # Moonshot AI (Kimi) -Moonshot надає API Kimi з OpenAI-compatible кінцевими точками. Налаштуйте -провайдера й установіть типову модель `moonshot/kimi-k2.5`, або використовуйте +Moonshot надає API Kimi із сумісними з OpenAI ендпойнтами. Налаштуйте +провайдера та встановіть модель за замовчуванням `moonshot/kimi-k2.5`, або використовуйте Kimi Coding з `kimi/kimi-code`. -Поточні ідентифікатори моделей Kimi K2: + +Moonshot і Kimi Coding — **окремі провайдери**. Ключі не є взаємозамінними, ендпойнти відрізняються, і посилання на моделі також відрізняються (`moonshot/...` vs `kimi/...`). + + +## Вбудований каталог моделей [//]: # "moonshot-kimi-k2-ids:start" -- `kimi-k2.5` -- `kimi-k2-thinking` -- `kimi-k2-thinking-turbo` -- `kimi-k2-turbo` +| Model ref | Назва | Міркування | Вхід | Контекст | Макс. вивід | +| --------------------------------- | ---------------------- | ---------- | ----------- | -------- | ----------- | +| `moonshot/kimi-k2.5` | Kimi K2.5 | Ні | text, image | 262,144 | 262,144 | +| `moonshot/kimi-k2-thinking` | Kimi K2 Thinking | Так | text | 262,144 | 262,144 | +| `moonshot/kimi-k2-thinking-turbo` | Kimi K2 Thinking Turbo | Так | text | 262,144 | 262,144 | +| `moonshot/kimi-k2-turbo` | Kimi K2 Turbo | Ні | text | 256,000 | 16,384 | [//]: # "moonshot-kimi-k2-ids:end" -```bash -openclaw onboard --auth-choice moonshot-api-key -# or -openclaw onboard --auth-choice moonshot-api-key-cn -``` +## Початок роботи -Kimi Coding: +Оберіть свого провайдера та виконайте кроки налаштування. -```bash -openclaw onboard --auth-choice kimi-code-api-key -``` + + + **Найкраще для:** моделей Kimi K2 через Moonshot Open Platform. -Примітка: Moonshot і Kimi Coding — це окремі провайдери. Ключі не є взаємозамінними, кінцеві точки відрізняються, як і посилання на моделі (Moonshot використовує `moonshot/...`, Kimi Coding використовує `kimi/...`). + + + | Вибір автентифікації | Endpoint | Регіон | + | ----------------------- | ------------------------------ | ------------- | + | `moonshot-api-key` | `https://api.moonshot.ai/v1` | Міжнародний | + | `moonshot-api-key-cn` | `https://api.moonshot.cn/v1` | Китай | + + + ```bash + openclaw onboard --auth-choice moonshot-api-key + ``` -Вебпошук Kimi також використовує плагін Moonshot: + Або для китайського ендпойнта: -```bash -openclaw configure --section web -``` + ```bash + openclaw onboard --auth-choice moonshot-api-key-cn + ``` + + + ```json5 + { + agents: { + defaults: { + model: { primary: "moonshot/kimi-k2.5" }, + }, + }, + } + ``` + + + ```bash + openclaw models list --provider moonshot + ``` + + -Виберіть **Kimi** у розділі вебпошуку, щоб зберегти -`plugins.entries.moonshot.config.webSearch.*`. + ### Приклад конфігурації -## Фрагмент конфігурації (Moonshot API) - -```json5 -{ - env: { MOONSHOT_API_KEY: "sk-..." }, - agents: { - defaults: { - model: { primary: "moonshot/kimi-k2.5" }, + ```json5 + { + env: { MOONSHOT_API_KEY: "sk-..." }, + agents: { + defaults: { + model: { primary: "moonshot/kimi-k2.5" }, + models: { + // moonshot-kimi-k2-aliases:start + "moonshot/kimi-k2.5": { alias: "Kimi K2.5" }, + "moonshot/kimi-k2-thinking": { alias: "Kimi K2 Thinking" }, + "moonshot/kimi-k2-thinking-turbo": { alias: "Kimi K2 Thinking Turbo" }, + "moonshot/kimi-k2-turbo": { alias: "Kimi K2 Turbo" }, + // moonshot-kimi-k2-aliases:end + }, + }, + }, models: { - // moonshot-kimi-k2-aliases:start - "moonshot/kimi-k2.5": { alias: "Kimi K2.5" }, - "moonshot/kimi-k2-thinking": { alias: "Kimi K2 Thinking" }, - "moonshot/kimi-k2-thinking-turbo": { alias: "Kimi K2 Thinking Turbo" }, - "moonshot/kimi-k2-turbo": { alias: "Kimi K2 Turbo" }, - // moonshot-kimi-k2-aliases:end + mode: "merge", + providers: { + moonshot: { + baseUrl: "https://api.moonshot.ai/v1", + apiKey: "${MOONSHOT_API_KEY}", + api: "openai-completions", + models: [ + // moonshot-kimi-k2-models:start + { + id: "kimi-k2.5", + name: "Kimi K2.5", + reasoning: false, + input: ["text", "image"], + cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, + contextWindow: 262144, + maxTokens: 262144, + }, + { + id: "kimi-k2-thinking", + name: "Kimi K2 Thinking", + reasoning: true, + input: ["text"], + cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, + contextWindow: 262144, + maxTokens: 262144, + }, + { + id: "kimi-k2-thinking-turbo", + name: "Kimi K2 Thinking Turbo", + reasoning: true, + input: ["text"], + cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, + contextWindow: 262144, + maxTokens: 262144, + }, + { + id: "kimi-k2-turbo", + name: "Kimi K2 Turbo", + reasoning: false, + input: ["text"], + cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, + contextWindow: 256000, + maxTokens: 16384, + }, + // moonshot-kimi-k2-models:end + ], + }, + }, }, - }, - }, - models: { - mode: "merge", - providers: { - moonshot: { - baseUrl: "https://api.moonshot.ai/v1", - apiKey: "${MOONSHOT_API_KEY}", - api: "openai-completions", - models: [ - // moonshot-kimi-k2-models:start - { - id: "kimi-k2.5", - name: "Kimi K2.5", - reasoning: false, - input: ["text", "image"], - cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, - contextWindow: 262144, - maxTokens: 262144, - }, - { - id: "kimi-k2-thinking", - name: "Kimi K2 Thinking", - reasoning: true, - input: ["text"], - cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, - contextWindow: 262144, - maxTokens: 262144, - }, - { - id: "kimi-k2-thinking-turbo", - name: "Kimi K2 Thinking Turbo", - reasoning: true, - input: ["text"], - cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, - contextWindow: 262144, - maxTokens: 262144, - }, - { - id: "kimi-k2-turbo", - name: "Kimi K2 Turbo", - reasoning: false, - input: ["text"], - cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, - contextWindow: 256000, - maxTokens: 16384, - }, - // moonshot-kimi-k2-models:end - ], - }, - }, - }, -} -``` + } + ``` -## Kimi Coding + -```json5 -{ - env: { KIMI_API_KEY: "sk-..." }, - agents: { - defaults: { - model: { primary: "kimi/kimi-code" }, - models: { - "kimi/kimi-code": { alias: "Kimi" }, + + **Найкраще для:** завдань, орієнтованих на код, через ендпойнт Kimi Coding. + + + Kimi Coding використовує інший API-ключ і префікс провайдера (`kimi/...`), ніж Moonshot (`moonshot/...`). Застаріле посилання на модель `kimi/k2p5` усе ще підтримується як ідентифікатор сумісності. + + + + + ```bash + openclaw onboard --auth-choice kimi-code-api-key + ``` + + + ```json5 + { + agents: { + defaults: { + model: { primary: "kimi/kimi-code" }, + }, + }, + } + ``` + + + ```bash + openclaw models list --provider kimi + ``` + + + + ### Приклад конфігурації + + ```json5 + { + env: { KIMI_API_KEY: "sk-..." }, + agents: { + defaults: { + model: { primary: "kimi/kimi-code" }, + models: { + "kimi/kimi-code": { alias: "Kimi" }, + }, + }, }, - }, - }, -} -``` + } + ``` + + + ## Вебпошук Kimi OpenClaw також постачається з **Kimi** як провайдером `web_search`, що працює на основі вебпошуку Moonshot. -Під час інтерактивного налаштування можуть запитуватися: + + + ```bash + openclaw configure --section web + ``` -- регіон API Moonshot: - - `https://api.moonshot.ai/v1` - - `https://api.moonshot.cn/v1` -- типова модель вебпошуку Kimi (типово `kimi-k2.5`) + Виберіть **Kimi** в розділі вебпошуку, щоб зберегти + `plugins.entries.moonshot.config.webSearch.*`. + + + + Інтерактивне налаштування запропонує: + + | Налаштування | Варіанти | + | ------------------- | -------------------------------------------------------------------- | + | API region | `https://api.moonshot.ai/v1` (міжнародний) або `https://api.moonshot.cn/v1` (Китай) | + | Web search model | За замовчуванням `kimi-k2.5` | + + + Конфігурація зберігається в `plugins.entries.moonshot.config.webSearch`: @@ -161,7 +238,7 @@ OpenClaw також постачається з **Kimi** як провайдер moonshot: { config: { webSearch: { - apiKey: "sk-...", // or use KIMI_API_KEY / MOONSHOT_API_KEY + apiKey: "sk-...", // або використовуйте KIMI_API_KEY / MOONSHOT_API_KEY baseUrl: "https://api.moonshot.ai/v1", model: "kimi-k2.5", }, @@ -179,52 +256,79 @@ OpenClaw також постачається з **Kimi** як провайдер } ``` -## Примітки +## Додатково -- Посилання на моделі Moonshot використовують `moonshot/`. Посилання на моделі Kimi Coding використовують `kimi/`. -- Поточне типове посилання на модель Kimi Coding — `kimi/kimi-code`. Застарілий `kimi/k2p5` і далі приймається як сумісний ідентифікатор моделі. -- Вебпошук Kimi використовує `KIMI_API_KEY` або `MOONSHOT_API_KEY` і типово працює з `https://api.moonshot.ai/v1` та моделлю `kimi-k2.5`. -- Нативні кінцеві точки Moonshot (`https://api.moonshot.ai/v1` і - `https://api.moonshot.cn/v1`) оголошують сумісність із streaming usage на - спільному транспорті `openai-completions`. OpenClaw тепер прив’язує це до можливостей кінцевої точки, - тому сумісні власні ідентифікатори провайдерів, націлені на ті самі нативні - хости Moonshot, успадковують ту саму поведінку streaming-usage. -- За потреби перевизначайте ціну та метадані контексту в `models.providers`. -- Якщо Moonshot публікує інші обмеження контексту для моделі, скоригуйте - `contextWindow` відповідно. -- Використовуйте `https://api.moonshot.ai/v1` для міжнародної кінцевої точки, а `https://api.moonshot.cn/v1` — для кінцевої точки Китаю. -- Варіанти onboarding: - - `moonshot-api-key` для `https://api.moonshot.ai/v1` - - `moonshot-api-key-cn` для `https://api.moonshot.cn/v1` + + + Moonshot Kimi підтримує двійковий нативний thinking: -## Нативний режим thinking (Moonshot) + - `thinking: { type: "enabled" }` + - `thinking: { type: "disabled" }` -Moonshot Kimi підтримує бінарний нативний thinking: + Налаштуйте це для кожної моделі через `agents.defaults.models..params`: -- `thinking: { type: "enabled" }` -- `thinking: { type: "disabled" }` - -Налаштовуйте його для кожної моделі через `agents.defaults.models..params`: - -```json5 -{ - agents: { - defaults: { - models: { - "moonshot/kimi-k2.5": { - params: { - thinking: { type: "disabled" }, + ```json5 + { + agents: { + defaults: { + models: { + "moonshot/kimi-k2.5": { + params: { + thinking: { type: "disabled" }, + }, + }, }, }, }, - }, - }, -} -``` + } + ``` -OpenClaw також зіставляє рівні runtime `/think` для Moonshot: + OpenClaw також зіставляє рівні `/think` під час виконання для Moonshot: -- `/think off` -> `thinking.type=disabled` -- будь-який рівень thinking, відмінний від off -> `thinking.type=enabled` + | Рівень `/think` | Поведінка Moonshot | + | -------------------- | -------------------------- | + | `/think off` | `thinking.type=disabled` | + | Будь-який рівень, окрім off | `thinking.type=enabled` | -Коли в Moonshot увімкнено thinking, `tool_choice` має бути `auto` або `none`. OpenClaw нормалізує несумісні значення `tool_choice` до `auto` для сумісності. + + Коли thinking у Moonshot увімкнено, `tool_choice` має бути `auto` або `none`. OpenClaw нормалізує несумісні значення `tool_choice` до `auto` для сумісності. + + + + + + Нативні ендпойнти Moonshot (`https://api.moonshot.ai/v1` і + `https://api.moonshot.cn/v1`) декларують сумісність streaming usage у спільному транспорті `openai-completions`. OpenClaw визначає це за можливостями ендпойнта, тому сумісні користувацькі ідентифікатори провайдерів, націлені на ті самі нативні хости Moonshot, успадковують таку саму поведінку streaming usage. + + + + | Провайдер | Префікс посилання на модель | Endpoint | Змінна середовища для автентифікації | + | ------------ | --------------------------- | ----------------------------- | ------------------------------------ | + | Moonshot | `moonshot/` | `https://api.moonshot.ai/v1` | `MOONSHOT_API_KEY` | + | Moonshot CN | `moonshot/` | `https://api.moonshot.cn/v1` | `MOONSHOT_API_KEY` | + | Kimi Coding | `kimi/` | Ендпойнт Kimi Coding | `KIMI_API_KEY` | + | Вебпошук | N/A | Такий самий, як регіон Moonshot API | `KIMI_API_KEY` або `MOONSHOT_API_KEY` | + + - Вебпошук Kimi використовує `KIMI_API_KEY` або `MOONSHOT_API_KEY` і за замовчуванням працює з `https://api.moonshot.ai/v1` та моделлю `kimi-k2.5`. + - За потреби перевизначте метадані ціноутворення та контексту в `models.providers`. + - Якщо Moonshot публікує інші ліміти контексту для моделі, відповідно скоригуйте `contextWindow`. + + + + +## Пов’язане + + + + Вибір провайдерів, посилань на моделі та поведінки failover. + + + Налаштування провайдерів вебпошуку, зокрема Kimi. + + + Повна схема конфігурації для провайдерів, моделей і plugins. + + + Керування API-ключами Moonshot і документація. + + diff --git a/docs/uk/providers/qwen.md b/docs/uk/providers/qwen.md index 03a33f41e..b1b388718 100644 --- a/docs/uk/providers/qwen.md +++ b/docs/uk/providers/qwen.md @@ -1,14 +1,14 @@ --- read_when: - Ви хочете використовувати Qwen з OpenClaw - - Ви раніше використовували Qwen OAuth -summary: Використовуйте Qwen Cloud через вбудованого провайдера qwen в OpenClaw + - Раніше ви використовували Qwen OAuth +summary: Використовуйте Qwen Cloud через вбудований провайдер qwen в OpenClaw title: Qwen x-i18n: - generated_at: "2026-04-09T00:06:09Z" + generated_at: "2026-04-12T10:12:16Z" model: gpt-5.4 provider: openai - source_hash: 4786df2cb6ec1ab29d191d012c61dcb0e5468bf0f8561fbbb50eed741efad325 + source_hash: bbd8efa131d37a5dc7578aa0318b8bcb6d492b35858fa611f3fbd8416cf6b866 source_path: providers/qwen.md workflow: 15 --- @@ -17,164 +17,176 @@ x-i18n: -**Qwen OAuth було видалено.** Інтеграція OAuth безкоштовного рівня -(`qwen-portal`), яка використовувала кінцеві точки `portal.qwen.ai`, більше недоступна. +**Qwen OAuth було видалено.** Безкоштовна інтеграція OAuth +(`qwen-portal`), яка використовувала ендпоїнти `portal.qwen.ai`, більше недоступна. Див. [Issue #49557](https://github.com/openclaw/openclaw/issues/49557) для -довідки. +додаткового контексту. -## Рекомендовано: Qwen Cloud - -Тепер OpenClaw розглядає Qwen як повноцінного вбудованого провайдера з канонічним id -`qwen`. Вбудований провайдер націлений на кінцеві точки Qwen Cloud / Alibaba DashScope і -Coding Plan та зберігає роботу застарілих id `modelstudio` як -аліаса сумісності. +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 (оплата за використання)**. + +Якщо вам потрібен `qwen3.6-plus`, віддавайте перевагу ендпоїнту **Standard (оплата за використання)**. Підтримка Coding Plan може відставати від публічного каталогу. + -```bash -# Global Coding Plan endpoint -openclaw onboard --auth-choice qwen-api-key +## Початок роботи -# China Coding Plan endpoint -openclaw onboard --auth-choice qwen-api-key-cn +Виберіть тип плану та виконайте кроки налаштування. -# Global Standard (pay-as-you-go) endpoint -openclaw onboard --auth-choice qwen-standard-api-key + + + **Найкраще підходить для:** доступу за підпискою через Qwen Coding Plan. -# China Standard (pay-as-you-go) endpoint -openclaw onboard --auth-choice qwen-standard-api-key-cn -``` + + + Створіть або скопіюйте API-ключ на [home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys). + + + Для ендпоїнта **Global**: -Застарілі id `modelstudio-*` для `auth-choice` і посилання на моделі `modelstudio/...` досі -працюють як аліаси сумісності, але в нових сценаріях налаштування слід віддавати перевагу канонічним -id `qwen-*` для `auth-choice` і посиланням на моделі `qwen/...`. + ```bash + openclaw onboard --auth-choice qwen-api-key + ``` -Після онбордингу встановіть модель за замовчуванням: + Для ендпоїнта **China**: -```json5 -{ - agents: { - defaults: { - model: { primary: "qwen/qwen3.5-plus" }, - }, - }, -} -``` + ```bash + openclaw onboard --auth-choice qwen-api-key-cn + ``` + + + ```json5 + { + agents: { + defaults: { + model: { primary: "qwen/qwen3.5-plus" }, + }, + }, + } + ``` + + + ```bash + openclaw models list --provider qwen + ``` + + -## Типи планів і кінцеві точки + + Застарілі ідентифікатори `modelstudio-*` для auth-choice і посилання на моделі `modelstudio/...` усе ще + працюють як аліаси сумісності, але нові сценарії налаштування мають віддавати перевагу канонічним + ідентифікаторам auth-choice `qwen-*` і посиланням на моделі `qwen/...`. + -| План | Регіон | Auth choice | Endpoint | + + + + **Найкраще підходить для:** доступу з оплатою за використання через ендпоїнт Standard Model Studio, включно з моделями на кшталт `qwen3.6-plus`, які можуть бути недоступні в Coding Plan. + + + + Створіть або скопіюйте API-ключ на [home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys). + + + Для ендпоїнта **Global**: + + ```bash + openclaw onboard --auth-choice qwen-standard-api-key + ``` + + Для ендпоїнта **China**: + + ```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 + ``` + + + + + Застарілі ідентифікатори `modelstudio-*` для auth-choice і посилання на моделі `modelstudio/...` усе ще + працюють як аліаси сумісності, але нові сценарії налаштування мають віддавати перевагу канонічним + ідентифікаторам auth-choice `qwen-*` і посиланням на моделі `qwen/...`. + + + + + +## Типи планів і ендпоїнти + +| План | Регіон | Auth choice | Ендпоїнт | | -------------------------- | ------ | -------------------------- | ------------------------------------------------ | -| Standard (оплата за використання) | Китай | `qwen-standard-api-key-cn` | `dashscope.aliyuncs.com/compatible-mode/v1` | -| Standard (оплата за використання) | Глобально | `qwen-standard-api-key` | `dashscope-intl.aliyuncs.com/compatible-mode/v1` | -| Coding Plan (підписка) | Китай | `qwen-api-key-cn` | `coding.dashscope.aliyuncs.com/v1` | -| Coding Plan (підписка) | Глобально | `qwen-api-key` | `coding-intl.dashscope.aliyuncs.com/v1` | +| Standard (оплата за використання) | China | `qwen-standard-api-key-cn` | `dashscope.aliyuncs.com/compatible-mode/v1` | +| Standard (оплата за використання) | Global | `qwen-standard-api-key` | `dashscope-intl.aliyuncs.com/compatible-mode/v1` | +| Coding Plan (підписка) | China | `qwen-api-key-cn` | `coding.dashscope.aliyuncs.com/v1` | +| Coding Plan (підписка) | Global | `qwen-api-key` | `coding-intl.dashscope.aliyuncs.com/v1` | -Провайдер автоматично вибирає кінцеву точку на основі вашого auth choice. Канонічні +Провайдер автоматично вибирає ендпоїнт на основі вашого auth choice. Канонічні варіанти використовують сімейство `qwen-*`; `modelstudio-*` залишається лише для сумісності. Ви можете перевизначити це за допомогою власного `baseUrl` у конфігурації. -Власні кінцеві точки Model Studio оголошують сумісність використання потокової передачі на -спільному транспорті `openai-completions`. OpenClaw тепер визначає це за можливостями -кінцевої точки, тому сумісні з DashScope власні id провайдерів, що націлені на ті самі -власні хости, успадковують таку саму поведінку потокового використання замість -того, щоб вимагати саме вбудований id провайдера `qwen`. - -## Отримайте свій API-ключ - -- **Керування ключами**: [home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys) -- **Документація**: [docs.qwencloud.com](https://docs.qwencloud.com/developer-guides/getting-started/introduction) + +**Керування ключами:** [home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys) | +**Документація:** [docs.qwencloud.com](https://docs.qwencloud.com/developer-guides/getting-started/introduction) + ## Вбудований каталог -Наразі OpenClaw постачається з таким вбудованим каталогом Qwen. Налаштований каталог -залежить від кінцевої точки: конфігурації Coding Plan не містять моделі, які, як відомо, -працюють лише на кінцевій точці Standard. +Наразі 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 | Увімкнено міркування | -| `qwen/glm-5` | текст | 202,752 | GLM | -| `qwen/glm-4.7` | текст | 202,752 | GLM | -| `qwen/kimi-k2.5` | текст, зображення | 262,144 | Moonshot AI через Alibaba | +| `qwen/qwen3.5-plus` | text, image | 1,000,000 | Модель за замовчуванням | +| `qwen/qwen3.6-plus` | text, image | 1,000,000 | Віддавайте перевагу ендпоїнтам Standard, якщо вам потрібна ця модель | +| `qwen/qwen3-max-2026-01-23` | text | 262,144 | Лінійка Qwen Max | +| `qwen/qwen3-coder-next` | text | 262,144 | Кодування | +| `qwen/qwen3-coder-plus` | text | 1,000,000 | Кодування | +| `qwen/MiniMax-M2.5` | text | 1,000,000 | Увімкнено міркування | +| `qwen/glm-5` | text | 202,752 | GLM | +| `qwen/glm-4.7` | text | 202,752 | GLM | +| `qwen/kimi-k2.5` | text, image | 262,144 | Moonshot AI через Alibaba | -Доступність усе ще може відрізнятися залежно від кінцевої точки та тарифного плану, навіть якщо модель + +Доступність усе ще може відрізнятися залежно від ендпоїнта та тарифного плану, навіть якщо модель присутня у вбудованому каталозі. - -Сумісність використання власної потокової передачі застосовується як до хостів 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` - -## Доступність Qwen 3.6 Plus - -`qwen3.6-plus` доступна на кінцевих точках Model Studio Standard (оплата за використання): - -- Китай: `dashscope.aliyuncs.com/compatible-mode/v1` -- Глобально: `dashscope-intl.aliyuncs.com/compatible-mode/v1` - -Якщо кінцеві точки Coding Plan повертають помилку "unsupported model" для -`qwen3.6-plus`, перейдіть на Standard (оплата за використання) замість пари -кінцева точка/ключ Coding Plan. - -## План можливостей - -Розширення `qwen` позиціонується як домашня база постачальника для всієї поверхні Qwen -Cloud, а не лише для моделей кодування/тексту. - -- Текстові/чат-моделі: уже вбудовано -- Виклик інструментів, структурований вивід, міркування: успадковуються від сумісного з OpenAI транспорту -- Генерація зображень: заплановано на рівні плагіна провайдера -- Розуміння зображень/відео: уже вбудовано на кінцевій точці Standard -- Мовлення/аудіо: заплановано на рівні плагіна провайдера -- Вбудовування пам'яті/переранжування: заплановано через поверхню адаптера вбудовувань -- Генерація відео: уже вбудовано через спільну можливість генерації відео + ## Мультимодальні доповнення -Розширення `qwen` тепер також надає: +Розширення `qwen` також надає мультимодальні можливості на ендпоїнтах **Standard** +DashScope (не на ендпоїнтах Coding Plan): -- Розуміння відео через `qwen-vl-max-latest` -- Генерацію відео Wan через: - - `wan2.6-t2v` (за замовчуванням) - - `wan2.6-i2v` - - `wan2.6-r2v` - - `wan2.6-r2v-flash` - - `wan2.7-r2v` +- **Розуміння відео** через `qwen-vl-max-latest` +- **Генерація відео Wan** через `wan2.6-t2v` (за замовчуванням), `wan2.6-i2v`, `wan2.6-r2v`, `wan2.6-r2v-flash`, `wan2.7-r2v` -Ці мультимодальні поверхні використовують кінцеві точки DashScope **Standard**, а не -кінцеві точки Coding Plan. - -- Базовий URL Global/Intl Standard: `https://dashscope-intl.aliyuncs.com/compatible-mode/v1` -- Базовий URL China Standard: `https://dashscope.aliyuncs.com/compatible-mode/v1` - -Для генерації відео OpenClaw зіставляє налаштований регіон Qwen з відповідним -хостом DashScope AIGC перед надсиланням завдання: - -- Global/Intl: `https://dashscope-intl.aliyuncs.com` -- China: `https://dashscope.aliyuncs.com` - -Це означає, що звичайний `models.providers.qwen.baseUrl`, який вказує на будь-який із -хостів Qwen Coding Plan або Standard, усе одно забезпечує генерацію відео на правильній -регіональній кінцевій точці відео DashScope. - -Для генерації відео явно встановіть модель за замовчуванням: +Щоб використовувати Qwen як провайдера відео за замовчуванням: ```json5 { @@ -186,22 +198,109 @@ Cloud, а не лише для моделей кодування/тексту. } ``` -Поточні обмеження вбудованої генерації відео Qwen: + +Див. [Video Generation](/uk/tools/video-generation) для спільних параметрів інструмента, вибору провайдера та поведінки failover. + -- До **1** вихідного відео на запит -- До **1** вхідного зображення -- До **4** вхідних відео -- Тривалість до **10 секунд** -- Підтримує `size`, `aspectRatio`, `resolution`, `audio` і `watermark` -- Режим еталонного зображення/відео наразі вимагає **віддалених URL `http(s)`**. Локальні - шляхи до файлів відхиляються одразу, оскільки кінцева точка відео DashScope не - приймає завантажені локальні буфери для цих посилань. +## Додатково -Див. [Генерація відео](/uk/tools/video-generation), щоб дізнатися про спільні параметри -інструмента, вибір провайдера та поведінку аварійного перемикання. + + + `qwen3.6-plus` доступна на ендпоїнтах Model Studio Standard (оплата за використання): -## Примітка щодо середовища + - China: `dashscope.aliyuncs.com/compatible-mode/v1` + - Global: `dashscope-intl.aliyuncs.com/compatible-mode/v1` -Якщо Gateway працює як демон (launchd/systemd), переконайтеся, що `QWEN_API_KEY` -доступний цьому процесу (наприклад, у `~/.openclaw/.env` або через -`env.shellEnv`). + Якщо ендпоїнти Coding Plan повертають помилку "unsupported model" для + `qwen3.6-plus`, перейдіть на Standard (оплата за використання) замість пари + ендпоїнт/ключ від Coding Plan. + + + + + Розширення `qwen` позиціонується як домашній вендорський модуль для всієї поверхні Qwen + Cloud, а не лише для моделей кодування/тексту. + + - **Текстові/chat-моделі:** уже вбудовано + - **Виклик інструментів, структурований вивід, thinking:** успадковується від транспорту, сумісного з OpenAI + - **Генерація зображень:** запланована на рівні provider-plugin + - **Розуміння зображень/відео:** уже вбудовано на ендпоїнті Standard + - **Мовлення/аудіо:** заплановано на рівні provider-plugin + - **Ембеддинги пам’яті/reranking:** заплановано через поверхню адаптера ембеддингів + - **Генерація відео:** уже вбудовано через спільну можливість генерації відео + + + + + Для генерації відео OpenClaw зіставляє налаштований регіон Qwen із відповідним + хостом DashScope AIGC перед відправленням завдання: + + - Global/Intl: `https://dashscope-intl.aliyuncs.com` + - China: `https://dashscope.aliyuncs.com` + + Це означає, що звичайний `models.providers.qwen.baseUrl`, який вказує або на + хости Qwen Coding Plan, або Standard, усе одно зберігає генерацію відео на правильному + регіональному відеоендпоїнті 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 хостів 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-адреса Global/Intl Standard: `https://dashscope-intl.aliyuncs.com/compatible-mode/v1` + - Базова URL-адреса China Standard: `https://dashscope.aliyuncs.com/compatible-mode/v1` + + + + + Якщо Gateway працює як демон (launchd/systemd), переконайтеся, що `QWEN_API_KEY` + доступна для цього процесу (наприклад, у `~/.openclaw/.env` або через + `env.shellEnv`). + + + +## Пов’язані матеріали + + + + Вибір провайдерів, посилань на моделі та поведінки failover. + + + Спільні параметри відеоінструмента та вибір провайдера. + + + Застарілий провайдер ModelStudio та примітки щодо міграції. + + + Загальне усунення несправностей і поширені запитання. + +