chore(i18n): refresh uk translations

2026-05-02 07:46:25 +00:00 · 2026-05-02 07:46:25 +00:00 · 06faba7c67
commit 06faba7c67
parent e75f6ab0c7
1 changed files with 87 additions and 86 deletions
--- 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 вибору
-    - Оновлення зондів сканування моделей (інструменти/зображення)
+    - Додавання або змінення CLI моделей (models list/set/scan/aliases/fallbacks)
+    - Зміна поведінки резервного перемикання моделей або UX вибору
+    - Оновлення перевірок сканування моделей (інструменти/зображення)
 sidebarTitle: Models CLI
 summary: 'CLI моделей: список, встановлення, псевдоніми, резервні варіанти, сканування, статус'
 title: CLI моделей
 x-i18n:
-    generated_at: "2026-05-02T02:37:24Z"
+    generated_at: "2026-05-02T07:45:18Z"
    model: gpt-5.5
    provider: openai
-    source_hash: 620df60ee1117a32f0232bf4b56fbc5a9558be5cc3b73a31336f8ab64fd29ebb
+    source_hash: d362c8cc41801b5e480560c8d34be53e1ada53a23c49af99adb7874e265ddb1f
    source_path: concepts/models.md
    workflow: 16
 ---

 <CardGroup cols={2}>
  <Card title="Відмовостійке перемикання моделей" href="/uk/concepts/model-failover">
-    Ротація профілів автентифікації, періоди очікування та як це взаємодіє з резервними варіантами.
+    Ротація профілів автентифікації, cooldowns і те, як це взаємодіє з резервними варіантами.
  </Card>
  <Card title="Провайдери моделей" href="/uk/concepts/model-providers">
    Короткий огляд провайдерів і приклади.
@ -26,11 +26,11 @@ x-i18n:
    PI, Codex та інші середовища виконання циклу агента.
  </Card>
  <Card title="Довідник конфігурації" href="/uk/gateway/config-agents#agent-defaults">
-    Ключі конфігурації моделі.
+    Ключі конфігурації моделей.
  </Card>
 </CardGroup>

-Посилання на моделі вибирають провайдера й модель. Зазвичай вони не вибирають низькорівневе середовище виконання агента. Наприклад, `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).

 ## Як працює вибір моделі

@ -50,33 +50,33 @@ OpenClaw вибирає моделі в такому порядку:

 <AccordionGroup>
  <Accordion title="Пов’язані поверхні моделей">
-    - `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.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)).

  </Accordion>
 </AccordionGroup>

-## Джерело вибору й поведінка резервного переходу
+## Джерело вибору та поведінка резервних варіантів

