chore(i18n): refresh uk translations

2026-04-24 18:59:39 +00:00 · 2026-04-24 18:59:39 +00:00 · 25d01b12ae
commit 25d01b12ae
parent 6f45bb0c62
2 changed files with 127 additions and 116 deletions
--- a/docs/uk/cli/configure.md
+++ b/docs/uk/cli/configure.md
@ -1,13 +1,13 @@
 ---
 read_when:
    - Ви хочете інтерактивно налаштувати облікові дані, пристрої або типові параметри агента
-summary: Довідник CLI для `openclaw configure` (інтерактивні запити конфігурації)
-title: Налаштування
+summary: Довідник CLI для `openclaw configure` (інтерактивні запити налаштування)
+title: Налаштувати
 x-i18n:
-    generated_at: "2026-04-24T04:11:49Z"
+    generated_at: "2026-04-24T18:58:34Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 822c01f8c0fe9dc4c170f3418bc836b1d18b4713551355b0a18de9e613754dd0
+    source_hash: 15f445b1b5dd7198175c718d51ae50f9c9c0f3dcbb199adacf9155f6a512d93a
    source_path: cli/configure.md
    workflow: 15
 ---
@ -16,35 +16,38 @@ x-i18n:

 Інтерактивний запит для налаштування облікових даних, пристроїв і типових параметрів агента.

-Примітка: розділ **Model** тепер містить мультивибір для allowlist `agents.defaults.models` (що показується в `/model` і в засобі вибору моделі).
-Варіанти налаштування в межах провайдера додають вибрані моделі до наявного
-allowlist замість того, щоб замінювати не пов’язаних провайдерів, які вже є в конфігурації.
+Примітка: Розділ **Model** тепер містить багатовибірний список для allowlist `agents.defaults.models` (що відображається в `/model` і у виборі моделі).
+Параметри налаштування в межах провайдера об’єднують вибрані моделі з наявним
+allowlist замість заміни не пов’язаних провайдерів, які вже є в конфігурації.
+Повторний запуск автентифікації провайдера з configure зберігає наявне значення
+`agents.defaults.model.primary`; використовуйте `openclaw models auth login --provider <id> --set-default`
+або `openclaw models set <model>`, якщо ви свідомо хочете змінити типову модель.

-Коли configure запускається з вибору автентифікації провайдера, засоби вибору
-моделі за замовчуванням і allowlist автоматично віддають перевагу цьому провайдеру. Для парних провайдерів, таких
-як Volcengine/BytePlus, така сама перевага також поширюється на їхні варіанти
-плану для кодування (`volcengine-plan/*`, `byteplus-plan/*`). Якщо фільтр
-preferred-provider дасть порожній список, configure повертається до нефільтрованого
-каталогу замість того, щоб показувати порожній засіб вибору.
+Коли configure запускається з вибору автентифікації провайдера, засоби вибору типової моделі та
+allowlist автоматично надають перевагу цьому провайдеру. Для парних провайдерів, таких
+як Volcengine/BytePlus, така сама перевага також застосовується до їхніх варіантів
+плану кодування (`volcengine-plan/*`, `byteplus-plan/*`). Якщо фільтр preferred-provider
+призводить до порожнього списку, configure повертається до нефільтрованого
+каталогу замість показу порожнього списку вибору.

 Порада: `openclaw config` без підкоманди відкриває той самий майстер. Використовуйте
-`openclaw config get|set|unset` для неінтерактивних змін.
+`openclaw config get|set|unset` для неінтерактивного редагування.

 Для вебпошуку `openclaw configure --section web` дає змогу вибрати провайдера
-і налаштувати його облікові дані. Деякі провайдери також показують додаткові
-запити, специфічні для провайдера:
+і налаштувати його облікові дані. Деякі провайдери також показують
+подальші запити, специфічні для провайдера:

 - **Grok** може запропонувати необов’язкове налаштування `x_search` з тим самим `XAI_API_KEY` і
  дати змогу вибрати модель `x_search`.
 - **Kimi** може запитати регіон Moonshot API (`api.moonshot.ai` чи
  `api.moonshot.cn`) і типову модель вебпошуку Kimi.

-Пов’язане:
+Пов’язано:

 - Довідник із конфігурації Gateway: [Configuration](/uk/gateway/configuration)
- Config CLI: [Config](/uk/cli/config)
+- CLI конфігурації: [Config](/uk/cli/config)

