From 480bd8968125469414f60863422c2f63e9790b49 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Mon, 4 May 2026 22:22:02 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/concepts/models.md | 169 +++++++++++----------- docs/uk/help/faq-models.md | 279 +++++++++++++++++++------------------ 2 files changed, 227 insertions(+), 221 deletions(-) diff --git a/docs/uk/concepts/models.md b/docs/uk/concepts/models.md index e9e3f2c68..0c7a20a42 100644 --- a/docs/uk/concepts/models.md +++ b/docs/uk/concepts/models.md @@ -1,23 +1,23 @@ --- read_when: - Додавання або змінення CLI моделей (models list/set/scan/aliases/fallbacks) - - Зміна поведінки резервного перемикання моделей або UX вибору - - Оновлення перевірок сканування моделей (інструменти/зображення) + - Зміна поведінки резервного вибору моделі або UX вибору + - Оновлення проб сканування моделей (інструменти/зображення) sidebarTitle: Models CLI -summary: 'CLI моделей: список, встановлення, псевдоніми, резервні варіанти, сканування, статус' +summary: 'CLI моделей: list, set, aliases, fallbacks, scan, status' title: CLI моделей x-i18n: - generated_at: "2026-05-02T07:45:18Z" + generated_at: "2026-05-04T22:20:09Z" model: gpt-5.5 provider: openai - source_hash: d362c8cc41801b5e480560c8d34be53e1ada53a23c49af99adb7874e265ddb1f + source_hash: 8a1dcdb046b914d35513974d4b69fec03a415118d11860dd1c5107efc754ed4f source_path: concepts/models.md workflow: 16 --- - - Ротація профілів автентифікації, cooldowns і те, як це взаємодіє з резервними варіантами. + + Ротація профілів автентифікації, періоди охолодження та взаємодія з резервними варіантами. Короткий огляд провайдерів і приклади. @@ -30,7 +30,7 @@ x-i18n: -Посилання на моделі вибирають провайдера й модель. Зазвичай вони не вибирають низькорівневе середовище виконання агента. Наприклад, `openai/gpt-5.5` може працювати через звичайний шлях провайдера OpenAI або через середовище виконання app-server Codex, залежно від `agents.defaults.agentRuntime.id`. У режимі середовища виконання Codex посилання `openai/gpt-*` не означає оплату за API-ключем; автентифікація може надходити з облікового запису Codex або профілю автентифікації `openai-codex`. Див. [Середовища виконання агентів](/uk/concepts/agent-runtimes). +Посилання на моделі вибирають провайдера й модель. Зазвичай вони не вибирають низькорівневе середовище виконання агента. Наприклад, `openai/gpt-5.5` може запускатися через звичайний шлях провайдера OpenAI або через середовище виконання app-server Codex, залежно від `agents.defaults.agentRuntime.id`. У режимі середовища виконання Codex посилання `openai/gpt-*` не означає оплату за API-ключем; автентифікація може надходити з облікового запису Codex або профілю автентифікації `openai-codex`. Див. [Середовища виконання агентів](/uk/concepts/agent-runtimes). ## Як працює вибір моделі @@ -43,40 +43,40 @@ OpenClaw вибирає моделі в такому порядку: `agents.defaults.model.fallbacks` (за порядком). - - Відмовостійке перемикання автентифікації відбувається всередині провайдера перед переходом до наступної моделі. + + Аварійне перемикання автентифікації відбувається всередині провайдера перед переходом до наступної моделі. - - `agents.defaults.models` — це allowlist/каталог моделей, які може використовувати OpenClaw (плюс псевдоніми). + - `agents.defaults.models` — це allowlist/каталог моделей, які OpenClaw може використовувати (плюс псевдоніми). - `agents.defaults.imageModel` використовується **лише тоді, коли** основна модель не може приймати зображення. - - `agents.defaults.pdfModel` використовується інструментом `pdf`. Якщо пропущено, інструмент переходить до `agents.defaults.imageModel`, а потім до розв’язаної моделі сеансу/моделі за замовчуванням. - - `agents.defaults.imageGenerationModel` використовується спільною можливістю генерації зображень. Якщо пропущено, `image_generate` все одно може вивести стандартного провайдера з автентифікацією. Спочатку він пробує поточного стандартного провайдера, потім решту зареєстрованих провайдерів генерації зображень у порядку provider-id. Якщо ви задаєте конкретного провайдера/модель, також налаштуйте автентифікацію/API-ключ цього провайдера. - - `agents.defaults.musicGenerationModel` використовується спільною можливістю генерації музики. Якщо пропущено, `music_generate` все одно може вивести стандартного провайдера з автентифікацією. Спочатку він пробує поточного стандартного провайдера, потім решту зареєстрованих провайдерів генерації музики в порядку provider-id. Якщо ви задаєте конкретного провайдера/модель, також налаштуйте автентифікацію/API-ключ цього провайдера. - - `agents.defaults.videoGenerationModel` використовується спільною можливістю генерації відео. Якщо пропущено, `video_generate` все одно може вивести стандартного провайдера з автентифікацією. Спочатку він пробує поточного стандартного провайдера, потім решту зареєстрованих провайдерів генерації відео в порядку provider-id. Якщо ви задаєте конкретного провайдера/модель, також налаштуйте автентифікацію/API-ключ цього провайдера. - - Стандартні значення для окремого агента можуть перевизначати `agents.defaults.model` через `agents.list[].model` плюс прив’язки (див. [Маршрутизація між кількома агентами](/uk/concepts/multi-agent)). + - `agents.defaults.pdfModel` використовується інструментом `pdf`. Якщо пропущено, інструмент повертається до `agents.defaults.imageModel`, а потім до розв’язаної моделі сеансу/типової моделі. + - `agents.defaults.imageGenerationModel` використовується спільною можливістю генерації зображень. Якщо пропущено, `image_generate` все одно може визначити типовий провайдер із підтриманою автентифікацією. Спершу він пробує поточного типового провайдера, потім решту зареєстрованих провайдерів генерації зображень у порядку provider-id. Якщо ви задаєте конкретного провайдера/модель, також налаштуйте автентифікацію/API-ключ цього провайдера. + - `agents.defaults.musicGenerationModel` використовується спільною можливістю генерації музики. Якщо пропущено, `music_generate` все одно може визначити типовий провайдер із підтриманою автентифікацією. Спершу він пробує поточного типового провайдера, потім решту зареєстрованих провайдерів генерації музики в порядку provider-id. Якщо ви задаєте конкретного провайдера/модель, також налаштуйте автентифікацію/API-ключ цього провайдера. + - `agents.defaults.videoGenerationModel` використовується спільною можливістю генерації відео. Якщо пропущено, `video_generate` все одно може визначити типовий провайдер із підтриманою автентифікацією. Спершу він пробує поточного типового провайдера, потім решту зареєстрованих провайдерів генерації відео в порядку provider-id. Якщо ви задаєте конкретного провайдера/модель, також налаштуйте автентифікацію/API-ключ цього провайдера. + - Типові параметри окремого агента можуть перевизначати `agents.defaults.model` через `agents.list[].model` плюс прив’язки (див. [Маршрутизація кількох агентів](/uk/concepts/multi-agent)). -## Джерело вибору та поведінка резервних варіантів +## Джерело вибору та поведінка резервного переходу -Той самий `provider/model` може означати різні речі залежно від того, звідки він походить: +Те саме `provider/model` може означати різні речі залежно від того, звідки воно взялося: -- Налаштовані стандартні значення (`agents.defaults.model.primary` і основні моделі для конкретних агентів) є звичайною початковою точкою та використовують `agents.defaults.model.fallbacks`. -- Автоматичні резервні вибори — це тимчасовий стан відновлення. Вони зберігаються з `modelOverrideSource: "auto"`, щоб наступні ходи могли й надалі використовувати ланцюг резервних варіантів без першої перевірки відомої несправної основної моделі. -- Вибори сеансу користувача є точними. `/model`, засіб вибору моделі, `session_status(model=...)` і `sessions.patch` зберігають `modelOverrideSource: "user"`; якщо вибраний provider/model недосяжний, OpenClaw помітно завершується помилкою замість переходу до іншої налаштованої моделі. -- Cron `--model` / payload `model` — це основна модель для окремого завдання. Вона все одно використовує налаштовані резервні варіанти, якщо завдання не надає явний payload `fallbacks` (використовуйте `fallbacks: []` для суворого запуску cron). -- Засоби вибору стандартної моделі CLI та allowlist поважають `models.mode: "replace"`, перелічуючи явні `models.providers.*.models` замість завантаження повного вбудованого каталогу. -- Засіб вибору моделі Control UI запитує в Gateway налаштований перегляд моделей: `agents.defaults.models`, якщо він наявний, інакше явні `models.providers.*.models` плюс провайдери з придатною автентифікацією. Повний вбудований каталог зарезервовано для явних переглядів, як-от `models.list` з `view: "all"` або `openclaw models list --all`. +- Налаштовані типові значення (`agents.defaults.model.primary` і основні моделі конкретних агентів) є звичайною відправною точкою та використовують `agents.defaults.model.fallbacks`. +- Автоматичні резервні вибори — це тимчасовий стан відновлення. Вони зберігаються з `modelOverrideSource: "auto"`, щоб наступні ходи могли продовжувати використовувати ланцюг резервних варіантів без попередньої перевірки відомо несправної основної моделі. +- Вибори користувача в сеансі є точними. `/model`, вибирач моделі, `session_status(model=...)` і `sessions.patch` зберігають `modelOverrideSource: "user"`; якщо вибраний провайдер/модель недоступний, OpenClaw явно завершується з помилкою, а не переходить до іншої налаштованої моделі. +- Cron `--model` / корисне навантаження `model` — це основна модель для окремого завдання. Вона все одно використовує налаштовані резервні варіанти, якщо завдання не надає явне корисне навантаження `fallbacks` (використовуйте `fallbacks: []` для строгого запуску cron). +- Вибирачі типової моделі CLI та allowlist поважають `models.mode: "replace"`, показуючи явні `models.providers.*.models` замість завантаження повного вбудованого каталогу. +- Вибирач моделей Control UI запитує в Gateway налаштований вигляд моделей: `agents.defaults.models`, якщо присутній, інакше явні `models.providers.*.models` плюс провайдери з придатною автентифікацією. Повний вбудований каталог зарезервовано для явних переглядових подань, таких як `models.list` із `view: "all"` або `openclaw models list --all`. ## Коротка політика моделей -- Задайте основною найпотужнішу модель останнього покоління, доступну вам. -- Використовуйте резервні варіанти для завдань, чутливих до вартості/затримки, і чатів із нижчими ризиками. -- Для агентів з увімкненими інструментами або ненадійних вхідних даних уникайте старіших/слабших рівнів моделей. +- Задайте основною найпотужнішу модель найновішого покоління, доступну вам. +- Використовуйте резервні варіанти для завдань, чутливих до вартості/затримки, і чатів із нижчим рівнем ризику. +- Для агентів із підтримкою інструментів або недовірених вхідних даних уникайте старіших/слабших рівнів моделей. ## Онбординг (рекомендовано) @@ -86,7 +86,7 @@ OpenClaw вибирає моделі в такому порядку: openclaw onboard ``` -Він може налаштувати модель + автентифікацію для поширених провайдерів, зокрема **підписку OpenAI Code (Codex)** (OAuth) і **Anthropic** (API-ключ або Claude CLI). +Він може налаштувати модель + автентифікацію для поширених провайдерів, зокрема **підписку OpenAI Code (Codex)** (OAuth) та **Anthropic** (API-ключ або Claude CLI). ## Ключі конфігурації (огляд) @@ -96,7 +96,7 @@ openclaw onboard - `agents.defaults.imageGenerationModel.primary` і `agents.defaults.imageGenerationModel.fallbacks` - `agents.defaults.videoGenerationModel.primary` і `agents.defaults.videoGenerationModel.fallbacks` - `agents.defaults.models` (allowlist + псевдоніми + параметри провайдера) -- `models.providers` (користувацькі провайдери, записані в `models.json`) +- `models.providers` (власні провайдери, записані в `models.json`) Посилання на моделі нормалізуються до нижнього регістру. Псевдоніми провайдерів на кшталт `z.ai/*` нормалізуються до `zai/*`. @@ -104,7 +104,7 @@ openclaw onboard Приклади конфігурації провайдерів (зокрема OpenCode) наведено в [OpenCode](/uk/providers/opencode). -### Безпечні зміни allowlist +### Безпечні редагування allowlist Використовуйте додавальні записи, коли оновлюєте `agents.defaults.models` вручну: @@ -114,23 +114,24 @@ openclaw config set agents.defaults.models '{"openai/gpt-5.4":{}}' --strict-json - `openclaw config set` захищає мапи моделей/провайдерів від випадкового перезапису. Просте присвоєння об’єкта до `agents.defaults.models`, `models.providers` або `models.providers..models` відхиляється, якщо воно видалило б наявні записи. Використовуйте `--merge` для додавальних змін; використовуйте `--replace` лише тоді, коли надане значення має стати повним цільовим значенням. + `openclaw config set` захищає мапи моделей/провайдерів від випадкового перезапису. Звичайне присвоєння об’єкта до `agents.defaults.models`, `models.providers` або `models.providers..models` відхиляється, якщо воно видалило б наявні записи. Використовуйте `--merge` для додавальних змін; використовуйте `--replace` лише тоді, коли надане значення має стати повним цільовим значенням. - Інтерактивне налаштування провайдера та `openclaw configure --section model` також об’єднують вибори в межах провайдера з наявним allowlist, тому додавання Codex, Ollama або іншого провайдера не видаляє непов’язані записи моделей. Configure зберігає наявний `agents.defaults.model.primary`, коли автентифікацію провайдера застосовано повторно. Явні команди встановлення стандартних значень, як-от `openclaw models auth login --provider --set-default` і `openclaw models set `, все ще замінюють `agents.defaults.model.primary`. + Інтерактивне налаштування провайдера та `openclaw configure --section model` також зливають вибори в межах провайдера з наявним allowlist, тому додавання Codex, Ollama або іншого провайдера не видаляє непов’язані записи моделей. Configure зберігає наявний `agents.defaults.model.primary`, коли автентифікацію провайдера застосовано повторно. Явні команди встановлення типового значення, як-от `openclaw models auth login --provider --set-default` і `openclaw models set `, усе одно замінюють `agents.defaults.model.primary`. ## "Модель не дозволена" (і чому відповіді зупиняються) -Якщо `agents.defaults.models` задано, він стає **allowlist** для `/model` і для перевизначень сеансу. Коли користувач вибирає модель, якої немає в цьому allowlist, OpenClaw повертає: +Якщо `agents.defaults.models` задано, він стає **allowlist** для `/model` і перевизначень сеансу. Коли користувач вибирає модель, якої немає в цьому allowlist, OpenClaw повертає: ``` -Model "provider/model" is not allowed. Use /model to list available models. +Model "provider/model" is not allowed. Use /models to list providers, or /models to list models. +Add it with: openclaw config set agents.defaults.models '{"provider/model":{}}' --strict-json --merge ``` -Це відбувається **до** створення звичайної відповіді, тому може здаватися, що повідомлення "не відповіло". Виправлення полягає в одному з варіантів: +Це відбувається **до** створення звичайної відповіді, тому може здаватися, що повідомлення "не відповіло". Щоб виправити це, потрібно або: - Додати модель до `agents.defaults.models`, або - Очистити allowlist (видалити `agents.defaults.models`), або @@ -138,7 +139,9 @@ Model "provider/model" is not allowed. Use /model to list available models. -Для локальних/GGUF-моделей зберігайте в allowlist повне посилання з префіксом провайдера, +Коли відхилена команда містила перевизначення середовища виконання, як-от `/model openai/gpt-5.5 --runtime codex`, спершу виправте allowlist, а потім повторіть ту саму команду `/model ... --runtime ...`. Для нативного виконання Codex вибрана модель усе ще `openai/gpt-5.5`; середовище виконання `codex` вибирає harness і окремо використовує автентифікацію Codex. + +Для локальних/GGUF-моделей зберігайте повне посилання з префіксом провайдера в allowlist, наприклад `ollama/gemma4:26b`, `lmstudio/Gemma4-26b-a4-it-gguf` або точний provider/model, показаний `openclaw models list --provider `. Самих локальних імен файлів або відображуваних назв недостатньо, коли allowlist @@ -171,34 +174,34 @@ Model "provider/model" is not allowed. Use /model to list available models. ``` - - - `/model` (і `/model list`) — це компактний нумерований засіб вибору (сімейство моделей + доступні провайдери). - - У Discord `/model` і `/models` відкривають інтерактивний засіб вибору з випадаючими списками провайдера й моделі та кроком Submit. - - У Telegram вибори в засобі `/models` обмежені сеансом; вони не змінюють постійне стандартне значення агента в `openclaw.json`. - - `/models add` застарів і тепер повертає повідомлення про застарілість замість реєстрації моделей із чату. - - `/model <#>` вибирає з цього засобу вибору. + + - `/model` (і `/model list`) — це компактний нумерований вибирач (родина моделей + доступні провайдери). + - У Discord `/model` і `/models` відкривають інтерактивний вибирач із випадаючими списками провайдера й моделі та кроком Submit. + - У Telegram вибори вибирача `/models` мають область дії сеансу; вони не змінюють сталий типовий параметр агента в `openclaw.json`. + - `/models add` застаріла й тепер повертає повідомлення про застарілість замість реєстрації моделей із чату. + - `/model <#>` вибирає з цього вибирача. - + - `/model` негайно зберігає новий вибір сеансу. - Якщо агент простоює, наступний запуск одразу використовує нову модель. - - Якщо запуск уже активний, OpenClaw позначає перемикання наживо як очікуване й перезапускається в новій моделі лише в чистій точці повторної спроби. - - Якщо активність інструментів або виведення відповіді вже почалися, очікуване перемикання може залишатися в черзі до пізнішої можливості повторної спроби або наступного ходу користувача. - - Вибране користувачем посилання `/model` є суворим для цього сеансу: якщо вибраний provider/model недосяжний, відповідь помітно завершується помилкою замість непомітної відповіді з `agents.defaults.model.fallbacks`. Це відрізняється від налаштованих стандартних значень і основних моделей завдань cron, які все ще можуть використовувати ланцюги резервних варіантів. - - `/model status` — це детальний перегляд (кандидати автентифікації та, коли налаштовано, endpoint провайдера `baseUrl` + режим `api`). + - Якщо запуск уже активний, OpenClaw позначає живе перемикання як очікуване й перезапускається з новою моделлю лише в чистій точці повтору. + - Якщо активність інструментів або виведення відповіді вже почалися, очікуване перемикання може залишатися в черзі до пізнішої можливості повтору або наступного ходу користувача. + - Вибране користувачем посилання `/model` є строгим для цього сеансу: якщо вибраний провайдер/модель недоступний, відповідь явно завершується з помилкою, а не мовчки відповідає з `agents.defaults.model.fallbacks`. Це відрізняється від налаштованих типових значень і основних моделей завдань cron, які все одно можуть використовувати ланцюги резервних варіантів. + - `/model status` — це докладний вигляд (кандидати автентифікації та, якщо налаштовано, endpoint провайдера `baseUrl` + режим `api`). - Посилання на моделі розбираються поділом за **першим** `/`. Використовуйте `provider/model`, коли вводите `/model `. - - Якщо сам ID моделі містить `/` (у стилі OpenRouter), потрібно додати префікс провайдера (приклад: `/model openrouter/moonshotai/kimi-k2`). + - Якщо сам ID моделі містить `/` (у стилі OpenRouter), потрібно вказати префікс провайдера (приклад: `/model openrouter/moonshotai/kimi-k2`). - Якщо ви пропустите провайдера, OpenClaw розв’язує введення в такому порядку: 1. збіг псевдоніма - 2. унікальний збіг налаштованого провайдера для цього точного ID моделі без префікса - 3. застарілий резервний перехід до налаштованого стандартного провайдера — якщо цей провайдер більше не надає налаштовану стандартну модель, OpenClaw натомість переходить до першого налаштованого provider/model, щоб уникнути показу застарілого стандартного значення видаленого провайдера. + 2. унікальний збіг налаштованого провайдера для цього точного id моделі без префікса + 3. застарілий резервний перехід до налаштованого типового провайдера — якщо цей провайдер більше не надає налаштовану типову модель, OpenClaw натомість повертається до першого налаштованого провайдера/моделі, щоб не показувати застаріле типове значення видаленого провайдера. -Повна поведінка команд/конфігурація: [Слеш-команди](/uk/tools/slash-commands). +Повна поведінка команд/конфігурація: [Slash-команди](/uk/tools/slash-commands). ## Команди CLI @@ -227,16 +230,16 @@ openclaw models image-fallbacks clear ### `models list` -За замовчуванням показує налаштовані/доступні через автентифікацію моделі. Корисні прапорці: +Показує налаштовані/доступні для автентифікації моделі за замовчуванням. Корисні прапорці: - Повний каталог. Містить статичні рядки каталогу вбудованих моделей, що належать провайдерам, ще до налаштування автентифікації, тож подання лише для виявлення можуть показувати моделі, недоступні, доки ви не додасте відповідні облікові дані провайдера. + Повний каталог. Містить вбудовані статичні рядки каталогу, що належать провайдеру, ще до налаштування автентифікації, тож подання лише для виявлення можуть показувати моделі, недоступні, доки ви не додасте відповідні облікові дані провайдера. Лише локальні провайдери. - Фільтрувати за ідентифікатором провайдера, наприклад `moonshot`. Відображувані назви з інтерактивних засобів вибору не приймаються. + Фільтрувати за id провайдера, наприклад `moonshot`. Відображувані мітки з інтерактивних засобів вибору не приймаються. Одна модель на рядок. @@ -247,21 +250,21 @@ openclaw models image-fallbacks clear ### `models status` -Показує визначену основну модель, резервні моделі, модель зображень і огляд автентифікації налаштованих провайдерів. Також показує стан завершення строку дії OAuth для профілів, знайдених у сховищі автентифікації (за замовчуванням попереджає протягом 24 год). `--plain` друкує лише визначену основну модель. +Показує розв’язану основну модель, резервні варіанти, модель зображень і огляд автентифікації налаштованих провайдерів. Також показує стан завершення терміну дії OAuth для профілів, знайдених у сховищі автентифікації (за замовчуванням попереджає в межах 24 годин). `--plain` друкує лише розв’язану основну модель. - Стан OAuth показується завжди (і включається у вивід `--json`). Якщо налаштований провайдер не має облікових даних, `models status` друкує розділ **Відсутня автентифікація**. - - JSON містить `auth.oauth` (вікно попередження + профілі) і `auth.providers` (ефективна автентифікація для кожного провайдера, зокрема облікові дані зі змінних середовища). `auth.oauth` відображає лише стан профілів у сховищі автентифікації; провайдери лише зі змінними середовища там не з’являються. - - Використовуйте `--check` для автоматизації (код виходу `1`, коли автентифікація відсутня або строк дії минув, `2`, коли строк дії добігає кінця). - - Використовуйте `--probe` для live-перевірок автентифікації; рядки перевірки можуть походити з профілів автентифікації, облікових даних зі змінних середовища або `models.json`. - - Якщо явний `auth.order.` пропускає збережений профіль, перевірка повідомляє `excluded_by_auth_order` замість спроби використати його. Якщо автентифікація існує, але для цього провайдера не вдається визначити модель, яку можна перевірити, перевірка повідомляє `status: no_model`. + - JSON містить `auth.oauth` (вікно попередження + профілі) і `auth.providers` (ефективна автентифікація для кожного провайдера, зокрема облікові дані з env). `auth.oauth` — це лише стан профілів у сховищі автентифікації; провайдери лише з env там не з’являються. + - Використовуйте `--check` для автоматизації (код виходу `1`, коли відсутні/прострочені, `2`, коли скоро завершиться термін дії). + - Використовуйте `--probe` для живих перевірок автентифікації; рядки перевірки можуть надходити з профілів автентифікації, облікових даних env або `models.json`. + - Якщо явний `auth.order.` пропускає збережений профіль, перевірка повідомляє `excluded_by_auth_order` замість спроби використати його. Якщо автентифікація існує, але для цього провайдера не можна розв’язати модель, придатну для перевірки, перевірка повідомляє `status: no_model`. -Вибір автентифікації залежить від провайдера й облікового запису. Для постійно ввімкнених хостів Gateway ключі API зазвичай найпередбачуваніші; також підтримується повторне використання Claude CLI і наявні профілі Anthropic OAuth/токенів. +Вибір автентифікації залежить від провайдера/облікового запису. Для постійно ввімкнених хостів Gateway ключі API зазвичай найпередбачуваніші; також підтримуються повторне використання Claude CLI та наявні профілі Anthropic OAuth/токенів. Приклад (Claude CLI): @@ -271,15 +274,15 @@ claude auth login openclaw models status ``` -## Сканування (безплатні моделі OpenRouter) +## Сканування (безкоштовні моделі OpenRouter) -`openclaw models scan` перевіряє **каталог безплатних моделей** OpenRouter і може додатково перевіряти моделі на підтримку інструментів і зображень. +`openclaw models scan` перевіряє **каталог безкоштовних моделей** OpenRouter і може додатково перевіряти моделі на підтримку інструментів і зображень. - Пропустити live-перевірки (лише метадані). + Пропустити живі перевірки (лише метадані). - Мінімальний розмір параметрів (мільярди). + Мінімальний розмір параметрів (у мільярдах). Пропустити старіші моделі. @@ -288,17 +291,17 @@ openclaw models status Фільтр за префіксом провайдера. - Розмір списку резервних моделей. + Розмір списку резервних варіантів. - Встановити `agents.defaults.model.primary` на перший вибір. + Установити `agents.defaults.model.primary` на перший вибір. - Встановити `agents.defaults.imageModel.primary` на перший вибір зображень. + Установити `agents.defaults.imageModel.primary` на перший вибір зображення. -Каталог OpenRouter `/models` є публічним, тому сканування лише метаданих може перелічувати безплатні кандидатні моделі без ключа. Перевірка й інференс усе ще потребують ключа API OpenRouter (з профілів автентифікації або `OPENROUTER_API_KEY`). Якщо ключ недоступний, `openclaw models scan` повертається до виводу лише метаданих і залишає конфігурацію без змін. Використовуйте `--no-probe`, щоб явно запитати режим лише метаданих. +Каталог OpenRouter `/models` є публічним, тому сканування лише метаданих може перелічити безкоштовних кандидатів без ключа. Перевірка та інференс усе одно потребують ключа API OpenRouter (з профілів автентифікації або `OPENROUTER_API_KEY`). Якщо ключ недоступний, `openclaw models scan` повертається до виводу лише метаданих і залишає конфігурацію без змін. Використовуйте `--no-probe`, щоб явно запросити режим лише метаданих. Результати сканування ранжуються за: @@ -311,40 +314,40 @@ openclaw models status Вхідні дані: - Список OpenRouter `/models` (фільтр `:free`) -- Live-перевірки потребують ключа API OpenRouter з профілів автентифікації або `OPENROUTER_API_KEY` (див. [Змінні середовища](/uk/help/environment)) -- Додаткові фільтри: `--max-age-days`, `--min-params`, `--provider`, `--max-candidates` -- Елементи керування запитом/перевіркою: `--timeout`, `--concurrency` +- Живі перевірки потребують ключа API OpenRouter з профілів автентифікації або `OPENROUTER_API_KEY` (див. [Змінні середовища](/uk/help/environment)) +- Необов’язкові фільтри: `--max-age-days`, `--min-params`, `--provider`, `--max-candidates` +- Елементи керування запитами/перевірками: `--timeout`, `--concurrency` -Коли live-перевірки виконуються в TTY, можна інтерактивно вибирати резервні моделі. У неінтерактивному режимі передайте `--yes`, щоб прийняти стандартні значення. Результати лише з метаданими є інформаційними; `--set-default` і `--set-image` потребують live-перевірок, щоб OpenClaw не налаштував непридатну для використання модель OpenRouter без ключа. +Коли живі перевірки виконуються в TTY, ви можете інтерактивно вибрати резервні варіанти. У неінтерактивному режимі передайте `--yes`, щоб прийняти типові значення. Результати лише метаданих мають інформаційний характер; `--set-default` і `--set-image` потребують живих перевірок, щоб OpenClaw не налаштував непридатну для використання модель OpenRouter без ключа. ## Реєстр моделей (`models.json`) -Користувацькі провайдери в `models.providers` записуються в `models.json` у каталозі агента (за замовчуванням `~/.openclaw/agents//agent/models.json`). Цей файл за замовчуванням об’єднується, якщо `models.mode` не встановлено на `replace`. +Користувацькі провайдери в `models.providers` записуються в `models.json` у каталозі агента (за замовчуванням `~/.openclaw/agents//agent/models.json`). Цей файл об’єднується за замовчуванням, якщо `models.mode` не встановлено на `replace`. - Пріоритет режиму об’єднання для відповідних ідентифікаторів провайдерів: + Пріоритет режиму об’єднання для відповідних ID провайдерів: - - Непорожній `baseUrl`, уже наявний у `models.json` агента, має перевагу. + - Непорожній `baseUrl`, уже присутній у `models.json` агента, має перевагу. - Непорожній `apiKey` у `models.json` агента має перевагу лише тоді, коли цей провайдер не керується SecretRef у поточному контексті конфігурації/профілю автентифікації. - - Значення `apiKey` провайдера, керованого SecretRef, оновлюються з маркерів джерела (`ENV_VAR_NAME` для env-посилань, `secretref-managed` для file/exec-посилань) замість збереження визначених секретів. + - Значення `apiKey` провайдера, керованого SecretRef, оновлюються з маркерів джерела (`ENV_VAR_NAME` для env-посилань, `secretref-managed` для file/exec-посилань) замість збереження розв’язаних секретів. - Значення заголовків провайдера, керованого SecretRef, оновлюються з маркерів джерела (`secretref-env:ENV_VAR_NAME` для env-посилань, `secretref-managed` для file/exec-посилань). - - Порожні або відсутні `apiKey`/`baseUrl` агента повертаються до `models.providers` з конфігурації. + - Порожні або відсутні `apiKey`/`baseUrl` агента повертаються до `models.providers` конфігурації. - Інші поля провайдера оновлюються з конфігурації та нормалізованих даних каталогу. -Збереження маркерів авторитетно спирається на джерело: OpenClaw записує маркери з активного знімка вихідної конфігурації (до визначення), а не з визначених значень runtime-секретів. Це застосовується щоразу, коли OpenClaw повторно генерує `models.json`, зокрема для шляхів, керованих командами, як-от `openclaw agent`. +Збереження маркерів є авторитетним щодо джерела: OpenClaw записує маркери з активного знімка конфігурації джерела (до розв’язання), а не з розв’язаних значень секретів часу виконання. Це застосовується щоразу, коли OpenClaw повторно генерує `models.json`, зокрема в шляхах, керованих командами, як-от `openclaw agent`. ## Пов’язане -- [Runtime-середовища агентів](/uk/concepts/agent-runtimes) — PI, Codex та інші runtime-середовища агентного циклу -- [Довідник конфігурації](/uk/gateway/config-agents#agent-defaults) — ключі конфігурації моделей +- [Середовища виконання агентів](/uk/concepts/agent-runtimes) — PI, Codex та інші середовища виконання циклу агента +- [Довідник конфігурації](/uk/gateway/config-agents#agent-defaults) — ключі конфігурації моделі - [Генерація зображень](/uk/tools/image-generation) — конфігурація моделі зображень -- [Відмовостійке перемикання моделей](/uk/concepts/model-failover) — ланцюжки резервних моделей +- [Відмовостійке перемикання моделей](/uk/concepts/model-failover) — ланцюжки резервних варіантів - [Провайдери моделей](/uk/concepts/model-providers) — маршрутизація провайдерів і автентифікація -- [Генерація музики](/uk/tools/music-generation) — конфігурація моделі музики -- [Генерація відео](/uk/tools/video-generation) — конфігурація моделі відео +- [Генерація музики](/uk/tools/music-generation) — конфігурація музичної моделі +- [Генерація відео](/uk/tools/video-generation) — конфігурація відеомоделі diff --git a/docs/uk/help/faq-models.md b/docs/uk/help/faq-models.md index 5c1260419..d7fb46986 100644 --- a/docs/uk/help/faq-models.md +++ b/docs/uk/help/faq-models.md @@ -1,77 +1,77 @@ --- read_when: - Вибір або перемикання моделей, налаштування псевдонімів - - Налагодження аварійного перемикання моделей / "Усі моделі не спрацювали" - - Що таке профілі автентифікації та як ними керувати + - Налагодження резервного перемикання моделей / «Не спрацювала жодна модель» + - Розуміння профілів автентифікації та керування ними sidebarTitle: Models FAQ -summary: 'Поширені запитання: типові налаштування моделей, вибір, псевдоніми, перемикання, резервне перемикання та профілі автентифікації' +summary: 'Поширені запитання: типові налаштування моделей, вибір, псевдоніми, перемикання, аварійне перемикання та профілі автентифікації' title: 'Поширені запитання: моделі та автентифікація' x-i18n: - generated_at: "2026-05-02T02:37:18Z" + generated_at: "2026-05-04T22:20:04Z" model: gpt-5.5 provider: openai - source_hash: 1bf7a6bb4a0e2bf791c73dbb4005ba4628afc2c20e06417f8147f4c65583e884 + source_hash: bf06266926cecc06d8799cb17f42d96cdaa09ad83c20e8d4dcc3bcccbd840abc source_path: help/faq-models.md workflow: 16 --- - Запитання й відповіді щодо моделей і профілів автентифікації. Щодо налаштування, сеансів, gateway, каналів і + Питання й відповіді про моделі та профілі автентифікації. Про налаштування, сесії, Gateway, канали й усунення несправностей див. основний [FAQ](/uk/help/faq). - ## Моделі: типові значення, вибір, псевдоніми, перемикання + ## Моделі: стандартні значення, вибір, псевдоніми, перемикання - - Типова модель OpenClaw — це те, що ви встановили як: + + Модель OpenClaw за замовчуванням — це те, що ви встановили як: ``` agents.defaults.model.primary ``` - Моделі задаються як `provider/model` (приклад: `openai/gpt-5.5` або `openai-codex/gpt-5.5`). Якщо ви не вкажете провайдера, OpenClaw спершу спробує псевдонім, потім унікальний збіг налаштованого провайдера для саме цього ідентифікатора моделі, і лише після цього повернеться до налаштованого типового провайдера як застарілого шляху сумісності. Якщо цей провайдер більше не надає налаштовану типову модель, OpenClaw повернеться до першої налаштованої пари провайдер/модель замість показу застарілого типового значення для вилученого провайдера. Все одно варто **явно** задавати `provider/model`. + Моделі вказуються як `provider/model` (приклад: `openai/gpt-5.5` або `openai-codex/gpt-5.5`). Якщо ви пропустите постачальника, OpenClaw спочатку спробує псевдонім, потім унікальний збіг налаштованого постачальника для цього точного ідентифікатора моделі, і лише після цього повернеться до налаштованого постачальника за замовчуванням як застарілого шляху сумісності. Якщо цей постачальник більше не надає налаштовану модель за замовчуванням, OpenClaw повертається до першої налаштованої пари постачальник/модель, замість показу застарілого значення постачальника, який було вилучено. Утім, вам варто **явно** задавати `provider/model`. - **Рекомендовано за замовчуванням:** використовуйте найсильнішу модель останнього покоління, доступну у вашому стеку провайдерів. - **Для агентів з інструментами або недовіреним введенням:** надавайте пріоритет потужності моделі, а не вартості. + **Рекомендоване значення за замовчуванням:** використовуйте найсильнішу модель найновішого покоління, доступну у вашому стеку постачальників. + **Для агентів з інструментами або недовіреним введенням:** надавайте перевагу потужності моделі, а не вартості. **Для звичайного чату з низькими ризиками:** використовуйте дешевші резервні моделі й маршрутизуйте за роллю агента. MiniMax має власну документацію: [MiniMax](/uk/providers/minimax) і - [локальні моделі](/uk/gateway/local-models). + [Локальні моделі](/uk/gateway/local-models). - Практичне правило: використовуйте **найкращу модель, яку можете собі дозволити** для роботи з високими ризиками, і дешевшу - модель для звичайного чату або підсумків. Можна маршрутизувати моделі для кожного агента й використовувати субагентів для - паралельного виконання довгих завдань (кожен субагент споживає токени). Див. [Моделі](/uk/concepts/models) і + Практичне правило: використовуйте **найкращу модель, яку можете собі дозволити** для роботи з високими ризиками, а дешевшу + модель — для звичайного чату або підсумків. Ви можете маршрутизувати моделі для кожного агента й використовувати субагентів для + паралелізації довгих завдань (кожен субагент споживає токени). Див. [Моделі](/uk/concepts/models) і [Субагенти](/uk/tools/subagents). - Суворе попередження: слабші або надмірно квантизовані моделі вразливіші до prompt + Важливе попередження: слабші або надмірно квантовані моделі вразливіші до prompt injection і небезпечної поведінки. Див. [Безпека](/uk/gateway/security). Більше контексту: [Моделі](/uk/concepts/models). - - Використовуйте **команди моделей** або редагуйте лише поля **model**. Уникайте повної заміни конфігурації. + + Використовуйте **команди моделі** або редагуйте лише поля **model**. Уникайте повної заміни конфігурації. Безпечні варіанти: - - `/model` у чаті (швидко, для окремого сеансу) + - `/model` у чаті (швидко, для окремої сесії) - `openclaw models set ...` (оновлює лише конфігурацію моделі) - `openclaw configure --section model` (інтерактивно) - - редагувати `agents.defaults.model` у `~/.openclaw/openclaw.json` + - редагуйте `agents.defaults.model` у `~/.openclaw/openclaw.json` - Уникайте `config.apply` з частковим обʼєктом, якщо не маєте наміру замінити всю конфігурацію. - Для RPC-редагувань спершу перевірте через `config.schema.lookup` і надавайте перевагу `config.patch`. Корисне навантаження lookup дає нормалізований шлях, стислі документи/обмеження схеми й підсумки безпосередніх дочірніх елементів + Уникайте `config.apply` з частковим об'єктом, якщо ви не маєте наміру замінити всю конфігурацію. + Для редагувань через RPC спочатку перегляньте за допомогою `config.schema.lookup` і віддавайте перевагу `config.patch`. Дані lookup надають нормалізований шлях, коротку документацію/обмеження схеми та підсумки безпосередніх дочірніх елементів для часткових оновлень. - Якщо ви перезаписали конфігурацію, відновіть її з резервної копії або повторно запустіть `openclaw doctor` для відновлення. + Якщо ви перезаписали конфігурацію, відновіть її з резервної копії або повторно запустіть `openclaw doctor` для виправлення. Документація: [Моделі](/uk/concepts/models), [Налаштування](/uk/cli/configure), [Конфігурація](/uk/cli/config), [Doctor](/uk/gateway/doctor). - + Так. Ollama — найпростіший шлях для локальних моделей. Найшвидше налаштування: @@ -84,24 +84,24 @@ x-i18n: Нотатки: - - `Cloud + Local` дає хмарні моделі разом із вашими локальними моделями Ollama + - `Cloud + Local` дає вам хмарні моделі разом із вашими локальними моделями Ollama - хмарні моделі на кшталт `kimi-k2.5:cloud` не потребують локального завантаження - для ручного перемикання використовуйте `openclaw models list` і `openclaw models set ollama/` - Примітка щодо безпеки: менші або сильно квантизовані моделі вразливіші до prompt + Примітка щодо безпеки: менші або сильно квантовані моделі вразливіші до prompt injection. Ми наполегливо рекомендуємо **великі моделі** для будь-якого бота, який може використовувати інструменти. - Якщо ви все одно хочете малі моделі, увімкніть sandboxing і суворі списки дозволених інструментів. + Якщо ви все одно хочете малі моделі, увімкніть ізоляцію та суворі allowlist інструментів. Документація: [Ollama](/uk/providers/ollama), [Локальні моделі](/uk/gateway/local-models), - [Провайдери моделей](/uk/concepts/model-providers), [Безпека](/uk/gateway/security), - [Sandboxing](/uk/gateway/sandboxing). + [Постачальники моделей](/uk/concepts/model-providers), [Безпека](/uk/gateway/security), + [Ізоляція](/uk/gateway/sandboxing). - - Ці розгортання можуть відрізнятися й змінюватися з часом; фіксованої рекомендації щодо провайдера немає. + - Ці розгортання можуть відрізнятися й змінюватися з часом; фіксованої рекомендації щодо постачальника немає. - Перевірте поточне runtime-налаштування на кожному gateway за допомогою `openclaw models status`. - - Для агентів, чутливих до безпеки або з інструментами, використовуйте найсильнішу модель останнього покоління з доступних. + - Для агентів із вимогами до безпеки або з інструментами використовуйте найсильнішу модель найновішого покоління з доступних. @@ -118,9 +118,9 @@ x-i18n: /model gemini-flash-lite ``` - Це вбудовані псевдоніми. Власні псевдоніми можна додати через `agents.defaults.models`. + Це вбудовані псевдоніми. Користувацькі псевдоніми можна додати через `agents.defaults.models`. - Доступні моделі можна переглянути за допомогою `/model`, `/model list` або `/model status`. + Ви можете переглянути доступні моделі за допомогою `/model`, `/model list` або `/model status`. `/model` (і `/model list`) показує компактний нумерований вибір. Виберіть за номером: @@ -128,17 +128,17 @@ x-i18n: /model 3 ``` - Також можна примусово задати конкретний профіль автентифікації для провайдера (для окремого сеансу): + Також можна примусово задати конкретний профіль автентифікації для постачальника (для окремої сесії): ``` /model opus@anthropic:default /model opus@anthropic:work ``` - Порада: `/model status` показує, який агент активний, який файл `auth-profiles.json` використовується і який профіль автентифікації буде спробувано далі. - Також показує налаштовану endpoint-адресу провайдера (`baseUrl`) і режим API (`api`), коли вони доступні. + Порада: `/model status` показує, який агент активний, який файл `auth-profiles.json` використовується і який профіль автентифікації буде спробувано наступним. + Він також показує налаштований endpoint постачальника (`baseUrl`) і режим API (`api`), якщо доступно. - **Як відкріпити профіль, який я задав через @profile?** + **Як скасувати закріплення профілю, заданого через @profile?** Повторно запустіть `/model` **без** суфікса `@profile`: @@ -146,28 +146,28 @@ x-i18n: /model anthropic/claude-opus-4-6 ``` - Якщо хочете повернутися до типового значення, виберіть його з `/model` (або надішліть `/model `). + Якщо хочете повернутися до стандартного значення, виберіть його з `/model` (або надішліть `/model `). Використовуйте `/model status`, щоб підтвердити, який профіль автентифікації активний. - - Так. Розглядайте вибір моделі й вибір runtime окремо: + + Так. Розглядайте вибір моделі та вибір runtime окремо: - - **Нативний агент програмування Codex:** установіть `agents.defaults.model.primary` на `openai/gpt-5.5`, а `agents.defaults.agentRuntime.id` на `"codex"`. Увійдіть через `openclaw models auth login --provider openai-codex`, коли хочете автентифікацію підписки ChatGPT/Codex. + - **Нативний агент програмування Codex:** установіть `agents.defaults.model.primary` у `openai/gpt-5.5`, а `agents.defaults.agentRuntime.id` у `"codex"`. Увійдіть через `openclaw models auth login --provider openai-codex`, коли хочете використовувати автентифікацію підписки ChatGPT/Codex. - **Прямі завдання OpenAI API через PI:** використовуйте `/model openai/gpt-5.5` без перевизначення runtime Codex і налаштуйте `OPENAI_API_KEY`. - - **Codex OAuth через PI:** використовуйте `/model openai-codex/gpt-5.5` лише тоді, коли свідомо хочете звичайний PI runner із Codex OAuth. - - **Субагенти:** маршрутизуйте завдання програмування до агента лише для Codex з власною моделлю і типовим `agentRuntime`. + - **Codex OAuth через PI:** використовуйте `/model openai-codex/gpt-5.5` лише тоді, коли навмисно хочете звичайний runner PI з Codex OAuth. + - **Субагенти:** маршрутизуйте завдання програмування до агента лише для Codex із власною моделлю та стандартним `agentRuntime`. - Див. [Моделі](/uk/concepts/models) і [Slash commands](/uk/tools/slash-commands). + Див. [Моделі](/uk/concepts/models) і [Slash-команди](/uk/tools/slash-commands). - - Використовуйте перемикач сеансу або типове значення конфігурації: + + Використовуйте перемикач сесії або стандартне значення в конфігурації: - - **Для окремого сеансу:** надішліть `/fast on`, поки сеанс використовує `openai/gpt-5.5` або `openai-codex/gpt-5.5`. - - **Типове значення для моделі:** установіть `agents.defaults.models["openai/gpt-5.5"].params.fastMode` або `agents.defaults.models["openai-codex/gpt-5.5"].params.fastMode` на `true`. + - **Для окремої сесії:** надішліть `/fast on`, коли сесія використовує `openai/gpt-5.5` або `openai-codex/gpt-5.5`. + - **Стандартне значення для моделі:** установіть `agents.defaults.models["openai/gpt-5.5"].params.fastMode` або `agents.defaults.models["openai-codex/gpt-5.5"].params.fastMode` у `true`. Приклад: @@ -187,39 +187,42 @@ x-i18n: } ``` - Для OpenAI fast mode відповідає `service_tier = "priority"` у підтримуваних нативних запитах Responses. Сеансові перевизначення `/fast` мають пріоритет над типовими значеннями конфігурації. + Для OpenAI швидкий режим відповідає `service_tier = "priority"` у підтримуваних нативних запитах Responses. Перевизначення сесії `/fast` мають пріоритет над стандартними значеннями конфігурації. - Див. [Thinking і fast mode](/uk/tools/thinking) та [OpenAI fast mode](/uk/providers/openai#fast-mode). + Див. [Thinking і швидкий режим](/uk/tools/thinking) та [Швидкий режим OpenAI](/uk/providers/openai#fast-mode). - Якщо встановлено `agents.defaults.models`, це стає **списком дозволених** для `/model` і будь-яких - сеансових перевизначень. Вибір моделі, якої немає в цьому списку, повертає: + Якщо задано `agents.defaults.models`, він стає **allowlist** для `/model` і будь-яких + перевизначень сесії. Вибір моделі, якої немає в цьому списку, повертає: ``` - Model "provider/model" is not allowed. Use /model to list available models. + Model "provider/model" is not allowed. Use /models to list providers, or /models to list models. + Add it with: openclaw config set agents.defaults.models '{"provider/model":{}}' --strict-json --merge ``` Ця помилка повертається **замість** звичайної відповіді. Виправлення: додайте модель до - `agents.defaults.models`, вилучіть список дозволених або виберіть модель з `/model list`. + `agents.defaults.models`, видаліть allowlist або виберіть модель з `/model list`. + Якщо команда також містила `--runtime codex`, спочатку додайте модель, а потім повторіть + ту саму команду `/model provider/model --runtime codex`. - Це означає, що **провайдера не налаштовано** (не знайдено конфігурацію провайдера MiniMax або профіль автентифікації), тож модель не можна розвʼязати. + Це означає, що **постачальника не налаштовано** (не знайдено конфігурації постачальника MiniMax або профілю автентифікації), тому модель неможливо розв'язати. Контрольний список виправлення: - 1. Оновіться до поточного випуску OpenClaw (або запустіть із source `main`), потім перезапустіть gateway. - 2. Переконайтеся, що MiniMax налаштовано (майстром або JSON), або що автентифікація MiniMax - існує в env/профілях автентифікації, щоб відповідний провайдер можна було інʼєктувати + 1. Оновіться до поточного релізу OpenClaw (або запустіть із вихідного коду `main`), потім перезапустіть gateway. + 2. Переконайтеся, що MiniMax налаштовано (майстер або JSON), або що автентифікація MiniMax + існує в env/профілях автентифікації, щоб відповідного постачальника можна було інжектувати (`MINIMAX_API_KEY` для `minimax`, `MINIMAX_OAUTH_TOKEN` або збережений MiniMax OAuth для `minimax-portal`). 3. Використовуйте точний ідентифікатор моделі (з урахуванням регістру) для вашого шляху автентифікації: - `minimax/MiniMax-M2.7` або `minimax/MiniMax-M2.7-highspeed` для налаштування з API-key, - або `minimax-portal/MiniMax-M2.7` / - `minimax-portal/MiniMax-M2.7-highspeed` для налаштування з OAuth. + `minimax/MiniMax-M2.7` або `minimax/MiniMax-M2.7-highspeed` для налаштування + з API-ключем, або `minimax-portal/MiniMax-M2.7` / + `minimax-portal/MiniMax-M2.7-highspeed` для налаштування OAuth. 4. Запустіть: ```bash @@ -232,11 +235,11 @@ x-i18n: - - Так. Використовуйте **MiniMax як типовий варіант** і перемикайте моделі **для окремого сеансу**, коли потрібно. + + Так. Використовуйте **MiniMax як стандартну модель** і перемикайте моделі **для окремої сесії**, коли потрібно. Резервні варіанти призначені для **помилок**, а не для "складних завдань", тому використовуйте `/model` або окремого агента. - **Варіант A: перемикання для окремого сеансу** + **Варіант A: перемикання для окремої сесії** ```json5 { @@ -261,20 +264,20 @@ x-i18n: **Варіант B: окремі агенти** - - Типове значення агента A: MiniMax - - Типове значення агента B: OpenAI + - Стандартна модель агента A: MiniMax + - Стандартна модель агента B: OpenAI - Маршрутизуйте за агентом або використовуйте `/agent` для перемикання - Документація: [Моделі](/uk/concepts/models), [Multi-Agent Routing](/uk/concepts/multi-agent), [MiniMax](/uk/providers/minimax), [OpenAI](/uk/providers/openai). + Документація: [Моделі](/uk/concepts/models), [Маршрутизація кількох агентів](/uk/concepts/multi-agent), [MiniMax](/uk/providers/minimax), [OpenAI](/uk/providers/openai). - - Так. OpenClaw постачається з кількома типовими скороченнями (застосовуються лише коли модель існує в `agents.defaults.models`): + + Так. OpenClaw постачається з кількома стандартними скороченнями (застосовуються лише тоді, коли модель існує в `agents.defaults.models`): - `opus` → `anthropic/claude-opus-4-6` - `sonnet` → `anthropic/claude-sonnet-4-6` - - `gpt` → `openai/gpt-5.5` для налаштувань з API-key або `openai-codex/gpt-5.5`, коли налаштовано Codex OAuth + - `gpt` → `openai/gpt-5.5` для налаштувань з API-ключем або `openai-codex/gpt-5.5`, коли налаштовано Codex OAuth - `gpt-mini` → `openai/gpt-5.4-mini` - `gpt-nano` → `openai/gpt-5.4-nano` - `gemini` → `google/gemini-3.1-pro-preview` @@ -303,11 +306,11 @@ x-i18n: } ``` - Потім `/model sonnet` (або `/`, коли підтримується) розвʼязується в цей ідентифікатор моделі. + Потім `/model sonnet` (або `/`, коли підтримується) розв'язується до цього ідентифікатора моделі. - + OpenRouter (оплата за токен; багато моделей): ```json5 @@ -336,11 +339,11 @@ x-i18n: } ``` - Якщо ви посилаєтеся на постачальника/модель, але потрібний ключ постачальника відсутній, ви отримаєте помилку автентифікації під час виконання (наприклад, `No API key found for provider "zai"`). + Якщо ви посилаєтеся на провайдера/модель, але потрібний ключ провайдера відсутній, ви отримаєте помилку автентифікації під час виконання (наприклад, `No API key found for provider "zai"`). - **Не знайдено API-ключ для постачальника після додавання нового агента** + **Ключ API для провайдера не знайдено після додавання нового агента** - Зазвичай це означає, що **новий агент** має порожнє сховище автентифікації. Автентифікація є окремою для кожного агента й + Зазвичай це означає, що **новий агент** має порожнє сховище автентифікації. Автентифікація налаштовується окремо для кожного агента та зберігається в: ``` @@ -350,120 +353,120 @@ x-i18n: Варіанти виправлення: - Запустіть `openclaw agents add ` і налаштуйте автентифікацію під час роботи майстра. - - Або скопіюйте лише портативні статичні профілі `api_key` / `token` зі сховища автентифікації основного агента до сховища автентифікації нового агента. - - Для профілів OAuth увійдіть із нового агента, коли йому потрібен власний обліковий запис; інакше OpenClaw може читати з агента за замовчуванням/основного агента без клонування refresh-токенів. + - Або скопіюйте лише переносні статичні профілі `api_key` / `token` зі сховища автентифікації основного агента до сховища автентифікації нового агента. + - Для профілів OAuth увійдіть із нового агента, коли йому потрібен власний обліковий запис; інакше OpenClaw може читати з типового/основного агента без клонування токенів оновлення. **Не** використовуйте повторно `agentDir` для різних агентів; це спричиняє конфлікти автентифікації/сеансів. -## Резервне перемикання моделей і "All models failed" +## Перемикання моделі після збою та "Усі моделі зазнали збою" - - Резервне перемикання відбувається у два етапи: + + Перемикання після збою відбувається у два етапи: - 1. **Ротація профілів автентифікації** у межах того самого постачальника. + 1. **Ротація профілю автентифікації** в межах того самого провайдера. 2. **Резервне перемикання моделі** на наступну модель у `agents.defaults.model.fallbacks`. - Для проблемних профілів застосовуються періоди очікування (експоненційна затримка), тож OpenClaw може продовжувати відповідати, навіть коли постачальник обмежує частоту запитів або тимчасово не працює. + До проблемних профілів застосовуються періоди очікування (експоненційне відкладення), тому OpenClaw може продовжувати відповідати, навіть коли провайдер обмежує частоту запитів або тимчасово дає збій. - Бакет обмеження частоти містить не лише звичайні відповіді `429`. OpenClaw - також трактує повідомлення на кшталт `Too many concurrent requests`, + Кошик обмеження частоти охоплює не лише звичайні відповіді `429`. OpenClaw + також розглядає повідомлення на кшталт `Too many concurrent requests`, `ThrottlingException`, `concurrency limit reached`, `workers_ai ... quota limit exceeded`, `resource exhausted` і періодичні - ліміти вікна використання (`weekly/monthly limit reached`) як обмеження - частоти, що потребують резервного перемикання. + обмеження вікна використання (`weekly/monthly limit reached`) як + обмеження частоти, що потребують перемикання після збою. Деякі відповіді, схожі на білінгові, не є `402`, а деякі HTTP-відповіді `402` - також залишаються в цьому тимчасовому бакеті. Якщо постачальник повертає - явний білінговий текст на `401` або `403`, OpenClaw усе одно може залишити це - в білінговій смузі, але специфічні для постачальника текстові збіги залишаються - обмеженими постачальником, якому вони належать (наприклад, OpenRouter `Key limit exceeded`). Якщо повідомлення `402` - натомість виглядає як повторюване вікно використання або + також залишаються в цьому тимчасовому кошику. Якщо провайдер повертає + явний білінговий текст для `401` або `403`, OpenClaw усе одно може залишити це + в білінговій категорії, але текстові зіставники для окремих провайдерів залишаються обмеженими + провайдером, якому вони належать (наприклад, OpenRouter `Key limit exceeded`). Якщо повідомлення `402` + натомість схоже на повторюване обмеження вікна використання або ліміт витрат організації/робочого простору (`daily limit reached, resets tomorrow`, - `organization spending limit exceeded`), OpenClaw трактує його як - `rate_limit`, а не як довге білінгове вимкнення. + `organization spending limit exceeded`), OpenClaw розглядає його як + `rate_limit`, а не як тривале вимкнення через білінг. - Помилки переповнення контексту інші: сигнатури на кшталт + Помилки переповнення контексту відрізняються: сигнатури на кшталт `request_too_large`, `input exceeds the maximum number of tokens`, `input token count exceeds the maximum number of input tokens`, `input is too long for the model` або `ollama error: context length - exceeded` залишаються на шляху Compaction/повторної спроби замість просування до + exceeded` залишаються на шляху Compaction/повторної спроби замість переходу до резервного перемикання моделі. - Універсальний текст серверної помилки навмисно вужчий, ніж "будь-що з - unknown/error у ньому". OpenClaw справді трактує прив’язані до постачальника тимчасові форми, - як-от Anthropic без додаткових даних `An unknown error occurred`, OpenRouter без додаткових даних + Узагальнений текст помилки сервера навмисно вужчий, ніж «будь-що з + unknown/error у тексті». OpenClaw розглядає тимчасові форми, обмежені провайдером, + як-от чисте Anthropic `An unknown error occurred`, чисте OpenRouter `Provider returned error`, помилки причини зупинки на кшталт `Unhandled stop reason: error`, JSON-навантаження `api_error` з тимчасовим серверним текстом (`internal server error`, `unknown error, 520`, `upstream error`, `backend - error`) і помилки зайнятості постачальника, як-от `ModelNotReadyException`, як - сигнали тайм-ауту/перевантаження, що потребують резервного перемикання, коли контекст постачальника + error`) і помилки зайнятості провайдера, як-от `ModelNotReadyException`, як + сигнали тайм-ауту/перевантаження, що потребують перемикання після збою, коли контекст провайдера збігається. - Універсальний внутрішній текст резервного шляху, як-от `LLM request failed with an unknown + Узагальнений внутрішній текст резервного сценарію, як-от `LLM request failed with an unknown error.`, залишається консервативним і сам по собі не запускає резервне перемикання моделі. - - Це означає, що система спробувала використати ID профілю автентифікації `anthropic:default`, але не змогла знайти облікові дані для нього в очікуваному сховищі автентифікації. + + Це означає, що система спробувала використати ідентифікатор профілю автентифікації `anthropic:default`, але не змогла знайти для нього облікові дані в очікуваному сховищі автентифікації. **Контрольний список виправлення:** - - **Підтвердьте, де зберігаються профілі автентифікації** (нові й застарілі шляхи) + - **Підтвердьте, де зберігаються профілі автентифікації** (нові та застарілі шляхи) - Поточний: `~/.openclaw/agents//agent/auth-profiles.json` - Застарілий: `~/.openclaw/agent/*` (мігрується через `openclaw doctor`) - - **Підтвердьте, що ваша змінна середовища завантажена Gateway** + - **Підтвердьте, що вашу змінну середовища завантажує Gateway** - Якщо ви встановили `ANTHROPIC_API_KEY` у своїй оболонці, але запускаєте Gateway через systemd/launchd, він може її не успадкувати. Помістіть її в `~/.openclaw/.env` або увімкніть `env.shellEnv`. - **Переконайтеся, що ви редагуєте правильного агента** - - У налаштуваннях із кількома агентами може бути кілька файлів `auth-profiles.json`. + - У конфігураціях із кількома агентами може бути кілька файлів `auth-profiles.json`. - **Перевірте стан моделі/автентифікації** - - Використайте `openclaw models status`, щоб побачити налаштовані моделі й чи автентифіковані постачальники. + - Використайте `openclaw models status`, щоб переглянути налаштовані моделі та чи автентифіковані провайдери. - **Контрольний список виправлення для "No credentials found for profile anthropic"** + **Контрольний список виправлення для "Облікові дані для профілю anthropic не знайдено"** Це означає, що запуск закріплено за профілем автентифікації Anthropic, але Gateway не може знайти його у своєму сховищі автентифікації. - **Використайте Claude CLI** - Запустіть `openclaw models auth login --provider anthropic --method cli --set-default` на хості gateway. - - **Якщо натомість ви хочете використати API-ключ** + - **Якщо натомість ви хочете використати ключ API** - Помістіть `ANTHROPIC_API_KEY` у `~/.openclaw/.env` на **хості gateway**. - - Очистьте будь-який закріплений порядок, який примусово використовує відсутній профіль: + - Очистьте будь-який закріплений порядок, який примусово вимагає відсутній профіль: ```bash openclaw models auth order clear --provider anthropic ``` - - **Підтвердьте, що ви виконуєте команди на хості gateway** + - **Підтвердьте, що виконуєте команди на хості gateway** - У віддаленому режимі профілі автентифікації зберігаються на машині gateway, а не на вашому ноутбуці. - - Якщо ваша конфігурація моделі містить Google Gemini як резервний варіант (або ви перемкнулися на скорочення Gemini), OpenClaw спробує його під час резервного перемикання моделі. Якщо ви не налаштували облікові дані Google, ви побачите `No API key found for provider "google"`. + + Якщо ваша конфігурація моделі включає Google Gemini як резервний варіант (або ви перемкнулися на скорочення Gemini), OpenClaw спробує його під час резервного перемикання моделі. Якщо ви не налаштували облікові дані Google, ви побачите `No API key found for provider "google"`. - Виправлення: або надайте автентифікацію Google, або видаліть/уникайте моделей Google у `agents.defaults.model.fallbacks` / псевдонімах, щоб резервне перемикання не маршрутизувало туди. + Виправлення: або надайте автентифікацію Google, або приберіть/уникайте моделей Google у `agents.defaults.model.fallbacks` / псевдонімах, щоб резервний перехід не спрямовував туди. - **Запит LLM відхилено: потрібен підпис thinking (Google Antigravity)** + **Запит LLM відхилено: потрібен підпис мислення (Google Antigravity)** - Причина: історія сеансу містить **блоки thinking без підписів** (часто з - перерваного/часткового потоку). Google Antigravity вимагає підписів для блоків thinking. + Причина: історія сеансу містить **блоки мислення без підписів** (часто з + перерваного/часткового потоку). Google Antigravity вимагає підписи для блоків мислення. - Виправлення: OpenClaw тепер видаляє непідписані блоки thinking для Google Antigravity Claude. Якщо це все ще з’являється, почніть **новий сеанс** або встановіть `/thinking off` для цього агента. + Виправлення: OpenClaw тепер вилучає непідписані блоки мислення для Google Antigravity Claude. Якщо це все ще з'являється, почніть **новий сеанс** або встановіть `/thinking off` для цього агента. ## Профілі автентифікації: що це таке і як ними керувати -Пов’язано: [/concepts/oauth](/uk/concepts/oauth) (потоки OAuth, зберігання токенів, шаблони кількох облікових записів) +Пов'язано: [/concepts/oauth](/uk/concepts/oauth) (потоки OAuth, зберігання токенів, шаблони кількох облікових записів) - Профіль автентифікації — це іменований запис облікових даних (OAuth або API-ключ), прив’язаний до постачальника. Профілі зберігаються в: + Профіль автентифікації - це іменований запис облікових даних (OAuth або API-ключ), прив'язаний до провайдера. Профілі зберігаються в: ``` ~/.openclaw/agents//agent/auth-profiles.json @@ -471,25 +474,25 @@ x-i18n: - - OpenClaw використовує ID з префіксом постачальника, наприклад: + + OpenClaw використовує ID із префіксом провайдера, наприклад: - - `anthropic:default` (типово, коли немає ідентичності електронної пошти) + - `anthropic:default` (типово, коли немає ідентичності email) - `anthropic:` для ідентичностей OAuth - власні ID, які ви обираєте (наприклад, `anthropic:work`) - - Так. Конфігурація підтримує необов’язкові метадані для профілів і порядок для кожного постачальника (`auth.order.`). Це **не** зберігає секрети; це зіставляє ID з постачальником/режимом і задає порядок ротації. + + Так. Конфігурація підтримує необов'язкові метадані для профілів і порядок для кожного провайдера (`auth.order.`). Це **не** зберігає секрети; воно зіставляє ID з провайдером/режимом і задає порядок ротації. - OpenClaw може тимчасово пропустити профіль, якщо він перебуває в короткому **періоді очікування** (обмеження частоти/тайм-аути/збої автентифікації) або в довшому стані **вимкнено** (білінг/недостатньо кредитів). Щоб перевірити це, запустіть `openclaw models status --json` і перегляньте `auth.unusableProfiles`. Налаштування: `auth.cooldowns.billingBackoffHours*`. + OpenClaw може тимчасово пропустити профіль, якщо він перебуває в короткому **періоді охолодження** (ліміти частоти/тайм-аути/помилки автентифікації) або довшому стані **вимкнено** (білінг/недостатньо кредитів). Щоб це перевірити, виконайте `openclaw models status --json` і перегляньте `auth.unusableProfiles`. Налаштування: `auth.cooldowns.billingBackoffHours*`. - Періоди очікування через обмеження частоти можуть бути прив’язані до моделі. Профіль, який охолоджується - для однієї моделі, усе ще може бути придатним для спорідненої моделі в того самого постачальника, - тоді як білінгові/вимкнені вікна все одно блокують увесь профіль. + Періоди охолодження через ліміти частоти можуть бути прив'язані до моделі. Профіль, який перебуває в охолодженні + для однієї моделі, усе ще може бути придатним для спорідненої моделі того самого провайдера, + тоді як вікна білінгу/вимкнення все ще блокують увесь профіль. - Ви також можете встановити перевизначення порядку **для окремого агента** (зберігається в `auth-state.json` цього агента) через CLI: + Також можна задати перевизначення порядку **для окремого агента** (зберігається в `auth-state.json` цього агента) через CLI: ```bash # Defaults to the configured default agent (omit --agent) @@ -511,21 +514,21 @@ x-i18n: openclaw models auth order set --provider anthropic --agent main anthropic:default ``` - Щоб перевірити, що насправді буде спробовано, використайте: + Щоб перевірити, що фактично буде спробувано, використайте: ```bash openclaw models status --probe ``` - Якщо збережений профіль пропущено в явному порядку, probe повідомляє - `excluded_by_auth_order` для цього профілю замість того, щоб непомітно спробувати його. + Якщо збережений профіль пропущено в явному порядку, проба повідомляє + `excluded_by_auth_order` для цього профілю замість того, щоб мовчки пробувати його. - + OpenClaw підтримує обидва варіанти: - - **OAuth** часто використовує доступ за підпискою (де це застосовно). + - **OAuth** часто використовує доступ за підпискою (де застосовно). - **API-ключі** використовують оплату за токени. Майстер явно підтримує Anthropic Claude CLI, OpenAI Codex OAuth і API-ключі. @@ -533,9 +536,9 @@ x-i18n: -## Пов’язане +## Пов'язане - [FAQ](/uk/help/faq) — основний FAQ -- [FAQ — швидкий старт і перше налаштування](/uk/help/faq-first-run) +- [FAQ — швидкий старт і налаштування першого запуску](/uk/help/faq-first-run) - [Вибір моделі](/uk/concepts/model-providers) - [Резервне перемикання моделей](/uk/concepts/model-failover)