-Однакове `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 default-model і засоби вибору 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"`; якщо вибраний 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`.

 ## Коротка політика моделей

- Задайте основною найпотужнішу доступну вам модель останнього покоління.
+- Задайте основною найпотужнішу модель останнього покоління, доступну вам.
 - Використовуйте резервні варіанти для завдань, чутливих до вартості/затримки, і чатів із нижчими ризиками.
- Для агентів з увімкненими інструментами або недовірених вхідних даних уникайте старіших/слабших рівнів моделей.
+- Для агентів з увімкненими інструментами або ненадійних вхідних даних уникайте старіших/слабших рівнів моделей.

 ## Онбординг (рекомендовано)

@ -101,12 +101,12 @@ openclaw onboard
 <Note>
 Посилання на моделі нормалізуються до нижнього регістру. Псевдоніми провайдерів на кшталт `z.ai/*` нормалізуються до `zai/*`.

-Приклади конфігурації провайдерів (включно з OpenCode) містяться в [OpenCode](/uk/providers/opencode).
+Приклади конфігурації провайдерів (зокрема OpenCode) наведено в [OpenCode](/uk/providers/opencode).
 </Note>

-### Безпечні редагування allowlist
+### Безпечні зміни allowlist

-Використовуйте адитивні записи, коли оновлюєте `agents.defaults.models` вручну:
+Використовуйте додавальні записи, коли оновлюєте `agents.defaults.models` вручну:

 ```bash
 openclaw config set agents.defaults.models '{"openai/gpt-5.4":{}}' --strict-json --merge
@ -114,31 +114,31 @@ openclaw config set agents.defaults.models '{"openai/gpt-5.4":{}}' --strict-json

 <AccordionGroup>
  <Accordion title="Правила захисту від перезапису">
-    `openclaw config set` захищає мапи моделей/провайдерів від випадкових перезаписів. Звичайне присвоєння об’єкта до `agents.defaults.models`, `models.providers` або `models.providers.<id>.models` відхиляється, якщо воно вилучило б наявні записи. Використовуйте `--merge` для адитивних змін; використовуйте `--replace` лише тоді, коли надане значення має стати повним цільовим значенням.
+    `openclaw config set` захищає мапи моделей/провайдерів від випадкового перезапису. Просте присвоєння об’єкта до `agents.defaults.models`, `models.providers` або `models.providers.<id>.models` відхиляється, якщо воно видалило б наявні записи. Використовуйте `--merge` для додавальних змін; використовуйте `--replace` лише тоді, коли надане значення має стати повним цільовим значенням.

-    Інтерактивне налаштування провайдера й `openclaw configure --section model` також зливають вибори в межах провайдера з наявним allowlist, тож додавання Codex, Ollama або іншого провайдера не видаляє непов’язані записи моделей. Configure зберігає наявний `agents.defaults.model.primary`, коли автентифікацію провайдера застосовують повторно. Явні команди встановлення стандартного значення, такі як `openclaw models auth login --provider <id> --set-default` і `openclaw models set <model>`, усе ще замінюють `agents.defaults.model.primary`.
+    Інтерактивне налаштування провайдера та `openclaw configure --section model` також об’єднують вибори в межах провайдера з наявним allowlist, тому додавання Codex, Ollama або іншого провайдера не видаляє непов’язані записи моделей. Configure зберігає наявний `agents.defaults.model.primary`, коли автентифікацію провайдера застосовано повторно. Явні команди встановлення стандартних значень, як-от `openclaw models auth login --provider <id> --set-default` і `openclaw models set <model>`, все ще замінюють `agents.defaults.model.primary`.

  </Accordion>
 </AccordionGroup>

 ## "Модель не дозволена" (і чому відповіді зупиняються)

-Якщо `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.
 ```

 <Warning>
-Це відбувається **до** створення звичайної відповіді, тому може здаватися, що повідомлення "не відповіло". Виправлення: зробіть одне з такого:
+Це відбувається **до** створення звичайної відповіді, тому може здаватися, що повідомлення "не відповіло". Виправлення полягає в одному з варіантів:

- Додайте модель до `agents.defaults.models`, або
- Очистьте allowlist (видаліть `agents.defaults.models`), або
- Виберіть модель із `/model list`.
+- Додати модель до `agents.defaults.models`, або
+- Очистити allowlist (видалити `agents.defaults.models`), або
+- Вибрати модель із `/model list`.

 </Warning>

-Для локальних/GGUF-моделей зберігайте повне посилання з префіксом провайдера в allowlist,
+Для локальних/GGUF-моделей зберігайте в allowlist повне посилання з префіксом провайдера,
 наприклад `ollama/gemma4:26b`, `lmstudio/Gemma4-26b-a4-it-gguf` або
 точний provider/model, показаний `openclaw models list --provider <provider>`.
 Самих локальних імен файлів або відображуваних назв недостатньо, коли allowlist
@ -160,7 +160,7 @@ Model "provider/model" is not allowed. Use /model to list available models.

 ## Перемикання моделей у чаті (`/model`)

-Ви можете перемикати моделі для поточної сесії без перезапуску:
+Ви можете перемикати моделі для поточного сеансу без перезапуску:

 ```
 /model
@ -172,32 +172,33 @@ Model "provider/model" is not allowed. Use /model to list available models.

 <AccordionGroup>
  <Accordion title="Поведінка засобу вибору">
-    - `/model` (і `/model list`) — це компактний нумерований засіб вибору (родина моделі + доступні провайдери).
+    - `/model` (і `/model list`) — це компактний нумерований засіб вибору (сімейство моделей + доступні провайдери).
    - У Discord `/model` і `/models` відкривають інтерактивний засіб вибору з випадаючими списками провайдера й моделі та кроком Submit.
-    - `/models add` застарілий і тепер повертає повідомлення про застарілість замість реєстрації моделей із чату.
+    - У Telegram вибори в засобі `/models` обмежені сеансом; вони не змінюють постійне стандартне значення агента в `openclaw.json`.
+    - `/models add` застарів і тепер повертає повідомлення про застарілість замість реєстрації моделей із чату.
    - `/model <#>` вибирає з цього засобу вибору.

  </Accordion>
-  <Accordion title="Збереження та живе перемикання">
-    - `/model` одразу зберігає новий вибір сесії.
-    - Якщо агент бездіє, наступний запуск одразу використовує нову модель.
-    - Якщо запуск уже активний, OpenClaw позначає живе перемикання як очікуване й перезапускає в нову модель лише в чистій точці повторної спроби.
+  <Accordion title="Збереження та перемикання наживо">
+    - `/model` негайно зберігає новий вибір сеансу.
+    - Якщо агент простоює, наступний запуск одразу використовує нову модель.
+    - Якщо запуск уже активний, OpenClaw позначає перемикання наживо як очікуване й перезапускається в новій моделі лише в чистій точці повторної спроби.
    - Якщо активність інструментів або виведення відповіді вже почалися, очікуване перемикання може залишатися в черзі до пізнішої можливості повторної спроби або наступного ходу користувача.
-    - Вибране користувачем посилання `/model` є суворим для цієї сесії: якщо вибраний provider/model недоступний, відповідь завершується видимою помилкою замість тихого використання `agents.defaults.model.fallbacks`. Це відрізняється від налаштованих стандартних значень і основних моделей cron-завдань, які все ще можуть використовувати резервні ланцюжки.
-    - `/model status` — це детальне подання (кандидати автентифікації та, коли налаштовано, endpoint провайдера `baseUrl` + режим `api`).
+    - Вибране користувачем посилання `/model` є суворим для цього сеансу: якщо вибраний provider/model недосяжний, відповідь помітно завершується помилкою замість непомітної відповіді з `agents.defaults.model.fallbacks`. Це відрізняється від налаштованих стандартних значень і основних моделей завдань cron, які все ще можуть використовувати ланцюги резервних варіантів.
+    - `/model status` — це детальний перегляд (кандидати автентифікації та, коли налаштовано, endpoint провайдера `baseUrl` + режим `api`).

  </Accordion>
  <Accordion title="Розбір посилань">
    - Посилання на моделі розбираються поділом за **першим** `/`. Використовуйте `provider/model`, коли вводите `/model <ref>`.
-    - Якщо сам ID моделі містить `/` (у стилі OpenRouter), потрібно включити префікс провайдера (приклад: `/model openrouter/moonshotai/kimi-k2`).
-    - Якщо ви пропускаєте провайдера, OpenClaw розв’язує введення в такому порядку:
+    - Якщо сам ID моделі містить `/` (у стилі OpenRouter), потрібно додати префікс провайдера (приклад: `/model openrouter/moonshotai/kimi-k2`).
+    - Якщо ви пропустите провайдера, OpenClaw розв’язує введення в такому порядку:
      1. збіг псевдоніма
-      2. унікальний збіг налаштованого провайдера для цього точного id моделі без префікса
-      3. застарілий резервний перехід до налаштованого стандартного провайдера — якщо цей провайдер більше не надає налаштовану стандартну модель, OpenClaw натомість переходить до першого налаштованого provider/model, щоб не показувати застаріле стандартне значення вилученого провайдера.
+      2. унікальний збіг налаштованого провайдера для цього точного ID моделі без префікса
+      3. застарілий резервний перехід до налаштованого стандартного провайдера — якщо цей провайдер більше не надає налаштовану стандартну модель, OpenClaw натомість переходить до першого налаштованого provider/model, щоб уникнути показу застарілого стандартного значення видаленого провайдера.
  </Accordion>
 </AccordionGroup>

-Повна поведінка/конфігурація команд: [Slash-команди](/uk/tools/slash-commands).
+Повна поведінка команд/конфігурація: [Слеш-команди](/uk/tools/slash-commands).

 ## Команди CLI

@ -229,38 +230,38 @@ openclaw models image-fallbacks clear
 За замовчуванням показує налаштовані/доступні через автентифікацію моделі. Корисні прапорці:

 <ParamField path="--all" type="boolean">
-  Повний каталог. Містить статичні рядки каталогу вбудованих моделей, що належать провайдерам, ще до налаштування автентифікації, тому подання лише для виявлення можуть показувати моделі, недоступні, доки ви не додасте відповідні облікові дані провайдера.
+  Повний каталог. Містить статичні рядки каталогу вбудованих моделей, що належать провайдерам, ще до налаштування автентифікації, тож подання лише для виявлення можуть показувати моделі, недоступні, доки ви не додасте відповідні облікові дані провайдера.
 </ParamField>
 <ParamField path="--local" type="boolean">
  Лише локальні провайдери.
 </ParamField>
 <ParamField path="--provider <id>" type="string">
-  Фільтрувати за ідентифікатором провайдера, наприклад `moonshot`. Відображувані мітки з інтерактивних вибирачів не приймаються.
+  Фільтрувати за ідентифікатором провайдера, наприклад `moonshot`. Відображувані назви з інтерактивних засобів вибору не приймаються.
 </ParamField>
 <ParamField path="--plain" type="boolean">
  Одна модель на рядок.
 </ParamField>
 <ParamField path="--json" type="boolean">
-  Машинозчитуваний вивід.
+  Машиночитаний вивід.
 </ParamField>

 ### `models status`

-Показує визначену основну модель, резервні варіанти, модель зображень і огляд автентифікації налаштованих провайдерів. Також показує статус завершення терміну дії OAuth для профілів, знайдених у сховищі автентифікації (за замовчуванням попереджає за 24 год). `--plain` друкує лише визначену основну модель.
+Показує визначену основну модель, резервні моделі, модель зображень і огляд автентифікації налаштованих провайдерів. Також показує стан завершення строку дії OAuth для профілів, знайдених у сховищі автентифікації (за замовчуванням попереджає протягом 24 год). `--plain` друкує лише визначену основну модель.

 <AccordionGroup>
-  <Accordion title="Поведінка автентифікації та перевірок">
-    - Статус OAuth показується завжди (і включається у вивід `--json`). Якщо налаштований провайдер не має облікових даних, `models status` друкує розділ **Відсутня автентифікація**.
-    - JSON містить `auth.oauth` (вікно попередження + профілі) і `auth.providers` (ефективна автентифікація для кожного провайдера, включно з обліковими даними з env). `auth.oauth` показує лише стан профілів зі сховища автентифікації; провайдери лише з env там не з'являються.
-    - Використовуйте `--check` для автоматизації (код виходу `1`, коли бракує або завершився термін дії, `2`, коли термін дії скоро завершиться).
-    - Використовуйте `--probe` для live-перевірок автентифікації; рядки перевірок можуть надходити з профілів автентифікації, облікових даних env або `models.json`.
-    - Якщо явний `auth.order.<provider>` пропускає збережений профіль, перевірка повідомляє `excluded_by_auth_order` замість спроби використати його. Якщо автентифікація існує, але для цього провайдера не можна визначити модель, придатну до перевірки, перевірка повідомляє `status: no_model`.
+  <Accordion title="Поведінка автентифікації та перевірки">
+    - Стан OAuth показується завжди (і включається у вивід `--json`). Якщо налаштований провайдер не має облікових даних, `models status` друкує розділ **Відсутня автентифікація**.
+    - JSON містить `auth.oauth` (вікно попередження + профілі) і `auth.providers` (ефективна автентифікація для кожного провайдера, зокрема облікові дані зі змінних середовища). `auth.oauth` відображає лише стан профілів у сховищі автентифікації; провайдери лише зі змінними середовища там не з’являються.
+    - Використовуйте `--check` для автоматизації (код виходу `1`, коли автентифікація відсутня або строк дії минув, `2`, коли строк дії добігає кінця).
+    - Використовуйте `--probe` для live-перевірок автентифікації; рядки перевірки можуть походити з профілів автентифікації, облікових даних зі змінних середовища або `models.json`.
+    - Якщо явний `auth.order.<provider>` пропускає збережений профіль, перевірка повідомляє `excluded_by_auth_order` замість спроби використати його. Якщо автентифікація існує, але для цього провайдера не вдається визначити модель, яку можна перевірити, перевірка повідомляє `status: no_model`.

  </Accordion>
 </AccordionGroup>

 <Note>
-Вибір автентифікації залежить від провайдера й облікового запису. Для постійно ввімкнених хостів Gateway ключі API зазвичай найпередбачуваніші; також підтримується повторне використання Claude CLI та наявні профілі Anthropic OAuth/token.
+Вибір автентифікації залежить від провайдера й облікового запису. Для постійно ввімкнених хостів Gateway ключі API зазвичай найпередбачуваніші; також підтримується повторне використання Claude CLI і наявні профілі Anthropic OAuth/токенів.
 </Note>

 Приклад (Claude CLI):
@ -270,15 +271,15 @@ claude auth login
 openclaw models status
 ```

-## Сканування (безкоштовні моделі OpenRouter)
+## Сканування (безплатні моделі OpenRouter)

-`openclaw models scan` перевіряє **каталог безкоштовних моделей** OpenRouter і може додатково перевіряти моделі на підтримку інструментів і зображень.
+`openclaw models scan` перевіряє **каталог безплатних моделей** OpenRouter і може додатково перевіряти моделі на підтримку інструментів і зображень.

 <ParamField path="--no-probe" type="boolean">
  Пропустити live-перевірки (лише метадані).
 </ParamField>
 <ParamField path="--min-params <b>" type="number">
-  Мінімальний розмір параметрів (у мільярдах).
+  Мінімальний розмір параметрів (мільярди).
 </ParamField>
 <ParamField path="--max-age-days <days>" type="number">
  Пропустити старіші моделі.
@ -287,17 +288,17 @@ openclaw models status
  Фільтр за префіксом провайдера.
 </ParamField>
 <ParamField path="--max-candidates <n>" type="number">
-  Розмір списку резервних варіантів.
+  Розмір списку резервних моделей.
 </ParamField>
 <ParamField path="--set-default" type="boolean">
-  Установити `agents.defaults.model.primary` на перший вибраний варіант.
+  Встановити `agents.defaults.model.primary` на перший вибір.
 </ParamField>
 <ParamField path="--set-image" type="boolean">
-  Установити `agents.defaults.imageModel.primary` на перший вибраний варіант зображень.
+  Встановити `agents.defaults.imageModel.primary` на перший вибір зображень.
 </ParamField>

 <Note>
-Каталог OpenRouter `/models` є публічним, тому сканування лише метаданих може показувати безкоштовних кандидатів без ключа. Перевірки й інференс усе одно потребують ключа API OpenRouter (з профілів автентифікації або `OPENROUTER_API_KEY`). Якщо ключ недоступний, `openclaw models scan` повертається до виводу лише метаданих і залишає конфігурацію без змін. Використовуйте `--no-probe`, щоб явно запросити режим лише метаданих.
+Каталог OpenRouter `/models` є публічним, тому сканування лише метаданих може перелічувати безплатні кандидатні моделі без ключа. Перевірка й інференс усе ще потребують ключа API OpenRouter (з профілів автентифікації або `OPENROUTER_API_KEY`). Якщо ключ недоступний, `openclaw models scan` повертається до виводу лише метаданих і залишає конфігурацію без змін. Використовуйте `--no-probe`, щоб явно запитати режим лише метаданих.
 </Note>

 Результати сканування ранжуються за:
@ -311,39 +312,39 @@ 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`
+- Додаткові фільтри: `--max-age-days`, `--min-params`, `--provider`, `--max-candidates`
+- Елементи керування запитом/перевіркою: `--timeout`, `--concurrency`

-Коли live-перевірки виконуються в TTY, ви можете інтерактивно вибирати резервні варіанти. У неінтерактивному режимі передайте `--yes`, щоб прийняти значення за замовчуванням. Результати лише за метаданими є інформаційними; `--set-default` і `--set-image` потребують live-перевірок, щоб OpenClaw не налаштував непридатну до використання модель OpenRouter без ключа.
+Коли live-перевірки виконуються в TTY, можна інтерактивно вибирати резервні моделі. У неінтерактивному режимі передайте `--yes`, щоб прийняти стандартні значення. Результати лише з метаданими є інформаційними; `--set-default` і `--set-image` потребують live-перевірок, щоб OpenClaw не налаштував непридатну для використання модель OpenRouter без ключа.

 ## Реєстр моделей (`models.json`)

-Користувацькі провайдери в `models.providers` записуються в `models.json` у каталозі агента (за замовчуванням `~/.openclaw/agents/<agentId>/agent/models.json`). Цей файл за замовчуванням об'єднується, якщо `models.mode` не встановлено в `replace`.
+Користувацькі провайдери в `models.providers` записуються в `models.json` у каталозі агента (за замовчуванням `~/.openclaw/agents/<agentId>/agent/models.json`). Цей файл за замовчуванням об’єднується, якщо `models.mode` не встановлено на `replace`.

 <AccordionGroup>
-  <Accordion title="Пріоритет режиму об'єднання">
-    Пріоритет режиму об'єднання для відповідних ідентифікаторів провайдерів:
+  <Accordion title="Пріоритет режиму об’єднання">
+    Пріоритет режиму об’єднання для відповідних ідентифікаторів провайдерів:

-    - Непорожній `baseUrl`, уже наявний в агентському `models.json`, має перевагу.
-    - Непорожній `apiKey` в агентському `models.json` має перевагу лише тоді, коли цей провайдер не керується SecretRef у поточному контексті конфігурації/профілю автентифікації.
-    - Значення `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` з конфігурації.
+    - Непорожній `baseUrl`, уже наявний у `models.json` агента, має перевагу.
+    - Непорожній `apiKey` у `models.json` агента має перевагу лише тоді, коли цей провайдер не керується SecretRef у поточному контексті конфігурації/профілю автентифікації.
+    - Значення `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` з конфігурації.
    - Інші поля провайдера оновлюються з конфігурації та нормалізованих даних каталогу.

  </Accordion>
 </AccordionGroup>

 <Note>
-Збереження маркерів є авторитетним щодо джерела: OpenClaw записує маркери з активного знімка вихідної конфігурації (до визначення), а не з визначених значень runtime-секретів. Це застосовується щоразу, коли OpenClaw регенерує `models.json`, зокрема для шляхів, керованих командами, як-от `openclaw agent`.
+Збереження маркерів авторитетно спирається на джерело: OpenClaw записує маркери з активного знімка вихідної конфігурації (до визначення), а не з визначених значень runtime-секретів. Це застосовується щоразу, коли OpenClaw повторно генерує `models.json`, зокрема для шляхів, керованих командами, як-от `openclaw agent`.
 </Note>

-## Пов'язане
+## Пов’язане

- [Середовища виконання агентів](/uk/concepts/agent-runtimes) — PI, Codex та інші середовища виконання агентського циклу
+- [Runtime-середовища агентів](/uk/concepts/agent-runtimes) — PI, Codex та інші runtime-середовища агентного циклу
 - [Довідник конфігурації](/uk/gateway/config-agents#agent-defaults) — ключі конфігурації моделей
- [Генерація зображень](/uk/tools/image-generation) — конфігурація моделей зображень
- [Відмовостійке перемикання моделей](/uk/concepts/model-failover) — ланцюжки резервних варіантів
+- [Генерація зображень](/uk/tools/image-generation) — конфігурація моделі зображень
+- [Відмовостійке перемикання моделей](/uk/concepts/model-failover) — ланцюжки резервних моделей
 - [Провайдери моделей](/uk/concepts/model-providers) — маршрутизація провайдерів і автентифікація
- [Генерація музики](/uk/tools/music-generation) — конфігурація моделей музики
- [Генерація відео](/uk/tools/video-generation) — конфігурація моделей відео
+- [Генерація музики](/uk/tools/music-generation) — конфігурація моделі музики
+- [Генерація відео](/uk/tools/video-generation) — конфігурація моделі відео