-## Параметри
+## Опції

 - `--section <section>`: повторюваний фільтр розділів

@ -62,11 +65,11 @@ preferred-provider дасть порожній список, configure пове

 Примітки:

- Вибір місця, де працює Gateway, завжди оновлює `gateway.mode`. Ви можете вибрати "Продовжити" без інших розділів, якщо вам потрібно лише це.
- Сервіси, орієнтовані на канали (Slack/Discord/Matrix/Microsoft Teams), під час налаштування запитують allowlist каналів/кімнат. Ви можете вводити назви або ID; майстер за можливості перетворює назви на ID.
- Якщо ви запускаєте крок встановлення daemon, автентифікація за токеном потребує токена, а `gateway.auth.token` керується через SecretRef, configure перевіряє SecretRef, але не зберігає розв’язані відкриті значення токена в метаданих середовища служби supervisor.
- Якщо автентифікація за токеном потребує токена, а налаштований SecretRef для токена не розв’язується, configure блокує встановлення daemon і надає практичні вказівки для виправлення.
- Якщо налаштовано і `gateway.auth.token`, і `gateway.auth.password`, а `gateway.auth.mode` не встановлено, configure блокує встановлення daemon, доки режим не буде явно задано.
+- Вибір місця, де працює Gateway, завжди оновлює `gateway.mode`. Ви можете вибрати «Продовжити» без інших розділів, якщо вам потрібно лише це.
+- Сервіси, орієнтовані на канали (Slack/Discord/Matrix/Microsoft Teams), під час налаштування запитують allowlist каналів/кімнат. Ви можете вводити назви або ID; майстер, коли це можливо, перетворює назви на ID.
+- Якщо ви запускаєте крок встановлення daemon, автентифікація за токеном потребує токена, а `gateway.auth.token` керується через SecretRef, configure перевіряє SecretRef, але не зберігає розкриті відкриті значення токенів у метаданих середовища сервісу supervisor.
+- Якщо для автентифікації за токеном потрібен токен, а налаштований SecretRef токена виявляється нерозв’язаним, configure блокує встановлення daemon і надає дієві вказівки щодо виправлення.
+- Якщо налаштовано і `gateway.auth.token`, і `gateway.auth.password`, а `gateway.auth.mode` не задано, configure блокує встановлення daemon, доки режим не буде явно встановлено.

 ## Приклади

@ -77,7 +80,7 @@ openclaw configure --section model --section channels
 openclaw configure --section gateway --section daemon
 ```

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

 - [Довідник CLI](/uk/cli)
 - [Configuration](/uk/gateway/configuration)
--- a/docs/uk/concepts/models.md
+++ b/docs/uk/concepts/models.md
@ -1,20 +1,21 @@
 ---
 read_when:
-    - Додавання або змінення CLI моделей (`models list/set/scan/aliases/fallbacks`)
-    - Зміна поведінки резервних варіантів моделі або UX вибору
+    - Додавання або змінення CLI моделей (models list/set/scan/aliases/fallbacks)
+    - Зміна поведінки резервних варіантів моделей або UX вибору
    - Оновлення перевірок сканування моделей (інструменти/зображення)
 summary: 'CLI моделей: список, встановлення, псевдоніми, резервні варіанти, сканування, стан'
 title: CLI моделей
 x-i18n:
-    generated_at: "2026-04-24T17:24:56Z"
+    generated_at: "2026-04-24T18:58:37Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 5c036097a5093f0ce304fd08b7ae22ccf5102eb6f511a9a2018a8d4712e43648
+    source_hash: be8d474b525f2605a332d1a509dcbbecda0e3f8f705e636ec9379fae1505c233
    source_path: concepts/models.md
    workflow: 15
 ---

-Див. [/concepts/model-failover](/uk/concepts/model-failover) щодо ротації профілів автентифікації, періодів охолодження та того, як це взаємодіє з резервними варіантами.
+Див. [/concepts/model-failover](/uk/concepts/model-failover) щодо ротації профілів авторизації,
+періодів охолодження та того, як це взаємодіє з резервними варіантами.
 Короткий огляд провайдерів + приклади: [/concepts/model-providers](/uk/concepts/model-providers).

 ## Як працює вибір моделі
@ -22,36 +23,37 @@ x-i18n:
 OpenClaw вибирає моделі в такому порядку:

 1. **Основна** модель (`agents.defaults.model.primary` або `agents.defaults.model`).
-2. **Резервні варіанти** у `agents.defaults.model.fallbacks` (по порядку).
-3. **Резервне перемикання автентифікації провайдера** відбувається всередині провайдера перед переходом до наступної моделі.
+2. **Резервні варіанти** в `agents.defaults.model.fallbacks` (по порядку).
+3. **Резервне перемикання авторизації провайдера** відбувається всередині провайдера перед переходом до наступної моделі.

 Пов’язане:

- `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 key цього провайдера.
- `agents.defaults.musicGenerationModel` використовується спільною можливістю генерації музики. Якщо його не вказано, `music_generate` усе одно може визначити типове значення провайдера з підтримкою автентифікації. Спочатку він пробує поточного типового провайдера, а потім решту зареєстрованих провайдерів генерації музики у порядку provider-id. Якщо ви задаєте конкретний провайдер/модель, також налаштуйте автентифікацію/API key цього провайдера.
- `agents.defaults.videoGenerationModel` використовується спільною можливістю генерації відео. Якщо його не вказано, `video_generate` усе одно може визначити типове значення провайдера з підтримкою автентифікації. Спочатку він пробує поточного типового провайдера, а потім решту зареєстрованих провайдерів генерації відео у порядку provider-id. Якщо ви задаєте конкретний провайдер/модель, також налаштуйте автентифікацію/API key цього провайдера.
- Типові значення для окремих агентів можуть перевизначати `agents.defaults.model` через `agents.list[].model` разом із прив’язками (див. [/concepts/multi-agent](/uk/concepts/multi-agent)).
+  використовує `agents.defaults.imageModel`, а потім визначену для сеансу/типову
+  модель.
+- `agents.defaults.imageGenerationModel` використовується спільною можливістю генерації зображень. Якщо його не вказано, `image_generate` усе одно може визначити типове значення провайдера з авторизацією. Спочатку він пробує поточного типового провайдера, потім решту зареєстрованих провайдерів генерації зображень у порядку provider-id. Якщо ви задаєте конкретний provider/model, також налаштуйте авторизацію/API key цього провайдера.
+- `agents.defaults.musicGenerationModel` використовується спільною можливістю генерації музики. Якщо його не вказано, `music_generate` усе одно може визначити типове значення провайдера з авторизацією. Спочатку він пробує поточного типового провайдера, потім решту зареєстрованих провайдерів генерації музики у порядку provider-id. Якщо ви задаєте конкретний provider/model, також налаштуйте авторизацію/API key цього провайдера.
+- `agents.defaults.videoGenerationModel` використовується спільною можливістю генерації відео. Якщо його не вказано, `video_generate` усе одно може визначити типове значення провайдера з авторизацією. Спочатку він пробує поточного типового провайдера, потім решту зареєстрованих провайдерів генерації відео у порядку provider-id. Якщо ви задаєте конкретний provider/model, також налаштуйте авторизацію/API key цього провайдера.
+- Типові значення для окремого агента можуть перевизначати `agents.defaults.model` через `agents.list[].model` разом із прив’язками (див. [/concepts/multi-agent](/uk/concepts/multi-agent)).

-## Коротка політика вибору моделі
+## Коротка політика щодо моделей

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

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

-Якщо ви не хочете редагувати конфігурацію вручну, запустіть онбординг:
+Якщо ви не хочете вручну редагувати конфігурацію, запустіть онбординг:

 ```bash
 openclaw onboard
 ```

-Він може налаштувати модель + автентифікацію для поширених провайдерів, зокрема **OpenAI Code (Codex)
-subscription** (OAuth) та **Anthropic** (API key або Claude CLI).
+Він може налаштувати модель + авторизацію для поширених провайдерів, зокрема **OpenAI Code (Codex)
+subscription** (OAuth) і **Anthropic** (API key або Claude CLI).

 ## Ключі конфігурації (огляд)

@ -63,33 +65,37 @@ subscription** (OAuth) та **Anthropic** (API key або Claude CLI).
 - `agents.defaults.models` (allowlist + псевдоніми + параметри провайдера)
 - `models.providers` (користувацькі провайдери, записані в `models.json`)

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

-Приклади конфігурації провайдерів (зокрема OpenCode) наведені в
+Приклади конфігурації провайдерів (зокрема OpenCode) наведено в
 [/providers/opencode](/uk/providers/opencode).

 ### Безпечне редагування allowlist

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

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

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

-## "Model is not allowed" (і чому відповіді зупиняються)
+## «Model is not allowed» (і чому відповіді припиняються)

-Якщо задано `agents.defaults.models`, він стає **allowlist** для `/model` і для
+Якщо встановлено `agents.defaults.models`, він стає **allowlist** для `/model` і для
 перевизначень сеансу. Коли користувач вибирає модель, якої немає в цьому allowlist,
 OpenClaw повертає:

@ -97,12 +103,12 @@ OpenClaw повертає:
 Model "provider/model" is not allowed. Use /model to list available models.
 ```

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

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

 Приклад конфігурації allowlist:

@ -132,26 +138,26 @@ Model "provider/model" is not allowed. Use /model to list available models.

 Примітки:

- `/model` (і `/model list`) — це компактний нумерований вибірник (сімейство моделей + доступні провайдери).
- У Discord `/model` і `/models` відкривають інтерактивний вибірник із випадними списками провайдера та моделі, а також кроком Submit.
- `/models add` застарів і тепер повертає повідомлення про застарілість замість реєстрації моделей із чату.
- `/model <#>` вибирає зі списку цього вибірника.
- `/model` негайно зберігає новий вибір сеансу.
- Якщо агент неактивний, наступний запуск одразу використає нову модель.
- Якщо запуск уже активний, OpenClaw позначає перемикання в реальному часі як очікуване та перезапускається з новою моделлю лише в чистій точці повторної спроби.
- Якщо активність інструмента або виведення відповіді вже почалися, очікуване перемикання може залишатися в черзі до пізнішої можливості повторної спроби або до наступного ходу користувача.
- `/model status` — це докладне подання (кандидати автентифікації та, якщо налаштовано, `baseUrl` кінцевої точки провайдера + режим `api`).
- Посилання на модель розбираються за **першим** `/`. Під час введення `/model <ref>` використовуйте `provider/model`.
- Якщо сам ID моделі містить `/` (у стилі OpenRouter), ви маєте включити префікс провайдера (приклад: `/model openrouter/moonshotai/kimi-k2`).
+- `/model` (і `/model list`) — це компактний нумерований засіб вибору (сімейство моделей + доступні провайдери).
+- У Discord `/model` і `/models` відкривають інтерактивний засіб вибору з випадними списками провайдера та моделі, а також кроком Submit.
+- `/models add` застаріла команда і тепер повертає повідомлення про застарілість замість реєстрації моделей із чату.
+- `/model <#>` вибирає зі згаданого засобу вибору.
+- `/model` одразу зберігає новий вибір сеансу.
+- Якщо агент неактивний, наступний запуск одразу використовує нову модель.
+- Якщо запуск уже активний, OpenClaw позначає живе перемикання як очікуване і перезапускається на новій моделі лише в чистій точці повторної спроби.
+- Якщо активність інструментів або виведення відповіді вже почалися, очікуване перемикання може залишатися в черзі до пізнішої можливості повторної спроби або до наступного ходу користувача.
+- `/model status` — це детальний перегляд (кандидати авторизації та, коли налаштовано, `baseUrl` кінцевої точки провайдера + режим `api`).
+- Посилання на моделі аналізуються розділенням за **першим** `/`. Під час введення `/model <ref>` використовуйте `provider/model`.
+- Якщо сам ID моделі містить `/` (у стилі OpenRouter), ви маєте вказати префікс провайдера (приклад: `/model openrouter/moonshotai/kimi-k2`).
 - Якщо ви пропускаєте провайдера, OpenClaw визначає введення в такому порядку:
  1. збіг псевдоніма
  2. унікальний збіг налаштованого провайдера для цього точного ID моделі без префікса
  3. застарілий резервний перехід до налаштованого типового провайдера
     Якщо цей провайдер більше не надає налаштовану типову модель, OpenClaw
-     натомість переходить до першого налаштованого провайдера/моделі, щоб уникнути
-     показу застарілого типового значення від видаленого провайдера.
+     натомість переходить до першої налаштованої пари провайдер/модель, щоб
+     не показувати застаріле типове значення від видаленого провайдера.

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

 ## Команди CLI

@ -184,32 +190,34 @@ openclaw models image-fallbacks clear

 - `--all`: повний каталог
 - `--local`: лише локальні провайдери
- `--provider <id>`: фільтр за id провайдера, наприклад `moonshot`; мітки відображення з інтерактивних вибірників не приймаються
+- `--provider <id>`: фільтр за id провайдера, наприклад `moonshot`; мітки відображення з інтерактивних засобів вибору не приймаються
 - `--plain`: одна модель на рядок
- `--json`: машинозчитуваний вивід
+- `--json`: машиночитаний вивід

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

 ### `models status`

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

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

 Приклад (Claude CLI):

@ -218,23 +226,23 @@ claude auth login
 openclaw models status
 ```

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

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

 Основні прапорці:

 - `--no-probe`: пропустити живі probe (лише метадані)
- `--min-params <b>`: мінімальний розмір параметрів (у мільярдах)
+- `--min-params <b>`: мінімальний розмір параметрів (мільярди)
 - `--max-age-days <days>`: пропустити старіші моделі
 - `--provider <name>`: фільтр за префіксом провайдера
 - `--max-candidates <n>`: розмір списку резервних варіантів
- `--set-default`: встановити `agents.defaults.model.primary` на перший вибір
- `--set-image`: встановити `agents.defaults.imageModel.primary` на перший вибір зображень
+- `--set-default`: встановити `agents.defaults.model.primary` на перший вибраний варіант
+- `--set-image`: встановити `agents.defaults.imageModel.primary` на перший вибраний варіант для зображень

-Для probe потрібен API key OpenRouter (із профілів автентифікації або
-`OPENROUTER_API_KEY`). Без ключа використовуйте `--no-probe`, щоб лише перелічити кандидатів.
+Для probe потрібен API key OpenRouter (з профілів авторизації або
+`OPENROUTER_API_KEY`). Без ключа використовуйте `--no-probe`, щоб лише переглянути кандидатів.

 Результати сканування ранжуються за:

@ -246,36 +254,36 @@ openclaw models status
 Вхідні дані

 - Список OpenRouter `/models` (фільтр `:free`)
- Потрібен API key OpenRouter із профілів автентифікації або `OPENROUTER_API_KEY` (див. [/environment](/uk/help/environment))
+- Потрібен API key OpenRouter із профілів авторизації або `OPENROUTER_API_KEY` (див. [/environment](/uk/help/environment))
 - Необов’язкові фільтри: `--max-age-days`, `--min-params`, `--provider`, `--max-candidates`
- Елементи керування probe: `--timeout`, `--concurrency`
+- Керування probe: `--timeout`, `--concurrency`

 Під час запуску в TTY ви можете інтерактивно вибрати резервні варіанти. У неінтерактивному
 режимі передайте `--yes`, щоб прийняти типові значення.

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

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

-Пріоритет режиму merge для відповідних ID провайдерів:
+Пріоритет у режимі merge для однакових ID провайдерів:

- Непорожній `baseUrl`, уже наявний у `models.json` агента, має пріоритет.
- Непорожній `apiKey` у `models.json` агента має пріоритет лише тоді, коли цей провайдер не керується через SecretRef у поточному контексті config/auth-profile.
- Значення `apiKey` провайдера, якими керує SecretRef, оновлюються з маркерів джерела (`ENV_VAR_NAME` для посилань env, `secretref-managed` для посилань file/exec) замість збереження розгорнутих секретів.
- Значення заголовків провайдера, якими керує SecretRef, оновлюються з маркерів джерела (`secretref-env:ENV_VAR_NAME` для посилань env, `secretref-managed` для посилань file/exec).
- Порожні або відсутні `apiKey`/`baseUrl` агента переходять до config `models.providers`.
+- Непорожній `baseUrl`, уже наявний в агентському `models.json`, має пріоритет.
+- Непорожній `apiKey` в агентському `models.json` має пріоритет лише тоді, коли цей провайдер не керується через SecretRef у поточному контексті config/auth-profile.
+- Значення `apiKey` для провайдерів, керованих через SecretRef, оновлюються з маркерів джерела (`ENV_VAR_NAME` для env-посилань, `secretref-managed` для file/exec-посилань) замість збереження визначених секретів.
+- Значення заголовків провайдера, керованих через SecretRef, оновлюються з маркерів джерела (`secretref-env:ENV_VAR_NAME` для env-посилань, `secretref-managed` для file/exec-посилань).
+- Порожні або відсутні агентські `apiKey`/`baseUrl` беруться з config `models.providers`.
 - Інші поля провайдера оновлюються з config і нормалізованих даних каталогу.

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

 ## Пов’язане

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