chore(i18n): refresh uk translations

2026-04-25 00:32:46 +00:00 · 2026-04-25 00:32:46 +00:00 · 7571582bfc
commit 7571582bfc
parent d88c638e73
3 changed files with 400 additions and 403 deletions
--- a/docs/uk/concepts/model-providers.md
+++ b/docs/uk/concepts/model-providers.md
@ -1,84 +1,82 @@
 ---
 read_when:
-    - Вам потрібен довідник із налаштування моделей для кожного постачальника окремо
-    - Ви хочете приклади конфігурацій або команд онбордингу CLI для постачальників моделей
-summary: Огляд постачальників моделей із прикладами конфігурацій + потоками CLI
+    - Вам потрібен довідник з налаштування моделей для кожного постачальника окремо
+    - Вам потрібні приклади конфігурацій або команди онбордингу CLI для постачальників моделей
+summary: Огляд постачальника моделей з прикладами конфігурацій + потоками CLI
 title: Постачальники моделей
 x-i18n:
-    generated_at: "2026-04-25T00:01:08Z"
+    generated_at: "2026-04-25T00:30:49Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 1c02aff44b00748bdcb5e4dc02c1725ae4c5d4b9fe3a9da523053a7e95a03f16
+    source_hash: 009d57c8e26971357592f6fd57ad03f98f0325c410011649f002531ecb99aa06
    source_path: concepts/model-providers.md
    workflow: 15
 ---

-Ця сторінка охоплює **постачальників LLM/моделей** (а не канали чату, як-от WhatsApp/Telegram).
-Правила вибору моделей див. у [/concepts/models](/uk/concepts/models).
+Ця сторінка охоплює **постачальників LLM/моделей** (а не канали чату на кшталт WhatsApp/Telegram).
+Щоб дізнатися про правила вибору моделей, дивіться [/concepts/models](/uk/concepts/models).

 ## Швидкі правила

 - Посилання на моделі використовують `provider/model` (приклад: `opencode/claude-opus-4-6`).
 - `agents.defaults.models` працює як список дозволених значень, якщо його задано.
- Допоміжні CLI-команди: `openclaw onboard`, `openclaw models list`, `openclaw models set <provider/model>`.
- `models.providers.*.models[].contextWindow` — це вбудовані метадані моделі; `contextTokens` — це фактичне обмеження під час виконання.
- Правила резервного перемикання, cooldown-перевірки та збереження перевизначень сеансу див. у [Model failover](/uk/concepts/model-failover).
- Маршрути сімейства OpenAI залежать від префікса: `openai/<model>` використовує прямого постачальника API-ключа OpenAI у PI, `openai-codex/<model>` використовує Codex OAuth у PI, а `openai/<model>` разом із `agents.defaults.embeddedHarness.runtime: "codex"` використовує нативний harness сервера застосунку Codex. Див. [OpenAI](/uk/providers/openai) і [Codex harness](/uk/plugins/codex-harness).
- Автоматичне ввімкнення Plugin дотримується тієї ж межі: `openai-codex/<model>` належить Plugin OpenAI, тоді як Plugin Codex вмикається через `embeddedHarness.runtime: "codex"` або застарілі посилання `codex/<model>`.
- CLI-середовища виконання використовують той самий поділ: вибирайте канонічні посилання на моделі, як-от `anthropic/claude-*`, `google/gemini-*` або `openai/gpt-*`, а потім задавайте `agents.defaults.embeddedHarness.runtime` як `claude-cli`, `google-gemini-cli` або `codex-cli`, якщо хочете локальний бекенд CLI.
-  Застарілі посилання `claude-cli/*`, `google-gemini-cli/*` і `codex-cli/*` мігрують назад до канонічних посилань постачальників, а середовище виконання записується окремо.
- GPT-5.5 наразі доступна через маршрути підписки/OAuth:
-  `openai-codex/gpt-5.5` у PI або `openai/gpt-5.5` із harness сервера застосунку Codex. Прямий маршрут API-ключа для `openai/gpt-5.5` підтримуватиметься, щойно OpenAI увімкне GPT-5.5 у публічному API; до того часу використовуйте моделі з доступом через API, наприклад `openai/gpt-5.4`, для налаштувань `OPENAI_API_KEY`.
+- Допоміжні команди CLI: `openclaw onboard`, `openclaw models list`, `openclaw models set <provider/model>`.
+- `models.providers.*.models[].contextWindow` — це власні метадані моделі; `contextTokens` — це фактичне обмеження під час виконання.
+- Правила резервного перемикання, перевірки в період охолодження та збереження перевизначень сесії: [Перемикання моделей при збої](/uk/concepts/model-failover).
+- Маршрути сімейства OpenAI залежать від префікса: `openai/<model>` використовує постачальника з прямим API-ключем OpenAI у PI, `openai-codex/<model>` використовує OAuth Codex у PI, а `openai/<model>` разом із `agents.defaults.embeddedHarness.runtime: "codex"` використовує нативний app-server harness Codex. Дивіться [OpenAI](/uk/providers/openai) і [Codex harness](/uk/plugins/codex-harness).
+- Автоматичне ввімкнення Plugin дотримується цієї ж межі: `openai-codex/<model>` належить Plugin OpenAI, тоді як Plugin Codex вмикається через `embeddedHarness.runtime: "codex"` або застарілі посилання `codex/<model>`.
+- Середовища виконання CLI використовують той самий поділ: вибирайте канонічні посилання на моделі, такі як `anthropic/claude-*`, `google/gemini-*` або `openai/gpt-*`, а потім задавайте `agents.defaults.embeddedHarness.runtime` як `claude-cli`, `google-gemini-cli` або `codex-cli`, якщо потрібен локальний бекенд CLI. Застарілі посилання `claude-cli/*`, `google-gemini-cli/*` і `codex-cli/*` мігрують назад до канонічних посилань постачальника, а середовище виконання записується окремо.
+- GPT-5.5 наразі доступна через маршрути підписки/OAuth: `openai-codex/gpt-5.5` у PI або `openai/gpt-5.5` з harness app-server Codex. Прямий маршрут з API-ключем для `openai/gpt-5.5` підтримуватиметься, щойно OpenAI увімкне GPT-5.5 у публічному API; до того часу для налаштувань `OPENAI_API_KEY` використовуйте моделі, доступні через API, наприклад `openai/gpt-5.4`.

-## Поведінка постачальника, що належить Plugin
+## Поведінка постачальника, якою володіє Plugin

-Більшість специфічної для постачальника логіки живе в Plugin постачальників (`registerProvider(...)`), тоді як OpenClaw зберігає загальний цикл inference. Plugins відповідають за онбординг, каталоги моделей, зіставлення auth env-var, нормалізацію транспорту/конфігурації, очищення схем інструментів, класифікацію failover, оновлення OAuth, звітування про використання, профілі thinking/reasoning тощо.
+Більшість логіки, специфічної для постачальника, живе в Plugin постачальників (`registerProvider(...)`), тоді як OpenClaw зберігає загальний цикл інференсу. Plugins відповідають за онбординг, каталоги моделей, зіставлення env vars для автентифікації, нормалізацію транспорту/конфігурації, очищення схем інструментів, класифікацію резервного перемикання при збої, оновлення OAuth, звітність про використання, профілі thinking/reasoning тощо.

-Повний список хуків SDK постачальників і прикладів вбудованих Plugin наведено в [Provider plugins](/uk/plugins/sdk-provider-plugins). Постачальник, якому потрібен повністю кастомний виконавець запитів, — це окрема, глибша поверхня розширення.
+Повний список хуків SDK постачальників і прикладів вбудованих Plugins наведено в [Provider plugins](/uk/plugins/sdk-provider-plugins). Постачальник, якому потрібен повністю кастомний виконавець запитів, — це окрема, глибша поверхня розширення.

 <Note>
-`capabilities` середовища виконання постачальника — це спільні метадані раннера (сімейство постачальника, особливості transcript/tooling, підказки щодо transport/cache). Це не те саме, що [public capability model](/uk/plugins/architecture#public-capability-model), яка описує, що реєструє Plugin (текстовий inference, мовлення тощо).
+`capabilities` середовища виконання постачальника — це спільні метадані раннера (сімейство постачальника, особливості транскриптів/інструментів, підказки щодо транспорту/кешу). Це не те саме, що [публічна модель можливостей](/uk/plugins/architecture#public-capability-model), яка описує, що реєструє Plugin (текстовий інференс, мовлення тощо).
 </Note>

 ## Ротація API-ключів

- Підтримує загальну ротацію постачальників для вибраних постачальників.
+- Підтримується загальна ротація ключів постачальника для вибраних постачальників.
 - Налаштуйте кілька ключів через:
  - `OPENCLAW_LIVE_<PROVIDER>_KEY` (одне live-перевизначення, найвищий пріоритет)
  - `<PROVIDER>_API_KEYS` (список через кому або крапку з комою)
  - `<PROVIDER>_API_KEY` (основний ключ)
  - `<PROVIDER>_API_KEY_*` (нумерований список, наприклад `<PROVIDER>_API_KEY_1`)
- Для постачальників Google `GOOGLE_API_KEY` також включається як резервний варіант.
+- Для постачальників Google як резервний варіант також використовується `GOOGLE_API_KEY`.
 - Порядок вибору ключів зберігає пріоритет і прибирає дублікати значень.
- Запити повторюються з наступним ключем лише у відповідь на повідомлення про обмеження швидкості (наприклад `429`, `rate_limit`, `quota`, `resource exhausted`, `Too many
+- Запити повторюються з наступним ключем лише у відповідь на обмеження швидкості (наприклад, `429`, `rate_limit`, `quota`, `resource exhausted`, `Too many
 concurrent requests`, `ThrottlingException`, `concurrency limit reached`,
-  `workers_ai ... quota limit exceeded` або періодичні повідомлення про ліміт використання).
- Помилки, не пов’язані з обмеженням швидкості, одразу завершуються з помилкою; ротація ключів не виконується.
- Якщо всі можливі ключі завершуються помилкою, повертається фінальна помилка з останньої спроби.
+  `workers_ai ... quota limit exceeded` або періодичні повідомлення про ліміти використання).
+- Помилки, не пов’язані з обмеженням швидкості, одразу завершуються збоєм; ротація ключів не виконується.
+- Якщо всі доступні ключі завершуються збоєм, повертається фінальна помилка з останньої спроби.

 ## Вбудовані постачальники (каталог pi-ai)

-OpenClaw постачається з каталогом pi‑ai. Ці постачальники **не**
-потребують конфігурації `models.providers`; достатньо налаштувати auth і вибрати модель.
+OpenClaw постачається з каталогом pi‑ai. Для цих постачальників **не потрібна**
+конфігурація `models.providers`; просто задайте автентифікацію та виберіть модель.

 ### OpenAI

 - Постачальник: `openai`
- Auth: `OPENAI_API_KEY`
+- Автентифікація: `OPENAI_API_KEY`
 - Необов’язкова ротація: `OPENAI_API_KEYS`, `OPENAI_API_KEY_1`, `OPENAI_API_KEY_2`, а також `OPENCLAW_LIVE_OPENAI_KEY` (одне перевизначення)
 - Приклади моделей: `openai/gpt-5.4`, `openai/gpt-5.4-mini`
- Пряма підтримка API для GPT-5.5 тут підготовлена на майбутнє, щойно OpenAI відкриє GPT-5.5 в API
+- Пряма підтримка API для GPT-5.5 тут готова на майбутнє, щойно OpenAI відкриє GPT-5.5 у API
 - CLI: `openclaw onboard --auth-choice openai-api-key`
- Типовий transport — `auto` (спочатку WebSocket, резервно SSE)
+- Транспорт за замовчуванням — `auto` (спочатку WebSocket, резервно SSE)
 - Перевизначення для окремої моделі через `agents.defaults.models["openai/<model>"].params.transport` (`"sse"`, `"websocket"` або `"auto"`)
- Розігрів OpenAI Responses WebSocket типово ввімкнений через `params.openaiWsWarmup` (`true`/`false`)
+- Прогрівання WebSocket OpenAI Responses за замовчуванням увімкнене через `params.openaiWsWarmup` (`true`/`false`)
 - Пріоритетну обробку OpenAI можна ввімкнути через `agents.defaults.models["openai/<model>"].params.serviceTier`
- `/fast` і `params.fastMode` напряму зіставляють запити `openai/*` Responses із `service_tier=priority` на `api.openai.com`
+- `/fast` і `params.fastMode` напряму зіставляють запити Responses `openai/*` з `service_tier=priority` на `api.openai.com`
 - Використовуйте `params.serviceTier`, якщо вам потрібен явний рівень замість спільного перемикача `/fast`
 - Приховані заголовки атрибуції OpenClaw (`originator`, `version`,
-  `User-Agent`) застосовуються лише до нативного трафіку OpenAI на `api.openai.com`, а не до загальних OpenAI-сумісних проксі
- Нативні маршрути OpenAI також зберігають Responses `store`, підказки кешу prompt і формування payload для сумісності reasoning OpenAI; проксі-маршрути цього не роблять
- `openai/gpt-5.3-codex-spark` навмисно приглушено в OpenClaw, оскільки live-запити OpenAI API його відхиляють, а поточний каталог Codex його не надає
+  `User-Agent`) застосовуються лише до нативного трафіку OpenAI на `api.openai.com`, а не до загальних проксі, сумісних з OpenAI
+- Нативні маршрути OpenAI також зберігають `store` Responses, підказки кешу prompt і формування payload для сумісності reasoning OpenAI; проксі-маршрути цього не роблять
+- `openai/gpt-5.3-codex-spark` навмисно приховано в OpenClaw, оскільки live-запити до OpenAI API його відхиляють, а поточний каталог Codex його не показує

 ```json5
 {
@ -89,13 +87,13 @@ OpenClaw постачається з каталогом pi‑ai. Ці поста
 ### Anthropic

 - Постачальник: `anthropic`
- Auth: `ANTHROPIC_API_KEY`
+- Автентифікація: `ANTHROPIC_API_KEY`
 - Необов’язкова ротація: `ANTHROPIC_API_KEYS`, `ANTHROPIC_API_KEY_1`, `ANTHROPIC_API_KEY_2`, а також `OPENCLAW_LIVE_ANTHROPIC_KEY` (одне перевизначення)
 - Приклад моделі: `anthropic/claude-opus-4-6`
 - CLI: `openclaw onboard --auth-choice apiKey`
- Прямі публічні запити Anthropic підтримують спільний перемикач `/fast` і `params.fastMode`, включно з трафіком з API-ключем і OAuth-автентифікацією, надісланим на `api.anthropic.com`; OpenClaw зіставляє це з Anthropic `service_tier` (`auto` проти `standard_only`)
+- Прямі публічні запити Anthropic також підтримують спільний перемикач `/fast` і `params.fastMode`, включно з трафіком, автентифікованим через API-ключ і OAuth, що надсилається на `api.anthropic.com`; OpenClaw зіставляє це з Anthropic `service_tier` (`auto` або `standard_only`)
 - Примітка щодо Anthropic: співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволене, тому OpenClaw вважає повторне використання Claude CLI і використання `claude -p` санкціонованими для цієї інтеграції, якщо Anthropic не опублікує нову політику.
- Setup-token Anthropic залишається доступним як підтримуваний шлях токена OpenClaw, але тепер OpenClaw надає перевагу повторному використанню Claude CLI та `claude -p`, коли вони доступні.
+- Токен налаштування Anthropic як і раніше доступний як підтримуваний шлях токена OpenClaw, але тепер OpenClaw надає перевагу повторному використанню Claude CLI та `claude -p`, якщо це можливо.

 ```json5
 {
@ -103,24 +101,24 @@ OpenClaw постачається з каталогом pi‑ai. Ці поста
 }
 ```

-### OpenAI Codex OAuth
+### OAuth OpenAI Codex

 - Постачальник: `openai-codex`
- Auth: OAuth (ChatGPT)
+- Автентифікація: OAuth (ChatGPT)
 - Посилання на модель PI: `openai-codex/gpt-5.5`
- Посилання на нативний harness сервера застосунку Codex: `openai/gpt-5.5` з `agents.defaults.embeddedHarness.runtime: "codex"`
+- Посилання нативного harness app-server Codex: `openai/gpt-5.5` з `agents.defaults.embeddedHarness.runtime: "codex"`
 - Застарілі посилання на моделі: `codex/gpt-*`
- Межа Plugin: `openai-codex/*` завантажує Plugin OpenAI; нативний Plugin сервера застосунку Codex вибирається лише через середовище виконання harness Codex або застарілі посилання `codex/*`.
+- Межа Plugin: `openai-codex/*` завантажує Plugin OpenAI; нативний Plugin app-server Codex вибирається лише через середовище виконання harness Codex або застарілі посилання `codex/*`.
 - CLI: `openclaw onboard --auth-choice openai-codex` або `openclaw models auth login --provider openai-codex`
- Типовий transport — `auto` (спочатку WebSocket, резервно SSE)
+- Транспорт за замовчуванням — `auto` (спочатку WebSocket, резервно SSE)
 - Перевизначення для окремої моделі PI через `agents.defaults.models["openai-codex/<model>"].params.transport` (`"sse"`, `"websocket"` або `"auto"`)
- `params.serviceTier` також пересилається в нативних запитах Codex Responses (`chatgpt.com/backend-api`)
+- `params.serviceTier` також передається в нативних запитах Codex Responses (`chatgpt.com/backend-api`)
 - Приховані заголовки атрибуції OpenClaw (`originator`, `version`,
  `User-Agent`) додаються лише до нативного трафіку Codex на
-  `chatgpt.com/backend-api`, а не до загальних OpenAI-сумісних проксі
- Використовує той самий перемикач `/fast` і конфігурацію `params.fastMode`, що й прямий `openai/*`; OpenClaw зіставляє це з `service_tier=priority`
- `openai-codex/gpt-5.5` зберігає нативні `contextWindow = 1000000` і типове runtime-значення `contextTokens = 272000`; перевизначте runtime-обмеження через `models.providers.openai-codex.models[].contextTokens`
- Примітка щодо політики: OpenAI Codex OAuth явно підтримується для зовнішніх інструментів/робочих процесів, таких як OpenClaw.
+  `chatgpt.com/backend-api`, а не до загальних проксі, сумісних з OpenAI
+- Має той самий перемикач `/fast` і конфігурацію `params.fastMode`, що й прямий `openai/*`; OpenClaw зіставляє це з `service_tier=priority`
+- `openai-codex/gpt-5.5` зберігає нативне `contextWindow = 1000000` і стандартне робоче `contextTokens = 272000`; перевизначте робоче обмеження через `models.providers.openai-codex.models[].contextTokens`
+- Примітка щодо політики: OAuth OpenAI Codex явно підтримується для зовнішніх інструментів/процесів на кшталт OpenClaw.
 - Поточний доступ до GPT-5.5 використовує цей маршрут OAuth/підписки, доки OpenAI не ввімкне GPT-5.5 у публічному API.

 ```json5
@ -141,15 +139,15 @@ OpenClaw постачається з каталогом pi‑ai. Ці поста
 }
 ```

-### Інші хостовані варіанти у стилі підписки
+### Інші розміщені варіанти у стилі підписки

 - [Qwen Cloud](/uk/providers/qwen): поверхня постачальника Qwen Cloud, а також зіставлення кінцевих точок Alibaba DashScope і Coding Plan
- [MiniMax](/uk/providers/minimax): доступ до MiniMax Coding Plan через OAuth або API-ключ
+- [MiniMax](/uk/providers/minimax): доступ через OAuth або API-ключ MiniMax Coding Plan
 - [GLM Models](/uk/providers/glm): кінцеві точки Z.AI Coding Plan або загального API

 ### OpenCode

- Auth: `OPENCODE_API_KEY` (або `OPENCODE_ZEN_API_KEY`)
+- Автентифікація: `OPENCODE_API_KEY` (або `OPENCODE_ZEN_API_KEY`)
 - Постачальник середовища виконання Zen: `opencode`
 - Постачальник середовища виконання Go: `opencode-go`
 - Приклади моделей: `opencode/claude-opus-4-6`, `opencode-go/kimi-k2.5`
@ -164,44 +162,46 @@ OpenClaw постачається з каталогом pi‑ai. Ці поста
 ### Google Gemini (API-ключ)

 - Постачальник: `google`
- Auth: `GEMINI_API_KEY`
- Необов’язкова ротація: `GEMINI_API_KEYS`, `GEMINI_API_KEY_1`, `GEMINI_API_KEY_2`, резервний `GOOGLE_API_KEY` і `OPENCLAW_LIVE_GEMINI_KEY` (одне live-перевизначення)
+- Автентифікація: `GEMINI_API_KEY`
+- Необов’язкова ротація: `GEMINI_API_KEYS`, `GEMINI_API_KEY_1`, `GEMINI_API_KEY_2`, резервний варіант `GOOGLE_API_KEY` і `OPENCLAW_LIVE_GEMINI_KEY` (одне перевизначення)
 - Приклади моделей: `google/gemini-3.1-pro-preview`, `google/gemini-3-flash-preview`
- Сумісність: застаріла конфігурація OpenClaw із `google/gemini-3.1-flash-preview` нормалізується до `google/gemini-3-flash-preview`
+- Сумісність: застаріла конфігурація OpenClaw з `google/gemini-3.1-flash-preview` нормалізується до `google/gemini-3-flash-preview`
 - CLI: `openclaw onboard --auth-choice gemini-api-key`
 - Прямі запуски Gemini також приймають `agents.defaults.models["google/<model>"].params.cachedContent`
-  (або застаріле `cached_content`) для пересилання нативного
-  дескриптора постачальника `cachedContents/...`; попадання в кеш Gemini відображаються як OpenClaw `cacheRead`
+  (або застаріле `cached_content`) для передачі нативного дескриптора постачальника
+  `cachedContents/...`; влучання в кеш Gemini відображаються в OpenClaw як `cacheRead`

 ### Google Vertex і Gemini CLI

 - Постачальники: `google-vertex`, `google-gemini-cli`
- Auth: Vertex використовує gcloud ADC; Gemini CLI — свій потік OAuth
- Застереження: OAuth Gemini CLI в OpenClaw є неофіційною інтеграцією. Деякі користувачі повідомляли про обмеження облікового запису Google після використання сторонніх клієнтів. Ознайомтеся з умовами Google і використовуйте некритичний обліковий запис, якщо вирішите продовжити.
+- Автентифікація: Vertex використовує gcloud ADC; Gemini CLI використовує власний потік OAuth
+- Застереження: OAuth Gemini CLI в OpenClaw — це неофіційна інтеграція. Деякі користувачі повідомляли про обмеження облікового запису Google після використання сторонніх клієнтів. Ознайомтеся з умовами Google і використовуйте неважливий обліковий запис, якщо вирішите продовжити.
 - OAuth Gemini CLI постачається як частина вбудованого Plugin `google`.
  - Спочатку встановіть Gemini CLI:
    - `brew install gemini-cli`
    - або `npm install -g @google/gemini-cli`
-  - Увімкнення: `openclaw plugins enable google`
-  - Вхід: `openclaw models auth login --provider google-gemini-cli --set-default`
-  - Типова модель: `google-gemini-cli/gemini-3-flash-preview`
-  - Примітка: вам **не потрібно** вставляти client id або secret в `openclaw.json`. Потік входу CLI зберігає токени в auth-профілях на хості gateway.
-  - Якщо після входу запити завершуються помилкою, задайте `GOOGLE_CLOUD_PROJECT` або `GOOGLE_CLOUD_PROJECT_ID` на хості gateway.
-  - JSON-відповіді Gemini CLI розбираються з `response`; використання резервно береться зі `stats`, а `stats.cached` нормалізується до OpenClaw `cacheRead`.
+  - Увімкніть: `openclaw plugins enable google`
+  - Увійдіть: `openclaw models auth login --provider google-gemini-cli --set-default`
+  - Модель за замовчуванням: `google-gemini-cli/gemini-3-flash-preview`
+  - Примітка: ви **не** вставляєте client id або secret в `openclaw.json`. Потік входу CLI зберігає
+    токени в профілях автентифікації на хості Gateway.
+  - Якщо після входу запити завершуються збоєм, задайте `GOOGLE_CLOUD_PROJECT` або `GOOGLE_CLOUD_PROJECT_ID` на хості Gateway.
+  - JSON-відповіді Gemini CLI розбираються з `response`; використання резервно береться з
+    `stats`, а `stats.cached` нормалізується в OpenClaw як `cacheRead`.

 ### Z.AI (GLM)

 - Постачальник: `zai`
- Auth: `ZAI_API_KEY`
+- Автентифікація: `ZAI_API_KEY`
 - Приклад моделі: `zai/glm-5.1`
 - CLI: `openclaw onboard --auth-choice zai-api-key`
-  - Аліаси: `z.ai/*` і `z-ai/*` нормалізуються до `zai/*`
-  - `zai-api-key` автоматично визначає відповідну кінцеву точку Z.AI; `zai-coding-global`, `zai-coding-cn`, `zai-global` і `zai-cn` примусово вибирають конкретну поверхню
+  - Псевдоніми: `z.ai/*` і `z-ai/*` нормалізуються до `zai/*`
+  - `zai-api-key` автоматично визначає відповідну кінцеву точку Z.AI; `zai-coding-global`, `zai-coding-cn`, `zai-global` і `zai-cn` примусово задають конкретну поверхню

 ### Vercel AI Gateway

 - Постачальник: `vercel-ai-gateway`
- Auth: `AI_GATEWAY_API_KEY`
+- Автентифікація: `AI_GATEWAY_API_KEY`
 - Приклади моделей: `vercel-ai-gateway/anthropic/claude-opus-4.6`,
  `vercel-ai-gateway/moonshotai/kimi-k2.6`
 - CLI: `openclaw onboard --auth-choice ai-gateway-api-key`
@ -209,19 +209,19 @@ OpenClaw постачається з каталогом pi‑ai. Ці поста
 ### Kilo Gateway

 - Постачальник: `kilocode`
- Auth: `KILOCODE_API_KEY`
+- Автентифікація: `KILOCODE_API_KEY`
 - Приклад моделі: `kilocode/kilo/auto`
 - CLI: `openclaw onboard --auth-choice kilocode-api-key`
 - Базовий URL: `https://api.kilo.ai/api/gateway/`
 - Статичний резервний каталог постачається з `kilocode/kilo/auto`; live-виявлення через
  `https://api.kilo.ai/api/gateway/models` може додатково розширити каталог
  середовища виконання.
- Точна маршрутизація вгору за потоком для `kilocode/kilo/auto` належить Kilo Gateway,
+- Точна висхідна маршрутизація за `kilocode/kilo/auto` визначається Kilo Gateway,
  а не жорстко закодована в OpenClaw.

-Деталі налаштування див. у [/providers/kilocode](/uk/providers/kilocode).
+Дивіться [/providers/kilocode](/uk/providers/kilocode) для деталей налаштування.

-### Інші вбудовані Plugin постачальників
+### Інші вбудовані Plugins постачальників

 | Постачальник            | Id                               | Auth env                                                     | Приклад моделі                                 |
 | ----------------------- | -------------------------------- | ------------------------------------------------------------ | ---------------------------------------------- |
@ -249,35 +249,35 @@ OpenClaw постачається з каталогом pi‑ai. Ці поста
 | xAI                     | `xai`                            | `XAI_API_KEY`                                                | `xai/grok-4`                                   |
 | Xiaomi                  | `xiaomi`                         | `XIAOMI_API_KEY`                                             | `xiaomi/mimo-v2-flash`                         |

-Варто знати такі особливості:
+Корисні особливості, які варто знати:

- **OpenRouter** застосовує свої заголовки атрибуції застосунку та маркери Anthropic `cache_control` лише на перевірених маршрутах `openrouter.ai`. Як проксі-подібний OpenAI-сумісний шлях, він пропускає формування, доступне лише для нативного OpenAI (`serviceTier`, Responses `store`, підказки кешу prompt, сумісність reasoning OpenAI). Посилання з бекендом Gemini зберігають лише санітизацію thought-signature для проксі-Gemini.
- **Kilo Gateway** для посилань із бекендом Gemini дотримується того самого шляху санітизації проксі-Gemini; `kilocode/kilo/auto` та інші посилання, що не підтримують proxy reasoning, пропускають ін’єкцію proxy reasoning.
- **MiniMax** онбординг через API-ключ записує явні визначення моделей M2.7 з `input: ["text", "image"]`; вбудований каталог зберігає chat-посилання лише текстовими, доки ця конфігурація не буде матеріалізована.
- **xAI** використовує шлях xAI Responses. `/fast` або `params.fastMode: true` переписує `grok-3`, `grok-3-mini`, `grok-4` і `grok-4-0709` на їхні варіанти `*-fast`. `tool_stream` типово ввімкнено; вимкнення через `agents.defaults.models["xai/<model>"].params.tool_stream=false`.
- **Cerebras** моделі GLM використовують `zai-glm-4.7` / `zai-glm-4.6`; OpenAI-сумісний базовий URL — `https://api.cerebras.ai/v1`.
+- **OpenRouter** застосовує свої заголовки атрибуції застосунку та маркери Anthropic `cache_control` лише на перевірених маршрутах `openrouter.ai`. Як проксі-шлях у стилі OpenAI, сумісний з OpenAI, він пропускає формування, притаманне лише нативному OpenAI (`serviceTier`, Responses `store`, підказки кешу prompt, сумісність reasoning OpenAI). Посилання, що працюють через Gemini, зберігають лише очищення thought-signature для проксі-Gemini.
+- **Kilo Gateway** для посилань, що працюють через Gemini, дотримується того самого шляху очищення проксі-Gemini; `kilocode/kilo/auto` та інші посилання, де проксі-reasoning не підтримується, пропускають інʼєкцію proxy reasoning.
+- **MiniMax** під час онбордингу через API-ключ записує явні визначення чат-моделей лише для тексту M2.7; розуміння зображень залишається на медіа-постачальнику `MiniMax-VL-01`, яким володіє Plugin.
+- **xAI** використовує шлях xAI Responses. `/fast` або `params.fastMode: true` переписує `grok-3`, `grok-3-mini`, `grok-4` і `grok-4-0709` на їхні варіанти `*-fast`. `tool_stream` увімкнено за замовчуванням; вимкніть через `agents.defaults.models["xai/<model>"].params.tool_stream=false`.
+- **Cerebras** моделі GLM використовують `zai-glm-4.7` / `zai-glm-4.6`; базовий URL, сумісний з OpenAI, — `https://api.cerebras.ai/v1`.

-## Постачальники через `models.providers` (власний/base URL)
+## Постачальники через `models.providers` (custom/base URL)

-Використовуйте `models.providers` (або `models.json`), щоб додати **власних** постачальників або
-OpenAI/Anthropic‑сумісні проксі.
+Використовуйте `models.providers` (або `models.json`), щоб додавати **custom** постачальників або
+проксі, сумісні з OpenAI/Anthropic.

-Багато з наведених нижче вбудованих Plugin постачальників уже публікують типовий каталог.
-Використовуйте явні записи `models.providers.<id>` лише тоді, коли хочете перевизначити
-типовий base URL, заголовки або список моделей.
+Багато з наведених нижче вбудованих Plugins постачальників уже публікують каталог за замовчуванням.
+Використовуйте явні записи `models.providers.<id>` лише тоді, коли потрібно перевизначити
+базовий URL, заголовки або список моделей за замовчуванням.

 ### Moonshot AI (Kimi)

-Moonshot постачається як вбудований Plugin постачальника. Типово використовуйте
-вбудованого постачальника, а явний запис `models.providers.moonshot` додавайте лише тоді, коли
-потрібно перевизначити base URL або метадані моделі:
+Moonshot постачається як вбудований Plugin постачальника. Використовуйте вбудованого постачальника
+за замовчуванням і додавайте явний запис `models.providers.moonshot` лише тоді, коли
+потрібно перевизначити базовий URL або метадані моделі:

 - Постачальник: `moonshot`
- Auth: `MOONSHOT_API_KEY`
+- Автентифікація: `MOONSHOT_API_KEY`
 - Приклад моделі: `moonshot/kimi-k2.6`
 - CLI: `openclaw onboard --auth-choice moonshot-api-key` або `openclaw onboard --auth-choice moonshot-api-key-cn`

-Id моделей Kimi K2:
+Ідентифікатори моделей Kimi K2:

 [//]: # "moonshot-kimi-k2-model-refs:start"

@ -313,7 +313,7 @@ Id моделей Kimi K2:
 Kimi Coding використовує Anthropic-сумісну кінцеву точку Moonshot AI:

 - Постачальник: `kimi`
- Auth: `KIMI_API_KEY`
+- Автентифікація: `KIMI_API_KEY`
 - Приклад моделі: `kimi/kimi-code`

 ```json5
@ -325,14 +325,14 @@ Kimi Coding використовує Anthropic-сумісну кінцеву т
 }
 ```

-Застарілий `kimi/k2p5` як і раніше приймається як id моделі для сумісності.
+Застарілий `kimi/k2p5` і далі приймається як сумісний ідентифікатор моделі.

 ### Volcano Engine (Doubao)

 Volcano Engine (火山引擎) надає доступ до Doubao та інших моделей у Китаї.

 - Постачальник: `volcengine` (coding: `volcengine-plan`)
- Auth: `VOLCANO_ENGINE_API_KEY`
+- Автентифікація: `VOLCANO_ENGINE_API_KEY`
 - Приклад моделі: `volcengine-plan/ark-code-latest`
 - CLI: `openclaw onboard --auth-choice volcengine-api-key`

@ -344,13 +344,13 @@ Volcano Engine (火山引擎) надає доступ до Doubao та інши
 }
 ```

-Онбординг типово використовує поверхню coding, але загальний каталог `volcengine/*`
+Під час онбордингу за замовчуванням використовується поверхня coding, але загальний каталог `volcengine/*`
 реєструється одночасно.

-У засобах вибору моделей onboarding/configure варіант auth для Volcengine надає перевагу рядкам
-`volcengine/*` і `volcengine-plan/*`. Якщо ці моделі ще не завантажені,
-OpenClaw повертається до нефільтрованого каталогу, а не показує порожній
-засіб вибору в межах постачальника.
+У пікерах вибору моделі для онбордингу/налаштування варіант автентифікації Volcengine надає перевагу рядкам
+`volcengine/*` і `volcengine-plan/*`. Якщо ці моделі ще не завантажено,
+OpenClaw повертається до нефільтрованого каталогу замість показу порожнього
+пікера в межах постачальника.

 Доступні моделі:

@ -360,7 +360,7 @@ OpenClaw повертається до нефільтрованого катал
 - `volcengine/glm-4-7-251222` (GLM 4.7)
 - `volcengine/deepseek-v3-2-251201` (DeepSeek V3.2 128K)

-Моделі coding (`volcengine-plan`):
+Моделі для кодування (`volcengine-plan`):

 - `volcengine-plan/ark-code-latest`
 - `volcengine-plan/doubao-seed-code`
@ -373,7 +373,7 @@ OpenClaw повертається до нефільтрованого катал
 BytePlus ARK надає міжнародним користувачам доступ до тих самих моделей, що й Volcano Engine.

 - Постачальник: `byteplus` (coding: `byteplus-plan`)
- Auth: `BYTEPLUS_API_KEY`
+- Автентифікація: `BYTEPLUS_API_KEY`
 - Приклад моделі: `byteplus-plan/ark-code-latest`
 - CLI: `openclaw onboard --auth-choice byteplus-api-key`

@ -385,13 +385,13 @@ BytePlus ARK надає міжнародним користувачам дост
 }
 ```

-Онбординг типово використовує поверхню coding, але загальний каталог `byteplus/*`
+Під час онбордингу за замовчуванням використовується поверхня coding, але загальний каталог `byteplus/*`
 реєструється одночасно.

-У засобах вибору моделей onboarding/configure варіант auth для BytePlus надає перевагу рядкам
-`byteplus/*` і `byteplus-plan/*`. Якщо ці моделі ще не завантажені,
-OpenClaw повертається до нефільтрованого каталогу, а не показує порожній
-засіб вибору в межах постачальника.
+У пікерах вибору моделі для онбордингу/налаштування варіант автентифікації BytePlus надає перевагу рядкам
+`byteplus/*` і `byteplus-plan/*`. Якщо ці моделі ще не завантажено,
+OpenClaw повертається до нефільтрованого каталогу замість показу порожнього
+пікера в межах постачальника.

 Доступні моделі:

@ -399,7 +399,7 @@ OpenClaw повертається до нефільтрованого катал
 - `byteplus/kimi-k2-5-260127` (Kimi K2.5)
 - `byteplus/glm-4-7-251222` (GLM 4.7)

-Моделі coding (`byteplus-plan`):
+Моделі для кодування (`byteplus-plan`):

 - `byteplus-plan/ark-code-latest`
 - `byteplus-plan/doubao-seed-code`
@ -412,7 +412,7 @@ OpenClaw повертається до нефільтрованого катал
 Synthetic надає Anthropic-сумісні моделі через постачальника `synthetic`:

 - Постачальник: `synthetic`
- Auth: `SYNTHETIC_API_KEY`
+- Автентифікація: `SYNTHETIC_API_KEY`
 - Приклад моделі: `synthetic/hf:MiniMaxAI/MiniMax-M2.5`
 - CLI: `openclaw onboard --auth-choice synthetic-api-key`

@ -437,26 +437,26 @@ Synthetic надає Anthropic-сумісні моделі через поста

 ### MiniMax

-MiniMax налаштовується через `models.providers`, оскільки використовує власні кінцеві точки:
+MiniMax налаштовується через `models.providers`, оскільки використовує custom кінцеві точки:

- MiniMax OAuth (Global): `--auth-choice minimax-global-oauth`
- MiniMax OAuth (CN): `--auth-choice minimax-cn-oauth`
- MiniMax API key (Global): `--auth-choice minimax-global-api`
- MiniMax API key (CN): `--auth-choice minimax-cn-api`
- Auth: `MINIMAX_API_KEY` для `minimax`; `MINIMAX_OAUTH_TOKEN` або
+- OAuth MiniMax (Global): `--auth-choice minimax-global-oauth`
+- OAuth MiniMax (CN): `--auth-choice minimax-cn-oauth`
+- API-ключ MiniMax (Global): `--auth-choice minimax-global-api`
+- API-ключ MiniMax (CN): `--auth-choice minimax-cn-api`
+- Автентифікація: `MINIMAX_API_KEY` для `minimax`; `MINIMAX_OAUTH_TOKEN` або
  `MINIMAX_API_KEY` для `minimax-portal`

-Деталі налаштування, варіанти моделей і фрагменти конфігурації див. у [/providers/minimax](/uk/providers/minimax).
+Дивіться [/providers/minimax](/uk/providers/minimax) для деталей налаштування, варіантів моделей і фрагментів конфігурації.

-У Anthropic-сумісному потоковому шляху MiniMax OpenClaw типово вимикає thinking,
-якщо ви явно його не задасте, а `/fast on` переписує
+На Anthropic-сумісному шляху потокової передачі MiniMax OpenClaw вимикає thinking
+за замовчуванням, якщо ви явно його не задасте, а `/fast on` переписує
 `MiniMax-M2.7` на `MiniMax-M2.7-highspeed`.

-Розділення можливостей, що належить Plugin:
+Поділ можливостей, якими володіє Plugin:

- Типові значення text/chat залишаються на `minimax/MiniMax-M2.7`
+- Текст/чат за замовчуванням залишаються на `minimax/MiniMax-M2.7`
 - Генерація зображень — це `minimax/image-01` або `minimax-portal/image-01`
- Розуміння зображень — це `MiniMax-VL-01`, що належить Plugin, на обох шляхах auth MiniMax
+- Розуміння зображень — це `MiniMax-VL-01`, яким володіє Plugin, на обох шляхах автентифікації MiniMax
 - Вебпошук залишається на id постачальника `minimax`

 ### LM Studio
@ -464,10 +464,10 @@ MiniMax налаштовується через `models.providers`, оскіль
 LM Studio постачається як вбудований Plugin постачальника, який використовує нативний API:

 - Постачальник: `lmstudio`
- Auth: `LM_API_TOKEN`
- Типовий базовий URL inference: `http://localhost:1234/v1`
+- Автентифікація: `LM_API_TOKEN`
+- Базовий URL інференсу за замовчуванням: `http://localhost:1234/v1`

-Потім задайте модель (замініть на один з id, повернутих `http://localhost:1234/api/v1/models`):
+Потім задайте модель (замініть на один з ідентифікаторів, які повертає `http://localhost:1234/api/v1/models`):

 ```json5
 {
@ -477,16 +477,16 @@ LM Studio постачається як вбудований Plugin постач
 }
 ```

-OpenClaw використовує нативні для LM Studio `/api/v1/models` і `/api/v1/models/load`
-для виявлення й автозавантаження, а `/v1/chat/completions` типово — для inference.
-Деталі налаштування та усунення несправностей див. у [/providers/lmstudio](/uk/providers/lmstudio).
+OpenClaw використовує нативні `LM Studio` `/api/v1/models` і `/api/v1/models/load`
+для виявлення й автозавантаження, а `/v1/chat/completions` — для інференсу за замовчуванням.
+Дивіться [/providers/lmstudio](/uk/providers/lmstudio) для налаштування та усунення проблем.

 ### Ollama

-Ollama постачається як вбудований Plugin постачальника й використовує нативний API Ollama:
+Ollama постачається як вбудований Plugin постачальника та використовує нативний API Ollama:

 - Постачальник: `ollama`
- Auth: не потрібен (локальний сервер)
+- Автентифікація: не потрібна (локальний сервер)
 - Приклад моделі: `ollama/llama3.3`
 - Встановлення: [https://ollama.com/download](https://ollama.com/download)

@ -503,27 +503,27 @@ ollama pull llama3.3
 }
 ```

-Ollama виявляється локально за адресою `http://127.0.0.1:11434`, коли ви вмикаєте її через
-`OLLAMA_API_KEY`, а вбудований Plugin постачальника додає Ollama безпосередньо до
-`openclaw onboard` і засобу вибору моделі. Див. [/providers/ollama](/uk/providers/ollama)
-щодо онбордингу, хмарного/локального режиму та власної конфігурації.
+Ollama виявляється локально за адресою `http://127.0.0.1:11434`, якщо ви вмикаєте це через
+`OLLAMA_API_KEY`, а вбудований Plugin постачальника додає Ollama безпосередньо в
+`openclaw onboard` і пікер моделей. Дивіться [/providers/ollama](/uk/providers/ollama)
+для онбордингу, хмарного/локального режиму та custom-конфігурації.

 ### vLLM

-vLLM постачається як вбудований Plugin постачальника для локальних/self-hosted OpenAI-сумісних
-серверів:
+vLLM постачається як вбудований Plugin постачальника для локальних/самостійно розміщених
+серверів, сумісних з OpenAI:

 - Постачальник: `vllm`
- Auth: необов’язковий (залежить від вашого сервера)
- Типовий базовий URL: `http://127.0.0.1:8000/v1`
+- Автентифікація: необов’язкова (залежить від вашого сервера)
+- Базовий URL за замовчуванням: `http://127.0.0.1:8000/v1`

-Щоб увімкнути автовиявлення локально (підійде будь-яке значення, якщо ваш сервер не вимагає auth):
+Щоб увімкнути автовиявлення локально (підійде будь-яке значення, якщо ваш сервер не вимагає автентифікації):

 ```bash
 export VLLM_API_KEY="vllm-local"
 ```

-Потім задайте модель (замініть на один з id, повернутих `/v1/models`):
+Потім задайте модель (замініть на один з ідентифікаторів, які повертає `/v1/models`):

 ```json5
 {
@ -533,25 +533,25 @@ export VLLM_API_KEY="vllm-local"
 }
 ```

-Деталі див. у [/providers/vllm](/uk/providers/vllm).
+Дивіться [/providers/vllm](/uk/providers/vllm) для деталей.

 ### SGLang

-SGLang постачається як вбудований Plugin постачальника для швидких self-hosted
-OpenAI-сумісних серверів:
+SGLang постачається як вбудований Plugin постачальника для швидких самостійно розміщених
+серверів, сумісних з OpenAI:

 - Постачальник: `sglang`
- Auth: необов’язковий (залежить від вашого сервера)
- Типовий базовий URL: `http://127.0.0.1:30000/v1`
+- Автентифікація: необов’язкова (залежить від вашого сервера)
+- Базовий URL за замовчуванням: `http://127.0.0.1:30000/v1`

 Щоб увімкнути автовиявлення локально (підійде будь-яке значення, якщо ваш сервер не
-вимагає auth):
+вимагає автентифікації):

 ```bash
 export SGLANG_API_KEY="sglang-local"
 ```

-Потім задайте модель (замініть на один з id, повернутих `/v1/models`):
+Потім задайте модель (замініть на один з ідентифікаторів, які повертає `/v1/models`):

 ```json5
 {
@ -561,11 +561,11 @@ export SGLANG_API_KEY="sglang-local"
 }
 ```

-Деталі див. у [/providers/sglang](/uk/providers/sglang).
+Дивіться [/providers/sglang](/uk/providers/sglang) для деталей.

 ### Локальні проксі (LM Studio, vLLM, LiteLLM тощо)

-Приклад (OpenAI‑сумісний):
+Приклад (сумісний з OpenAI):

 ```json5
 {
@ -600,18 +600,18 @@ export SGLANG_API_KEY="sglang-local"

 Примітки:

- Для власних постачальників `reasoning`, `input`, `cost`, `contextWindow` і `maxTokens` необов’язкові.
-  Якщо їх не задано, OpenClaw типово використовує:
+- Для custom-постачальників `reasoning`, `input`, `cost`, `contextWindow` і `maxTokens` є необов’язковими.
+  Якщо їх пропущено, OpenClaw використовує такі значення за замовчуванням:
  - `reasoning: false`
  - `input: ["text"]`
  - `cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }`
  - `contextWindow: 200000`
  - `maxTokens: 8192`
 - Рекомендовано: задавайте явні значення, що відповідають обмеженням вашого проксі/моделі.
- Для `api: "openai-completions"` на ненативних кінцевих точках (будь-який непорожній `baseUrl`, чий host не є `api.openai.com`) OpenClaw примусово встановлює `compat.supportsDeveloperRole: false`, щоб уникати помилок постачальника 400 для непідтримуваних ролей `developer`.
- Проксі-подібні OpenAI-сумісні маршрути також пропускають формування запитів, доступне лише для нативного OpenAI: без `service_tier`, без Responses `store`, без підказок кешу prompt, без формування payload для сумісності reasoning OpenAI та без прихованих заголовків атрибуції OpenClaw.
- Якщо `baseUrl` порожній/не заданий, OpenClaw зберігає типову поведінку OpenAI (яка веде до `api.openai.com`).
- Для безпеки явне `compat.supportsDeveloperRole: true` все одно перевизначається на ненативних кінцевих точках `openai-completions`.
+- Для `api: "openai-completions"` на ненативних кінцевих точках (будь-який непорожній `baseUrl`, де хост не є `api.openai.com`) OpenClaw примусово встановлює `compat.supportsDeveloperRole: false`, щоб уникнути помилок 400 від постачальника для непідтримуваних ролей `developer`.
+- Маршрути в стилі проксі, сумісні з OpenAI, також пропускають формування запитів, притаманне лише нативному OpenAI: без `service_tier`, без Responses `store`, без підказок кешу prompt, без формування payload для сумісності reasoning OpenAI і без прихованих заголовків атрибуції OpenClaw.
+- Якщо `baseUrl` порожній/не заданий, OpenClaw зберігає стандартну поведінку OpenAI (яка розв’язується в `api.openai.com`).
+- З міркувань безпеки явне `compat.supportsDeveloperRole: true` все одно перевизначається на ненативних кінцевих точках `openai-completions`.

 ## Приклади CLI

@ -621,11 +621,11 @@ openclaw models set opencode/claude-opus-4-6
 openclaw models list
 ```

-Див. також: [/gateway/configuration](/uk/gateway/configuration) для повних прикладів конфігурації.
+Дивіться також: [/gateway/configuration](/uk/gateway/configuration) для повних прикладів конфігурації.

-## Пов’язане
+## Пов’язані сторінки

- [Models](/uk/concepts/models) — конфігурація моделей і аліаси
+- [Models](/uk/concepts/models) — конфігурація моделей і псевдоніми
 - [Model Failover](/uk/concepts/model-failover) — ланцюжки резервного перемикання та поведінка повторних спроб
- [Configuration Reference](/uk/gateway/config-agents#agent-defaults) — ключі конфігурації моделей
- [Providers](/uk/providers) — інструкції з налаштування для кожного постачальника
+- [Configuration Reference](/uk/gateway/config-agents#agent-defaults) — ключі конфігурації моделі
+- [Providers](/uk/providers) — посібники з налаштування для кожного постачальника
--- a/docs/uk/gateway/config-tools.md
+++ b/docs/uk/gateway/config-tools.md
@ -1,58 +1,58 @@
 ---
 read_when:
-    - Налаштування policy, allowlist або експериментальних можливостей `tools.*`
-    - Реєстрація власних providers або перевизначення base URL
-    - Налаштування самостійно розміщених endpoint, сумісних з OpenAI
-summary: Конфігурація Tools (policy, experimental toggles, provider-backed tools) і власне налаштування provider/base-URL
-title: Конфігурація — Tools і власні providers
+    - Налаштування політики, списків дозволеного або експериментальних можливостей для `tools.*`
+    - Реєстрація користувацьких провайдерів або перевизначення базових URL-адрес
+    - Налаштування самостійно розміщених кінцевих точок, сумісних з OpenAI
+summary: Конфігурація інструментів (політика, експериментальні перемикачі, інструменти на основі провайдерів) і налаштування користувацького провайдера/base-URL
+title: Конфігурація — інструменти та користувацькі провайдери
 x-i18n:
-    generated_at: "2026-04-24T03:44:25Z"
+    generated_at: "2026-04-25T00:30:50Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 92535fb937f688c7cd39dcf5fc55f4663c8d234388a46611527efad4b7ee85eb
+    source_hash: a3a9ab07a5536196f3ba6c64111eb97206c3b4ff12e497564fe09684193e5c8a
    source_path: gateway/config-tools.md
    workflow: 15
 ---

-Ключі конфігурації `tools.*` і налаштування власних provider / base URL. Для агентів,
-каналів та інших конфігурацій верхнього рівня див.
-[Довідник конфігурації](/uk/gateway/configuration-reference).
+Ключі конфігурації `tools.*` і налаштування користувацького провайдера / base-URL. Для агентів,
+каналів та інших ключів конфігурації верхнього рівня див.
+[Довідник із конфігурації](/uk/gateway/configuration-reference).

-## Tools
+## Інструменти

 ### Профілі інструментів

-`tools.profile` задає базовий allowlist перед `tools.allow`/`tools.deny`:
+`tools.profile` задає базовий список дозволеного перед `tools.allow`/`tools.deny`:

-Локальний онбординг типово встановлює для нових локальних конфігурацій `tools.profile: "coding"`, якщо значення не задано (наявні явно вказані профілі зберігаються).
+Локальне онбординг-налаштування за замовчуванням встановлює для нових локальних конфігурацій `tools.profile: "coding"`, якщо значення не задано (наявні явно вказані профілі зберігаються).

-| Профіль     | Містить                                                                                                                         |
-| ----------- | -------------------------------------------------------------------------------------------------------------------------------- |
-| `minimal`   | лише `session_status`                                                                                                            |
+| Профіль     | Містить                                                                                                                        |
+| ----------- | ------------------------------------------------------------------------------------------------------------------------------ |
+| `minimal`   | лише `session_status`                                                                                                          |
 | `coding`    | `group:fs`, `group:runtime`, `group:web`, `group:sessions`, `group:memory`, `cron`, `image`, `image_generate`, `video_generate` |
-| `messaging` | `group:messaging`, `sessions_list`, `sessions_history`, `sessions_send`, `session_status`                                        |
-| `full`      | Без обмежень (так само, як і без значення)                                                                                       |
+| `messaging` | `group:messaging`, `sessions_list`, `sessions_history`, `sessions_send`, `session_status`                                      |
+| `full`      | Без обмежень (так само, як якщо не задано)                                                                                     |

 ### Групи інструментів

-| Група              | Інструменти                                                                                                             |
-| ------------------ | ----------------------------------------------------------------------------------------------------------------------- |
-| `group:runtime`    | `exec`, `process`, `code_execution` (`bash` приймається як псевдонім для `exec`)                                        |
-| `group:fs`         | `read`, `write`, `edit`, `apply_patch`                                                                                  |
+| Група              | Інструменти                                                                                                           |
+| ------------------ | --------------------------------------------------------------------------------------------------------------------- |
+| `group:runtime`    | `exec`, `process`, `code_execution` (`bash` приймається як псевдонім для `exec`)                                     |
+| `group:fs`         | `read`, `write`, `edit`, `apply_patch`                                                                                |
 | `group:sessions`   | `sessions_list`, `sessions_history`, `sessions_send`, `sessions_spawn`, `sessions_yield`, `subagents`, `session_status` |
-| `group:memory`     | `memory_search`, `memory_get`                                                                                           |
-| `group:web`        | `web_search`, `x_search`, `web_fetch`                                                                                   |
-| `group:ui`         | `browser`, `canvas`                                                                                                     |
-| `group:automation` | `cron`, `gateway`                                                                                                       |
-| `group:messaging`  | `message`                                                                                                               |
-| `group:nodes`      | `nodes`                                                                                                                 |
-| `group:agents`     | `agents_list`                                                                                                           |
-| `group:media`      | `image`, `image_generate`, `video_generate`, `tts`                                                                      |
-| `group:openclaw`   | Усі вбудовані інструменти (без provider Plugin)                                                                         |
+| `group:memory`     | `memory_search`, `memory_get`                                                                                         |
+| `group:web`        | `web_search`, `x_search`, `web_fetch`                                                                                 |
+| `group:ui`         | `browser`, `canvas`                                                                                                   |
+| `group:automation` | `cron`, `gateway`                                                                                                     |
+| `group:messaging`  | `message`                                                                                                             |
+| `group:nodes`      | `nodes`                                                                                                               |
+| `group:agents`     | `agents_list`                                                                                                         |
+| `group:media`      | `image`, `image_generate`, `video_generate`, `tts`                                                                    |
+| `group:openclaw`   | Усі вбудовані інструменти (не включає плагіни провайдерів)                                                            |

 ### `tools.allow` / `tools.deny`

-Глобальна політика дозволу/заборони інструментів (заборона має пріоритет). Нечутлива до регістру, підтримує wildcard `*`. Застосовується навіть коли sandbox Docker вимкнено.
+Глобальна політика дозволу/заборони інструментів (заборона має пріоритет). Без урахування регістру, підтримує шаблони `*`. Застосовується навіть коли пісочницю Docker вимкнено.

 ```json5
 {
@ -62,7 +62,7 @@ x-i18n:

 ### `tools.byProvider`

-Додатково обмежує інструменти для конкретних provider або моделей. Порядок: базовий профіль → профіль provider → allow/deny.
+Додатково обмежує інструменти для конкретних провайдерів або моделей. Порядок: базовий профіль → профіль провайдера → allow/deny.

 ```json5
 {
@ -78,7 +78,7 @@ x-i18n:

 ### `tools.elevated`

-Керує elevated-доступом `exec` поза sandbox:
+Керує розширеним доступом `exec` поза пісочницею:

 ```json5
 {
@ -94,9 +94,9 @@ x-i18n:
 }
 ```

- Перевизначення для окремого агента (`agents.list[].tools.elevated`) може лише додатково обмежувати.
- `/elevated on|off|ask|full` зберігає стан для кожної сесії; inline-директиви застосовуються лише до одного повідомлення.
- Elevated `exec` обходить sandbox і використовує налаштований шлях виходу (`gateway` типово, або `node`, коли ціллю exec є `node`).
+- Перевизначення на рівні агента (`agents.list[].tools.elevated`) може лише додатково обмежувати.
+- `/elevated on|off|ask|full` зберігає стан для кожної сесії; вбудовані директиви застосовуються до одного повідомлення.
+- Розширений `exec` обходить пісочницю та використовує налаштований шлях виходу (`gateway` за замовчуванням або `node`, коли ціль `exec` — `node`).

 ### `tools.exec`

@ -120,8 +120,8 @@ x-i18n:

 ### `tools.loopDetection`

-Перевірки безпеки від циклів інструментів **типово вимкнені**. Установіть `enabled: true`, щоб увімкнути виявлення.
-Налаштування можна задати глобально в `tools.loopDetection` і перевизначити для окремого агента в `agents.list[].tools.loopDetection`.
+Перевірки безпеки на цикли інструментів **вимкнені за замовчуванням**. Установіть `enabled: true`, щоб увімкнути виявлення.
+Параметри можна задати глобально в `tools.loopDetection` і перевизначити для окремого агента в `agents.list[].tools.loopDetection`.

 ```json5
 {
@ -145,9 +145,9 @@ x-i18n:
 - `historySize`: максимальна історія викликів інструментів, що зберігається для аналізу циклів.
 - `warningThreshold`: поріг повторюваного шаблону без прогресу для попереджень.
 - `criticalThreshold`: вищий поріг повторення для блокування критичних циклів.
- `globalCircuitBreakerThreshold`: жорсткий поріг зупинки для будь-якого запуску без прогресу.
+- `globalCircuitBreakerThreshold`: жорсткий поріг зупинки для будь-якого виконання без прогресу.
 - `detectors.genericRepeat`: попереджати про повторні виклики того самого інструмента з тими самими аргументами.
- `detectors.knownPollNoProgress`: попереджати/блокувати відомі poll-інструменти (`process.poll`, `command_status` тощо).
+- `detectors.knownPollNoProgress`: попереджати/блокувати відомі інструменти опитування (`process.poll`, `command_status` тощо) без прогресу.
 - `detectors.pingPong`: попереджати/блокувати шаблони чергування пар без прогресу.
 - Якщо `warningThreshold >= criticalThreshold` або `criticalThreshold >= globalCircuitBreakerThreshold`, перевірка не проходить.

@ -159,14 +159,14 @@ x-i18n:
    web: {
      search: {
        enabled: true,
-        apiKey: "brave_api_key", // or BRAVE_API_KEY env
+        apiKey: "brave_api_key", // або змінна середовища BRAVE_API_KEY
        maxResults: 5,
        timeoutSeconds: 30,
        cacheTtlMinutes: 15,
      },
      fetch: {
        enabled: true,
-        provider: "firecrawl", // optional; omit for auto-detect
+        provider: "firecrawl", // необов’язково; пропустіть для автовизначення
        maxChars: 50000,
        maxCharsCap: 50000,
        maxResponseBytes: 2000000,
@ -183,7 +183,7 @@ x-i18n:

 ### `tools.media`

-Налаштовує розуміння вхідних медіа (зображення/аудіо/відео):
+Налаштовує розпізнавання вхідних медіа (зображення/аудіо/відео):

 ```json5
 {
@ -191,7 +191,7 @@ x-i18n:
    media: {
      concurrency: 2,
      asyncCompletion: {
-        directSend: false, // opt-in: send finished async music/video directly to the channel
+        directSend: false, // опціонально: надсилати завершені асинхронні музичні/відео результати безпосередньо в канал
      },
      audio: {
        enabled: true,
@ -217,30 +217,30 @@ x-i18n:

 <Accordion title="Поля запису моделі медіа">

-**Запис provider** (`type: "provider"` або без вказання):
+**Запис провайдера** (`type: "provider"` або пропущено):

- `provider`: id API provider (`openai`, `anthropic`, `google`/`gemini`, `groq` тощо)
- `model`: перевизначення id моделі
+- `provider`: ідентифікатор API-провайдера (`openai`, `anthropic`, `google`/`gemini`, `groq` тощо)
+- `model`: перевизначення ідентифікатора моделі
 - `profile` / `preferredProfile`: вибір профілю з `auth-profiles.json`

-**Запис CLI** (`type: "cli"`):
+**CLI-запис** (`type: "cli"`):

 - `command`: виконуваний файл для запуску
- `args`: шаблонізовані аргументи (підтримуються `{{MediaPath}}`, `{{Prompt}}`, `{{MaxChars}}` тощо)
+- `args`: шаблонізовані аргументи (підтримує `{{MediaPath}}`, `{{Prompt}}`, `{{MaxChars}}` тощо)

 **Спільні поля:**

- `capabilities`: необов’язковий список (`image`, `audio`, `video`). Типові значення: `openai`/`anthropic`/`minimax` → image, `google` → image+audio+video, `groq` → audio.
+- `capabilities`: необов’язковий список (`image`, `audio`, `video`). Значення за замовчуванням: `openai`/`anthropic`/`minimax` → image, `google` → image+audio+video, `groq` → audio.
 - `prompt`, `maxChars`, `maxBytes`, `timeoutSeconds`, `language`: перевизначення для окремого запису.
 - У разі помилки використовується наступний запис.

-Автентифікація provider дотримується стандартного порядку: `auth-profiles.json` → змінні середовища → `models.providers.*.apiKey`.
+Автентифікація провайдера виконується у стандартному порядку: `auth-profiles.json` → змінні середовища → `models.providers.*.apiKey`.

 **Поля асинхронного завершення:**

 - `asyncCompletion.directSend`: коли `true`, завершені асинхронні завдання `music_generate`
-  і `video_generate` спочатку намагаються доставлятися безпосередньо в канал. Типове значення: `false`
-  (застарілий шлях requester-session wake/model-delivery).
+  і `video_generate` спочатку намагаються доставити результат безпосередньо в канал. За замовчуванням: `false`
+  (застарілий шлях пробудження сесії запитувача/доставки моделлю).

 </Accordion>

@ -259,9 +259,9 @@ x-i18n:

 ### `tools.sessions`

-Керує тим, на які сесії можуть бути націлені session tools (`sessions_list`, `sessions_history`, `sessions_send`).
+Керує тим, які сесії можуть бути ціллю для інструментів сесій (`sessions_list`, `sessions_history`, `sessions_send`).

-Типове значення: `tree` (поточна сесія + сесії, створені нею, наприклад субагенти).
+За замовчуванням: `tree` (поточна сесія + сесії, породжені нею, наприклад субагенти).

 ```json5
 {
@ -277,25 +277,25 @@ x-i18n:
 Примітки:

 - `self`: лише ключ поточної сесії.
- `tree`: поточна сесія + сесії, створені поточною сесією (субагенти).
- `agent`: будь-яка сесія, що належить поточному id агента (може включати інших користувачів, якщо ви запускаєте окремі сесії для відправників під тим самим id агента).
- `all`: будь-яка сесія. Націлення між агентами все одно потребує `tools.agentToAgent`.
- Обмеження sandbox: коли поточна сесія працює в sandbox і `agents.defaults.sandbox.sessionToolsVisibility="spawned"`, видимість примусово встановлюється на `tree`, навіть якщо `tools.sessions.visibility="all"`.
+- `tree`: поточна сесія + сесії, породжені поточною сесією (субагенти).
+- `agent`: будь-яка сесія, що належить поточному ідентифікатору агента (може включати інших користувачів, якщо ви запускаєте сесії для кожного відправника під тим самим ідентифікатором агента).
+- `all`: будь-яка сесія. Націлювання між агентами все одно вимагає `tools.agentToAgent`.
+- Обмеження пісочниці: коли поточна сесія працює в пісочниці і `agents.defaults.sandbox.sessionToolsVisibility="spawned"`, видимість примусово встановлюється в `tree`, навіть якщо `tools.sessions.visibility="all"`.

 ### `tools.sessions_spawn`

-Керує підтримкою inline-вкладень для `sessions_spawn`.
+Керує підтримкою вбудованих вкладень для `sessions_spawn`.

 ```json5
 {
  tools: {
    sessions_spawn: {
      attachments: {
-        enabled: false, // opt-in: set true to allow inline file attachments
-        maxTotalBytes: 5242880, // 5 MB total across all files
+        enabled: false, // опціонально: установіть true, щоб дозволити вбудовані файлові вкладення
+        maxTotalBytes: 5242880, // загалом 5 МБ для всіх файлів
        maxFiles: 50,
-        maxFileBytes: 1048576, // 1 MB per file
-        retainOnSessionKeep: false, // keep attachments when cleanup="keep"
+        maxFileBytes: 1048576, // 1 МБ на файл
+        retainOnSessionKeep: false, // зберігати вкладення, коли cleanup="keep"
      },
    },
  },
@ -304,10 +304,10 @@ x-i18n:

 Примітки:

- Вкладення підтримуються лише для `runtime: "subagent"`. Runtime ACP їх відхиляє.
- Файли матеріалізуються в дочірньому робочому просторі в `.openclaw/attachments/<uuid>/` разом із `.manifest.json`.
+- Вкладення підтримуються лише для `runtime: "subagent"`. Середовище ACP їх відхиляє.
+- Файли матеріалізуються в робочому просторі дочірньої сесії в `.openclaw/attachments/<uuid>/` разом із `.manifest.json`.
 - Вміст вкладень автоматично редагується під час збереження транскрипту.
- Входи Base64 перевіряються за допомогою суворої перевірки алфавіту/вирівнювання та захисту розміру до декодування.
+- Входи base64 перевіряються суворою перевіркою алфавіту/доповнення та захистом розміру до декодування.
 - Права доступу до файлів: `0700` для каталогів і `0600` для файлів.
 - Очищення виконується згідно з політикою `cleanup`: `delete` завжди видаляє вкладення; `keep` зберігає їх лише коли `retainOnSessionKeep: true`.

@ -315,13 +315,13 @@ x-i18n:

 ### `tools.experimental`

-Експериментальні прапорці вбудованих інструментів. Типово вимкнено, якщо не застосовується правило автоувімкнення strict-agentic GPT-5.
+Прапорці експериментальних вбудованих інструментів. За замовчуванням вимкнено, якщо не застосовується правило автоувімкнення strict-agentic GPT-5.

 ```json5
 {
  tools: {
    experimental: {
-      planTool: true, // enable experimental update_plan
+      planTool: true, // увімкнути експериментальний update_plan
    },
  },
 }
@ -330,8 +330,8 @@ x-i18n:
 Примітки:

 - `planTool`: вмикає структурований інструмент `update_plan` для відстеження нетривіальної багатокрокової роботи.
- Типове значення: `false`, якщо тільки `agents.defaults.embeddedPi.executionContract` (або перевизначення для окремого агента) не встановлено в `"strict-agentic"` для запуску OpenAI або OpenAI Codex сімейства GPT-5. Установіть `true`, щоб примусово ввімкнути інструмент поза цією областю, або `false`, щоб залишити його вимкненим навіть для запусків strict-agentic GPT-5.
- Коли інструмент увімкнено, system prompt також додає вказівки щодо використання, щоб модель застосовувала його лише для суттєвої роботи й підтримувала не більше одного кроку `in_progress`.
+- За замовчуванням: `false`, якщо тільки `agents.defaults.embeddedPi.executionContract` (або перевизначення для окремого агента) не встановлено в `"strict-agentic"` для запуску OpenAI або OpenAI Codex сімейства GPT-5. Установіть `true`, щоб примусово ввімкнути інструмент поза цією областю, або `false`, щоб залишити його вимкненим навіть для запусків strict-agentic GPT-5.
+- Коли інструмент увімкнено, системний промпт також додає вказівки з використання, щоб модель застосовувала його лише для суттєвої роботи та підтримувала не більше одного кроку `in_progress`.

 ### `agents.defaults.subagents`

@ -351,21 +351,21 @@ x-i18n:
 }
 ```

- `model`: типова модель для створених субагентів. Якщо не вказано, субагенти успадковують модель викликувача.
- `allowAgents`: типовий allowlist цільових id агентів для `sessions_spawn`, коли агент-запитувач не задає власний `subagents.allowAgents` (`["*"]` = будь-який; типово: лише той самий агент).
- `runTimeoutSeconds`: типовий тайм-аут (у секундах) для `sessions_spawn`, коли виклик інструмента не вказує `runTimeoutSeconds`. `0` означає відсутність тайм-ауту.
- Політика інструментів для субагентів: `tools.subagents.tools.allow` / `tools.subagents.tools.deny`.
+- `model`: модель за замовчуванням для породжених субагентів. Якщо не вказано, субагенти успадковують модель викликача.
+- `allowAgents`: список дозволених ідентифікаторів цільових агентів за замовчуванням для `sessions_spawn`, коли агент-запитувач не задає власний `subagents.allowAgents` (`["*"]` = будь-який; за замовчуванням: лише той самий агент).
+- `runTimeoutSeconds`: тайм-аут за замовчуванням (у секундах) для `sessions_spawn`, коли виклик інструмента не містить `runTimeoutSeconds`. `0` означає відсутність тайм-ауту.
+- Політика інструментів для кожного субагента: `tools.subagents.tools.allow` / `tools.subagents.tools.deny`.

 ---

-## Власні providers і base URL
+## Користувацькі провайдери та base URL

-OpenClaw використовує вбудований каталог моделей. Додавайте власні providers через `models.providers` у конфігурації або `~/.openclaw/agents/<agentId>/agent/models.json`.
+OpenClaw використовує вбудований каталог моделей. Додавайте користувацьких провайдерів через `models.providers` у конфігурації або `~/.openclaw/agents/<agentId>/agent/models.json`.

 ```json5
 {
  models: {
-    mode: "merge", // merge (default) | replace
+    mode: "merge", // merge (за замовчуванням) | replace
    providers: {
      "custom-proxy": {
        baseUrl: "http://localhost:4000/v1",
@ -389,51 +389,51 @@ OpenClaw використовує вбудований каталог модел
 }
 ```

- Використовуйте `authHeader: true` + `headers` для власних потреб автентифікації.
- Перевизначайте корінь конфігурації агента через `OPENCLAW_AGENT_DIR` (або `PI_CODING_AGENT_DIR`, застарілий псевдонім змінної середовища).
- Пріоритет злиття для provider ID, що збігаються:
+- Використовуйте `authHeader: true` + `headers` для нестандартних потреб автентифікації.
+- Перевизначайте кореневий каталог конфігурації агента через `OPENCLAW_AGENT_DIR` (або `PI_CODING_AGENT_DIR`, застарілий псевдонім змінної середовища).
+- Пріоритет злиття для однакових ідентифікаторів провайдерів:
  - Непорожні значення `baseUrl` з агентського `models.json` мають пріоритет.
-  - Непорожні значення `apiKey` з агента мають пріоритет лише тоді, коли цей provider не керується через SecretRef у поточному контексті config/auth-profile.
-  - Значення `apiKey` для provider, керованих через SecretRef, оновлюються з маркерів джерела (`ENV_VAR_NAME` для env-посилань, `secretref-managed` для file/exec-посилань) замість збереження розв’язаних секретів.
-  - Значення заголовків для provider, керованих через SecretRef, оновлюються з маркерів джерела (`secretref-env:ENV_VAR_NAME` для env-посилань, `secretref-managed` для file/exec-посилань).
-  - Порожні або відсутні агентські `apiKey`/`baseUrl` беруться з `models.providers` у конфігурації.
-  - Для моделей, що збігаються, `contextWindow`/`maxTokens` використовують більше значення між явною конфігурацією та неявними значеннями каталогу.
-  - Для моделей, що збігаються, `contextTokens` зберігає явне обмеження runtime, якщо воно задане; використовуйте це, щоб обмежити ефективний контекст без зміни рідних метаданих моделі.
-  - Використовуйте `models.mode: "replace"`, коли хочете, щоб конфігурація повністю переписала `models.json`.
-  - Збереження маркерів є джерельно-авторитетним: маркери записуються з активного знімка конфігурації джерела (до розв’язання), а не з розв’язаних значень секретів runtime.
+  - Непорожні значення `apiKey` з агента мають пріоритет лише тоді, коли цей провайдер не керується через SecretRef у поточному контексті конфігурації/профілю автентифікації.
+  - Значення `apiKey` для провайдерів, керованих SecretRef, оновлюються з маркерів джерела (`ENV_VAR_NAME` для посилань на змінні середовища, `secretref-managed` для посилань file/exec) замість збереження розкритих секретів.
+  - Значення заголовків провайдера, керованих SecretRef, оновлюються з маркерів джерела (`secretref-env:ENV_VAR_NAME` для посилань на змінні середовища, `secretref-managed` для посилань file/exec).
+  - Порожні або відсутні `apiKey`/`baseUrl` в агенті беруться з `models.providers` у конфігурації.
+  - Для однакових моделей `contextWindow`/`maxTokens` використовують вище значення між явною конфігурацією та неявними значеннями каталогу.
+  - Для однакових моделей `contextTokens` зберігає явне обмеження середовища виконання, якщо воно задане; використовуйте це, щоб обмежити ефективний контекст без зміни власних метаданих моделі.
+  - Використовуйте `models.mode: "replace"`, якщо хочете, щоб конфігурація повністю переписала `models.json`.
+  - Збереження маркерів є авторитетним щодо джерела: маркери записуються з активного знімка вихідної конфігурації (до розкриття), а не з розкритих значень секретів середовища виконання.

-### Докладніше про поля provider
+### Докладно про поля провайдера

- `models.mode`: поведінка каталогу provider (`merge` або `replace`).
- `models.providers`: мапа власних providers із ключем за id provider.
-  - Безпечні редагування: використовуйте `openclaw config set models.providers.<id> '<json>' --strict-json --merge` або `openclaw config set models.providers.<id>.models '<json-array>' --strict-json --merge` для додаткових оновлень. `config set` відмовляється від руйнівних замін, якщо ви не передасте `--replace`.
+- `models.mode`: поведінка каталогу провайдерів (`merge` або `replace`).
+- `models.providers`: мапа користувацьких провайдерів, ключована ідентифікатором провайдера.
+  - Безпечне редагування: використовуйте `openclaw config set models.providers.<id> '<json>' --strict-json --merge` або `openclaw config set models.providers.<id>.models '<json-array>' --strict-json --merge` для додаткових оновлень. `config set` відмовляється від руйнівних замін, якщо не передати `--replace`.
 - `models.providers.*.api`: адаптер запитів (`openai-completions`, `openai-responses`, `anthropic-messages`, `google-generative-ai` тощо).
- `models.providers.*.apiKey`: облікові дані provider (краще через SecretRef/env-підстановку).
+- `models.providers.*.apiKey`: облікові дані провайдера (бажано SecretRef/підстановка змінних середовища).
 - `models.providers.*.auth`: стратегія автентифікації (`api-key`, `token`, `oauth`, `aws-sdk`).
- `models.providers.*.injectNumCtxForOpenAICompat`: для Ollama + `openai-completions` вставляє `options.num_ctx` у запити (типово: `true`).
- `models.providers.*.authHeader`: примусово передає облікові дані в заголовку `Authorization`, коли це потрібно.
- `models.providers.*.baseUrl`: базовий URL висхідного API.
- `models.providers.*.headers`: додаткові статичні заголовки для маршрутизації через proxy/tenant.
- `models.providers.*.request`: перевизначення транспорту для HTTP-запитів model-provider.
-  - `request.headers`: додаткові заголовки (зливаються з типовими для provider). Значення приймають SecretRef.
-  - `request.auth`: перевизначення стратегії автентифікації. Режими: `"provider-default"` (використовувати вбудовану автентифікацію provider), `"authorization-bearer"` (з `token`), `"header"` (з `headerName`, `value`, необов’язковим `prefix`).
-  - `request.proxy`: перевизначення HTTP proxy. Режими: `"env-proxy"` (використовувати змінні середовища `HTTP_PROXY`/`HTTPS_PROXY`), `"explicit-proxy"` (з `url`). Обидва режими приймають необов’язковий підоб’єкт `tls`.
-  - `request.tls`: перевизначення TLS для прямих з’єднань. Поля: `ca`, `cert`, `key`, `passphrase` (усі приймають SecretRef), `serverName`, `insecureSkipVerify`.
-  - `request.allowPrivateNetwork`: коли `true`, дозволяє HTTPS до `baseUrl`, якщо DNS розв’язується в private, CGNAT або подібні діапазони, через захист HTTP fetch provider від SSRF (явне ввімкнення оператором для довірених самостійно розміщених endpoint, сумісних з OpenAI). WebSocket використовує той самий `request` для заголовків/TLS, але не цей SSRF-захист fetch. Типове значення `false`.
- `models.providers.*.models`: явні записи каталогу моделей provider.
- `models.providers.*.models.*.contextWindow`: метадані рідного вікна контексту моделі.
- `models.providers.*.models.*.contextTokens`: необов’язкове обмеження контексту runtime. Використовуйте це, якщо хочете менший ефективний бюджет контексту, ніж рідний `contextWindow` моделі.
- `models.providers.*.models.*.compat.supportsDeveloperRole`: необов’язкова підказка сумісності. Для `api: "openai-completions"` з непорожнім нерідним `baseUrl` (хост не `api.openai.com`) OpenClaw примусово встановлює це в `false` під час runtime. Порожній/відсутній `baseUrl` зберігає типову поведінку OpenAI.
- `models.providers.*.models.*.compat.requiresStringContent`: необов’язкова підказка сумісності для OpenAI-сумісних chat endpoint, які приймають лише рядки. Коли `true`, OpenClaw перетворює масиви `messages[].content`, що містять лише текст, у звичайні рядки перед надсиланням запиту.
+- `models.providers.*.injectNumCtxForOpenAICompat`: для Ollama + `openai-completions` додавати `options.num_ctx` у запити (за замовчуванням: `true`).
+- `models.providers.*.authHeader`: примусово передавати облікові дані в заголовку `Authorization`, коли це потрібно.
+- `models.providers.*.baseUrl`: базова URL-адреса висхідного API.
+- `models.providers.*.headers`: додаткові статичні заголовки для маршрутизації через проксі/орендаря.
+- `models.providers.*.request`: перевизначення транспорту для HTTP-запитів до провайдера моделі.
+  - `request.headers`: додаткові заголовки (об’єднуються зі значеннями провайдера за замовчуванням). Значення підтримують SecretRef.
+  - `request.auth`: перевизначення стратегії автентифікації. Режими: `"provider-default"` (використовувати вбудовану автентифікацію провайдера), `"authorization-bearer"` (з `token`), `"header"` (з `headerName`, `value`, необов’язковим `prefix`).
+  - `request.proxy`: перевизначення HTTP-проксі. Режими: `"env-proxy"` (використовувати змінні середовища `HTTP_PROXY`/`HTTPS_PROXY`), `"explicit-proxy"` (з `url`). Обидва режими підтримують необов’язковий підоб’єкт `tls`.
+  - `request.tls`: перевизначення TLS для прямих з’єднань. Поля: `ca`, `cert`, `key`, `passphrase` (усі підтримують SecretRef), `serverName`, `insecureSkipVerify`.
+  - `request.allowPrivateNetwork`: коли `true`, дозволяє HTTPS до `baseUrl`, якщо DNS розв’язується у приватні, CGNAT або подібні діапазони, через захист HTTP fetch провайдера (явне ввімкнення оператором для довірених самостійно розміщених OpenAI-сумісних кінцевих точок). WebSocket використовує той самий `request` для заголовків/TLS, але не цей SSRF-запобіжник fetch. За замовчуванням `false`.
+- `models.providers.*.models`: явні записи каталогу моделей провайдера.
+- `models.providers.*.models.*.contextWindow`: метадані власного вікна контексту моделі.
+- `models.providers.*.models.*.contextTokens`: необов’язкове обмеження контексту середовища виконання. Використовуйте це, коли хочете менший ефективний бюджет контексту, ніж власний `contextWindow` моделі.
+- `models.providers.*.models.*.compat.supportsDeveloperRole`: необов’язкова підказка сумісності. Для `api: "openai-completions"` із непорожнім не-власним `baseUrl` (хост не `api.openai.com`) OpenClaw примусово встановлює це значення в `false` під час виконання. Порожній/відсутній `baseUrl` зберігає стандартну поведінку OpenAI.
+- `models.providers.*.models.*.compat.requiresStringContent`: необов’язкова підказка сумісності для OpenAI-сумісних chat-кінцевих точок, що приймають лише рядки. Коли `true`, OpenClaw сплющує масиви `messages[].content`, які містять лише текст, у звичайні рядки перед надсиланням запиту.
 - `plugins.entries.amazon-bedrock.config.discovery`: корінь налаштувань авто-виявлення Bedrock.
 - `plugins.entries.amazon-bedrock.config.discovery.enabled`: увімкнути/вимкнути неявне виявлення.
 - `plugins.entries.amazon-bedrock.config.discovery.region`: регіон AWS для виявлення.
- `plugins.entries.amazon-bedrock.config.discovery.providerFilter`: необов’язковий фільтр id provider для цільового виявлення.
+- `plugins.entries.amazon-bedrock.config.discovery.providerFilter`: необов’язковий фільтр ідентифікатора провайдера для цільового виявлення.
 - `plugins.entries.amazon-bedrock.config.discovery.refreshInterval`: інтервал опитування для оновлення виявлення.
 - `plugins.entries.amazon-bedrock.config.discovery.defaultContextWindow`: резервне вікно контексту для виявлених моделей.
- `plugins.entries.amazon-bedrock.config.discovery.defaultMaxTokens`: резервна максимальна кількість вихідних токенів для виявлених моделей.
+- `plugins.entries.amazon-bedrock.config.discovery.defaultMaxTokens`: резервна максимальна кількість токенів виводу для виявлених моделей.

-### Приклади provider
+### Приклади провайдерів

 <Accordion title="Cerebras (GLM 4.6 / 4.7)">

@ -486,7 +486,7 @@ OpenClaw використовує вбудований каталог модел
 }
 ```

-Установіть `OPENCODE_API_KEY` (або `OPENCODE_ZEN_API_KEY`). Використовуйте посилання `opencode/...` для каталогу Zen або `opencode-go/...` для каталогу Go. Скорочення: `openclaw onboard --auth-choice opencode-zen` або `openclaw onboard --auth-choice opencode-go`.
+Установіть `OPENCODE_API_KEY` (або `OPENCODE_ZEN_API_KEY`). Використовуйте посилання `opencode/...` для каталогу Zen або посилання `opencode-go/...` для каталогу Go. Скорочений варіант: `openclaw onboard --auth-choice opencode-zen` або `openclaw onboard --auth-choice opencode-go`.

 </Accordion>

@ -503,11 +503,11 @@ OpenClaw використовує вбудований каталог модел
 }
 ```

-Установіть `ZAI_API_KEY`. `z.ai/*` і `z-ai/*` — допустимі псевдоніми. Скорочення: `openclaw onboard --auth-choice zai-api-key`.
+Установіть `ZAI_API_KEY`. `z.ai/*` і `z-ai/*` — допустимі псевдоніми. Скорочений варіант: `openclaw onboard --auth-choice zai-api-key`.

- Загальний endpoint: `https://api.z.ai/api/paas/v4`
- Endpoint для кодування (типовий): `https://api.z.ai/api/coding/paas/v4`
- Для загального endpoint визначте власний provider із перевизначенням base URL.
+- Загальна кінцева точка: `https://api.z.ai/api/paas/v4`
+- Кінцева точка для кодування (за замовчуванням): `https://api.z.ai/api/coding/paas/v4`
+- Для загальної кінцевої точки визначте користувацького провайдера з перевизначенням base URL.

 </Accordion>

@ -546,11 +546,11 @@ OpenClaw використовує вбудований каталог модел
 }
 ```

-Для endpoint у Китаї: `baseUrl: "https://api.moonshot.cn/v1"` або `openclaw onboard --auth-choice moonshot-api-key-cn`.
+Для кінцевої точки в Китаї: `baseUrl: "https://api.moonshot.cn/v1"` або `openclaw onboard --auth-choice moonshot-api-key-cn`.

-Рідні endpoint Moonshot рекламують сумісність streaming usage на спільному
-транспорті `openai-completions`, і OpenClaw визначає це за можливостями endpoint,
-а не лише за id вбудованого provider.
+Власні кінцеві точки Moonshot оголошують сумісність потокового використання на спільному
+транспорті `openai-completions`, і OpenClaw визначає це за можливостями кінцевої точки,
+а не лише за ідентифікатором вбудованого провайдера.

 </Accordion>

@ -568,7 +568,7 @@ OpenClaw використовує вбудований каталог модел
 }
 ```

-Сумісний з Anthropic, вбудований provider. Скорочення: `openclaw onboard --auth-choice kimi-code-api-key`.
+Сумісний з Anthropic, вбудований провайдер. Скорочений варіант: `openclaw onboard --auth-choice kimi-code-api-key`.

 </Accordion>

@ -607,11 +607,11 @@ OpenClaw використовує вбудований каталог модел
 }
 ```

-Base URL має не містити `/v1` (клієнт Anthropic додає його сам). Скорочення: `openclaw onboard --auth-choice synthetic-api-key`.
+Base URL має не містити `/v1` (клієнт Anthropic додає його сам). Скорочений варіант: `openclaw onboard --auth-choice synthetic-api-key`.

 </Accordion>

-<Accordion title="MiniMax M2.7 (direct)">
+<Accordion title="MiniMax M2.7 (напряму)">

 ```json5
 {
@ -635,7 +635,7 @@ Base URL має не містити `/v1` (клієнт Anthropic додає й
            id: "MiniMax-M2.7",
            name: "MiniMax M2.7",
            reasoning: true,
-            input: ["text", "image"],
+            input: ["text"],
            cost: { input: 0.3, output: 1.2, cacheRead: 0.06, cacheWrite: 0.375 },
            contextWindow: 204800,
            maxTokens: 131072,
@ -647,20 +647,20 @@ Base URL має не містити `/v1` (клієнт Anthropic додає й
 }
 ```

-Установіть `MINIMAX_API_KEY`. Скорочення:
+Установіть `MINIMAX_API_KEY`. Скорочені варіанти:
 `openclaw onboard --auth-choice minimax-global-api` або
 `openclaw onboard --auth-choice minimax-cn-api`.
-Каталог моделей типово містить лише M2.7.
-На Anthropic-сумісному streaming path OpenClaw типово вимикає thinking MiniMax,
-якщо ви явно не задасте `thinking` самостійно. `/fast on` або
+Каталог моделей за замовчуванням містить лише M2.7.
+На Anthropic-сумісному шляху потокової передачі OpenClaw вимикає thinking
+за замовчуванням, якщо ви явно не задасте `thinking` самостійно. `/fast on` або
 `params.fastMode: true` переписує `MiniMax-M2.7` на
 `MiniMax-M2.7-highspeed`.

 </Accordion>

-<Accordion title="Локальні моделі (LM Studio)">
+<Accordion title="Локальні моделі">

-Див. [Локальні моделі](/uk/gateway/local-models). Коротко: запускайте велику локальну модель через LM Studio Responses API на достатньо потужному обладнанні; зберігайте злиття з розміщеними моделями як резервний варіант.
+Див. [Локальні моделі](/uk/gateway/local-models). Коротко: запускайте велику локальну модель через LM Studio Responses API на достатньо потужному обладнанні; залишайте розміщені моделі об’єднаними для резервного використання.

 </Accordion>

@ -668,7 +668,7 @@ Base URL має не містити `/v1` (клієнт Anthropic додає й

 ## Пов’язане

- [Довідник конфігурації](/uk/gateway/configuration-reference) — інші ключі верхнього рівня
+- [Довідник із конфігурації](/uk/gateway/configuration-reference) — інші ключі верхнього рівня
 - [Конфігурація — агенти](/uk/gateway/config-agents)
 - [Конфігурація — канали](/uk/gateway/config-channels)
- [Tools і plugins](/uk/tools)
+- [Інструменти та плагіни](/uk/tools)
--- a/docs/uk/providers/minimax.md
+++ b/docs/uk/providers/minimax.md
@ -1,57 +1,57 @@
 ---
 read_when:
-    - Ви хочете використовувати моделі MiniMax в OpenClaw
-    - Вам потрібен посібник із налаштування MiniMax
+    - Ви хочете моделі MiniMax в OpenClaw
+    - Вам потрібні вказівки з налаштування MiniMax
 summary: Використання моделей MiniMax в OpenClaw
 title: MiniMax
 x-i18n:
-    generated_at: "2026-04-23T23:05:02Z"
+    generated_at: "2026-04-25T00:30:49Z"
    model: gpt-5.4
    provider: openai
-    source_hash: f2729e9e9f866e66a6587d6c58f6116abae2fc09a1f50e5038e1c25bed0a82f2
+    source_hash: 108e0e8de748d0ed68342e1391c7a661136e21e0b255b4afbccf913b6825c6ec
    source_path: providers/minimax.md
    workflow: 15
 ---

-Провайдер MiniMax в OpenClaw типово використовує **MiniMax M2.7**.
+Провайдер MiniMax в OpenClaw за замовчуванням використовує **MiniMax M2.7**.

 MiniMax також надає:

 - Вбудований синтез мовлення через T2A v2
- Вбудоване розуміння зображень через `MiniMax-VL-01`
+- Вбудоване розпізнавання зображень через `MiniMax-VL-01`
 - Вбудовану генерацію музики через `music-2.5+`
 - Вбудований `web_search` через API пошуку MiniMax Coding Plan

 Розподіл провайдерів:

-| ID провайдера    | Auth    | Можливості                                                      |
-| ---------------- | ------- | --------------------------------------------------------------- |
-| `minimax`        | API key | Текст, генерація зображень, розуміння зображень, мовлення, вебпошук |
-| `minimax-portal` | OAuth   | Текст, генерація зображень, розуміння зображень                 |
+| ID провайдера    | Автентифікація | Можливості                                                     |
+| ---------------- | -------------- | -------------------------------------------------------------- |
+| `minimax`        | API key        | Текст, генерація зображень, розпізнавання зображень, мовлення, вебпошук |
+| `minimax-portal` | OAuth          | Текст, генерація зображень, розпізнавання зображень            |

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

 | Модель                   | Тип              | Опис                                     |
 | ------------------------ | ---------------- | ---------------------------------------- |
-| `MiniMax-M2.7`           | Chat (reasoning) | Типова hosted reasoning-модель           |
-| `MiniMax-M2.7-highspeed` | Chat (reasoning) | Швидший reasoning-рівень M2.7            |
-| `MiniMax-VL-01`          | Vision           | Модель розуміння зображень               |
-| `image-01`               | Генерація зображень | Генерація зображення з тексту та редагування зображення до зображення |
-| `music-2.5+`             | Генерація музики | Типова модель музики                     |
+| `MiniMax-M2.7`           | Чат (міркування) | Типова хостингова модель для міркування  |
+| `MiniMax-M2.7-highspeed` | Чат (міркування) | Швидший рівень міркування M2.7           |
+| `MiniMax-VL-01`          | Vision           | Модель для розпізнавання зображень       |
+| `image-01`               | Генерація зображень | Перетворення тексту на зображення та редагування зображення за зображенням |
+| `music-2.5+`             | Генерація музики | Типова музична модель                    |
 | `music-2.5`              | Генерація музики | Попередній рівень генерації музики       |
-| `music-2.0`              | Генерація музики | Legacy-рівень генерації музики           |
-| `MiniMax-Hailuo-2.3`     | Генерація відео  | Потоки text-to-video та image reference  |
+| `music-2.0`              | Генерація музики | Застарілий рівень генерації музики       |
+| `MiniMax-Hailuo-2.3`     | Генерація відео  | Потоки перетворення тексту на відео та використання зображення як референсу |

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

-Виберіть бажаний спосіб auth і виконайте кроки налаштування.
+Виберіть бажаний спосіб автентифікації та виконайте кроки налаштування.

 <Tabs>
  <Tab title="OAuth (Coding Plan)">
-    **Найкраще для:** швидкого налаштування через MiniMax Coding Plan з OAuth, без потреби в API key.
+    **Найкраще підходить для:** швидкого налаштування MiniMax Coding Plan через OAuth, ключ API не потрібен.

    <Tabs>
-      <Tab title="Міжнародний">
+      <Tab title="International">
        <Steps>
          <Step title="Запустіть онбординг">
            ```bash
@ -67,7 +67,7 @@ MiniMax також надає:
          </Step>
        </Steps>
      </Tab>
-      <Tab title="Китай">
+      <Tab title="China">
        <Steps>
          <Step title="Запустіть онбординг">
            ```bash
@ -86,7 +86,7 @@ MiniMax також надає:
    </Tabs>

    <Note>
-    Конфігурації OAuth використовують id провайдера `minimax-portal`. Посилання на моделі мають форму `minimax-portal/MiniMax-M2.7`.
+    Налаштування OAuth використовують ID провайдера `minimax-portal`. Посилання на моделі мають формат `minimax-portal/MiniMax-M2.7`.
    </Note>

    <Tip>
@ -96,17 +96,17 @@ MiniMax також надає:
  </Tab>

  <Tab title="API key">
-    **Найкраще для:** hosted MiniMax із API, сумісним з Anthropic.
+    **Найкраще підходить для:** хостингового MiniMax з API, сумісним з Anthropic.

    <Tabs>
-      <Tab title="Міжнародний">
+      <Tab title="International">
        <Steps>
          <Step title="Запустіть онбординг">
            ```bash
            openclaw onboard --auth-choice minimax-global-api
            ```

-            Це налаштовує `api.minimax.io` як base URL.
+            Це налаштовує `api.minimax.io` як базову URL-адресу.
          </Step>
          <Step title="Перевірте, що модель доступна">
            ```bash
@ -115,14 +115,14 @@ MiniMax також надає:
          </Step>
        </Steps>
      </Tab>
-      <Tab title="Китай">
+      <Tab title="China">
        <Steps>
          <Step title="Запустіть онбординг">
            ```bash
            openclaw onboard --auth-choice minimax-cn-api
            ```

-            Це налаштовує `api.minimaxi.com` як base URL.
+            Це налаштовує `api.minimaxi.com` як базову URL-адресу.
          </Step>
          <Step title="Перевірте, що модель доступна">
            ```bash
@ -133,7 +133,7 @@ MiniMax також надає:
      </Tab>
    </Tabs>

-    ### Приклад config
+    ### Приклад конфігурації

    ```json5
    {
@ -151,7 +151,7 @@ MiniMax також надає:
                id: "MiniMax-M2.7",
                name: "MiniMax M2.7",
                reasoning: true,
-                input: ["text", "image"],
+                input: ["text"],
                cost: { input: 0.3, output: 1.2, cacheRead: 0.06, cacheWrite: 0.375 },
                contextWindow: 204800,
                maxTokens: 131072,
@ -160,7 +160,7 @@ MiniMax також надає:
                id: "MiniMax-M2.7-highspeed",
                name: "MiniMax M2.7 Highspeed",
                reasoning: true,
-                input: ["text", "image"],
+                input: ["text"],
                cost: { input: 0.6, output: 2.4, cacheRead: 0.06, cacheWrite: 0.375 },
                contextWindow: 204800,
                maxTokens: 131072,
@ -173,11 +173,11 @@ MiniMax також надає:
    ```

    <Warning>
-    На шляху потокової передачі, сумісному з Anthropic, OpenClaw типово вимикає thinking MiniMax, якщо ви явно не задасте `thinking` самі. Streaming-endpoint MiniMax виводить `reasoning_content` у delta-чанках у стилі OpenAI замість native-блоків thinking Anthropic, що може призвести до витоку внутрішнього reasoning у видимий вивід, якщо залишити це неявно увімкненим.
+    У сумісному з Anthropic потоковому режимі OpenClaw за замовчуванням вимикає thinking для MiniMax, якщо ви явно не встановите `thinking` самостійно. Потоковий ендпоінт MiniMax повертає `reasoning_content` у дельта-чанках у стилі OpenAI замість нативних блоків thinking Anthropic, що може призвести до витоку внутрішніх міркувань у видимий вивід, якщо залишити цю можливість неявно ввімкненою.
    </Warning>

    <Note>
-    Конфігурації з API key використовують id провайдера `minimax`. Посилання на моделі мають форму `minimax/MiniMax-M2.7`.
+    Налаштування з API key використовують ID провайдера `minimax`. Посилання на моделі мають формат `minimax/MiniMax-M2.7`.
    </Note>

  </Tab>
@ -185,7 +185,7 @@ MiniMax також надає:

 ## Налаштування через `openclaw configure`

-Використовуйте інтерактивний майстер config, щоб налаштувати MiniMax без редагування JSON:
+Скористайтеся інтерактивним майстром конфігурації, щоб налаштувати MiniMax без редагування JSON:

 <Steps>
  <Step title="Запустіть майстер">
@ -194,21 +194,21 @@ MiniMax також надає:
    ```
  </Step>
  <Step title="Виберіть Model/auth">
-    У меню виберіть **Model/auth**.
+    Виберіть у меню **Model/auth**.
  </Step>
-  <Step title="Виберіть варіант auth MiniMax">
+  <Step title="Виберіть параметр автентифікації MiniMax">
    Виберіть один із доступних варіантів MiniMax:

-    | Варіант auth | Опис |
+    | Варіант автентифікації | Опис |
    | --- | --- |
-    | `minimax-global-oauth` | Міжнародний OAuth (Coding Plan) |
-    | `minimax-cn-oauth` | OAuth для Китаю (Coding Plan) |
+    | `minimax-global-oauth` | International OAuth (Coding Plan) |
+    | `minimax-cn-oauth` | China OAuth (Coding Plan) |
    | `minimax-global-api` | Міжнародний API key |
    | `minimax-cn-api` | API key для Китаю |

  </Step>
  <Step title="Виберіть типову модель">
-    Коли з’явиться запит, виберіть вашу типову модель.
+    Коли з’явиться запит, виберіть типову модель.
  </Step>
 </Steps>

@ -216,15 +216,15 @@ MiniMax також надає:

 ### Генерація зображень

-Plugin MiniMax реєструє модель `image-01` для інструмента `image_generate`. Вона підтримує:
+Плагін MiniMax реєструє модель `image-01` для інструмента `image_generate`. Вона підтримує:

- **Генерація зображень із тексту** з керуванням aspect ratio
- **Редагування зображення за зображенням** (reference об’єкта) з керуванням aspect ratio
+- **Генерація зображень із тексту** з керуванням співвідношенням сторін
+- **Редагування зображення за зображенням** (референс об’єкта) з керуванням співвідношенням сторін
 - До **9 вихідних зображень** на запит
- До **1 reference-зображення** на запит редагування
- Підтримувані aspect ratio: `1:1`, `16:9`, `4:3`, `3:2`, `2:3`, `3:4`, `9:16`, `21:9`
+- До **1 референсного зображення** на запит редагування
+- Підтримувані співвідношення сторін: `1:1`, `16:9`, `4:3`, `3:2`, `2:3`, `3:4`, `9:16`, `21:9`

-Щоб використовувати MiniMax для генерації зображень, задайте його як провайдера генерації зображень:
+Щоб використовувати MiniMax для генерації зображень, встановіть його як провайдера генерації зображень:

 ```json5
 {
@ -236,36 +236,33 @@ Plugin MiniMax реєструє модель `image-01` для інструме
 }
 ```

-Plugin використовує той самий `MINIMAX_API_KEY` або OAuth auth, що й текстові моделі. Додаткова конфігурація не потрібна, якщо MiniMax уже налаштовано.
+Плагін використовує той самий `MINIMAX_API_KEY` або OAuth-автентифікацію, що й текстові моделі. Додаткова конфігурація не потрібна, якщо MiniMax уже налаштовано.

 І `minimax`, і `minimax-portal` реєструють `image_generate` з тією самою
-моделлю `image-01`. Конфігурації з API key використовують `MINIMAX_API_KEY`; конфігурації з OAuth можуть
-замість цього використовувати вбудований шлях auth `minimax-portal`.
+моделлю `image-01`. Налаштування з API key використовують `MINIMAX_API_KEY`; налаштування OAuth можуть натомість використовувати
+вбудований шлях автентифікації `minimax-portal`.

-Коли онбординг або налаштування з API key записує явні записи `models.providers.minimax`,
+Коли онбординг або налаштування API key записує явні записи `models.providers.minimax`,
 OpenClaw матеріалізує `MiniMax-M2.7` і
-`MiniMax-M2.7-highspeed` з `input: ["text", "image"]`.
-
-Сам вбудований bundled-каталог текстових моделей MiniMax залишається метаданими лише для тексту, доки
-не з’явиться явна конфігурація провайдера. Розуміння зображень відкривається окремо
-через медіапровайдер `MiniMax-VL-01`, що належить Plugin-у.
+`MiniMax-M2.7-highspeed` як текстові чат-моделі. Розпізнавання зображень
+експонується окремо через медіапровайдера `MiniMax-VL-01`, що належить плагіну.

 <Note>
-Див. [Генерація зображень](/uk/tools/image-generation) щодо спільних параметрів інструмента, вибору провайдера та поведінки failover.
+Див. [Генерація зображень](/uk/tools/image-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover.
 </Note>

 ### Генерація музики

-Вбудований Plugin `minimax` також реєструє генерацію музики через спільний
+Вбудований плагін `minimax` також реєструє генерацію музики через спільний
 інструмент `music_generate`.

 - Типова музична модель: `minimax/music-2.5+`
- Також підтримує `minimax/music-2.5` і `minimax/music-2.0`
- Керування prompt: `lyrics`, `instrumental`, `durationSeconds`
+- Також підтримуються `minimax/music-2.5` і `minimax/music-2.0`
+- Керування підказкою: `lyrics`, `instrumental`, `durationSeconds`
 - Формат виводу: `mp3`
- Запуски на основі сесій від’єднуються через спільний потік task/status, включно з `action: "status"`
+- Запуски з підтримкою сесій від’єднуються через спільний потік завдань/статусу, зокрема `action: "status"`

-Щоб використовувати MiniMax як типового провайдера музики:
+Щоб використовувати MiniMax як типовий музичний провайдер:

 ```json5
 {
@ -280,19 +277,19 @@ OpenClaw матеріалізує `MiniMax-M2.7` і
 ```

 <Note>
-Див. [Генерація музики](/uk/tools/music-generation) щодо спільних параметрів інструмента, вибору провайдера та поведінки failover.
+Див. [Генерація музики](/uk/tools/music-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover.
 </Note>

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

-Вбудований Plugin `minimax` також реєструє генерацію відео через спільний
+Вбудований плагін `minimax` також реєструє генерацію відео через спільний
 інструмент `video_generate`.

 - Типова відеомодель: `minimax/MiniMax-Hailuo-2.3`
- Режими: text-to-video і потоки з одним reference-зображенням
+- Режими: перетворення тексту на відео та потоки з одним референсним зображенням
 - Підтримує `aspectRatio` і `resolution`

-Щоб використовувати MiniMax як типового провайдера відео:
+Щоб використовувати MiniMax як типовий відеопровайдер:

 ```json5
 {
@ -307,12 +304,12 @@ OpenClaw матеріалізує `MiniMax-M2.7` і
 ```

 <Note>
-Див. [Генерація відео](/uk/tools/video-generation) щодо спільних параметрів інструмента, вибору провайдера та поведінки failover.
+Див. [Генерація відео](/uk/tools/video-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover.
 </Note>

-### Розуміння зображень
+### Розпізнавання зображень

-Plugin MiniMax реєструє розуміння зображень окремо від текстового
+Плагін MiniMax реєструє розпізнавання зображень окремо від текстового
 каталогу:

 | ID провайдера    | Типова модель зображень |
@ -320,25 +317,25 @@ Plugin MiniMax реєструє розуміння зображень окрем
 | `minimax`        | `MiniMax-VL-01`         |
 | `minimax-portal` | `MiniMax-VL-01`         |

-Саме тому автоматична маршрутизація медіа може використовувати розуміння зображень MiniMax навіть
-тоді, коли bundled-каталог текстового провайдера все ще показує лише текстові посилання на чат M2.7.
+Саме тому автоматична маршрутизація медіа може використовувати розпізнавання зображень MiniMax навіть
+коли вбудований каталог текстових провайдерів усе ще показує лише текстові чат-посилання M2.7.

 ### Вебпошук

-Plugin MiniMax також реєструє `web_search` через API пошуку MiniMax Coding Plan.
+Плагін MiniMax також реєструє `web_search` через API пошуку MiniMax Coding Plan.

 - ID провайдера: `minimax`
- Структуровані результати: заголовки, URL, фрагменти, пов’язані запити
- Бажана змінна середовища: `MINIMAX_CODE_PLAN_KEY`
- Прийнятий псевдонім env: `MINIMAX_CODING_API_KEY`
- Fallback для сумісності: `MINIMAX_API_KEY`, коли він уже вказує на токен coding-plan
- Повторне використання регіону: `plugins.entries.minimax.config.webSearch.region`, потім `MINIMAX_API_HOST`, потім base URL провайдерів MiniMax
- Пошук залишається на ID провайдера `minimax`; конфігурація OAuth CN/global усе ще може непрямо спрямовувати регіон через `models.providers.minimax-portal.baseUrl`
+- Структуровані результати: заголовки, URL-адреси, фрагменти, пов’язані запити
+- Пріоритетна змінна середовища: `MINIMAX_CODE_PLAN_KEY`
+- Псевдонім змінної середовища, що також приймається: `MINIMAX_CODING_API_KEY`
+- Резервна сумісність: `MINIMAX_API_KEY`, якщо він уже вказує на токен coding-plan
+- Повторне використання регіону: `plugins.entries.minimax.config.webSearch.region`, потім `MINIMAX_API_HOST`, потім базові URL-адреси провайдера MiniMax
+- Пошук залишається на ID провайдера `minimax`; налаштування OAuth CN/global однаково можуть опосередковано спрямовувати регіон через `models.providers.minimax-portal.baseUrl`

-Конфігурація міститься в `plugins.entries.minimax.config.webSearch.*`.
+Конфігурація розміщується в `plugins.entries.minimax.config.webSearch.*`.

 <Note>
-Повну конфігурацію та використання вебпошуку див. у [MiniMax Search](/uk/tools/minimax-search).
+Див. [Пошук MiniMax](/uk/tools/minimax-search) для повної конфігурації та використання вебпошуку.
 </Note>

 ## Розширена конфігурація
@ -347,27 +344,27 @@ Plugin MiniMax також реєструє `web_search` через API пошу
  <Accordion title="Параметри конфігурації">
    | Параметр | Опис |
    | --- | --- |
-    | `models.providers.minimax.baseUrl` | Надавайте перевагу `https://api.minimax.io/anthropic` (сумісний з Anthropic); `https://api.minimax.io/v1` необов’язковий для payload, сумісних з OpenAI |
-    | `models.providers.minimax.api` | Надавайте перевагу `anthropic-messages`; `openai-completions` необов’язковий для payload, сумісних з OpenAI |
+    | `models.providers.minimax.baseUrl` | Рекомендовано `https://api.minimax.io/anthropic` (сумісний з Anthropic); `https://api.minimax.io/v1` є додатковим варіантом для payload, сумісних з OpenAI |
+    | `models.providers.minimax.api` | Рекомендовано `anthropic-messages`; `openai-completions` є додатковим варіантом для payload, сумісних з OpenAI |
    | `models.providers.minimax.apiKey` | API key MiniMax (`MINIMAX_API_KEY`) |
-    | `models.providers.minimax.models` | Визначайте `id`, `name`, `reasoning`, `contextWindow`, `maxTokens`, `cost` |
-    | `agents.defaults.models` | Моделі-псевдоніми, які ви хочете додати до allowlist |
-    | `models.mode` | Залишайте `merge`, якщо хочете додати MiniMax поряд із вбудованими |
+    | `models.providers.minimax.models` | Визначає `id`, `name`, `reasoning`, `contextWindow`, `maxTokens`, `cost` |
+    | `agents.defaults.models` | Псевдоніми моделей, які ви хочете додати до allowlist |
+    | `models.mode` | Залиште `merge`, якщо хочете додати MiniMax поряд із вбудованими |
  </Accordion>

  <Accordion title="Типові значення thinking">
-    Для `api: "anthropic-messages"` OpenClaw інжектує `thinking: { type: "disabled" }`, якщо thinking уже не задано явно в params/config.
+    Для `api: "anthropic-messages"` OpenClaw додає `thinking: { type: "disabled" }`, якщо thinking вже не задано явно в params/config.

-    Це не дає streaming-endpoint-у MiniMax виводити `reasoning_content` у delta-чанках у стилі OpenAI, що призвело б до витоку внутрішнього reasoning у видимий вивід.
+    Це запобігає тому, щоб потоковий ендпоінт MiniMax надсилав `reasoning_content` у дельта-чанках у стилі OpenAI, що призводило б до витоку внутрішніх міркувань у видимий вивід.

  </Accordion>

  <Accordion title="Швидкий режим">
-    `/fast on` або `params.fastMode: true` переписує `MiniMax-M2.7` на `MiniMax-M2.7-highspeed` на шляху потоку, сумісного з Anthropic.
+    `/fast on` або `params.fastMode: true` переписує `MiniMax-M2.7` на `MiniMax-M2.7-highspeed` у сумісному з Anthropic потоковому шляху.
  </Accordion>

-  <Accordion title="Приклад fallback">
-    **Найкраще для:** зберігати вашу найсильнішу модель останнього покоління як primary і переходити на MiniMax M2.7 у разі збою. У прикладі нижче як конкретний primary використано Opus; замініть його на бажану primary-модель останнього покоління.
+  <Accordion title="Приклад failover">
+    **Найкраще підходить для:** використання вашої найсильнішої актуальної моделі нового покоління як основної з переходом на MiniMax M2.7 у разі збою. У прикладі нижче Opus використано як конкретну основну модель; замініть її на бажану вами актуальну основну модель нового покоління.

    ```json5
    {
@ -389,46 +386,46 @@ Plugin MiniMax також реєструє `web_search` через API пошу

  </Accordion>

-  <Accordion title="Подробиці використання Coding Plan">
-    - API використання Coding Plan: `https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains` (потребує ключа coding plan).
-    - OpenClaw нормалізує використання MiniMax coding-plan до того самого відображення `% left`, що й в інших провайдерів. Сирі поля MiniMax `usage_percent` / `usagePercent` означають залишкову квоту, а не використану, тому OpenClaw інвертує їх. Якщо присутні поля з підрахунками, вони мають пріоритет.
-    - Коли API повертає `model_remains`, OpenClaw надає перевагу запису chat-моделі, за потреби виводить мітку вікна з `start_time` / `end_time` і включає вибрану назву моделі до мітки plan, щоб вікна coding-plan було легше розрізняти.
-    - Знімки використання трактують `minimax`, `minimax-cn` і `minimax-portal` як ту саму поверхню квоти MiniMax і надають перевагу збереженому OAuth MiniMax, перш ніж переходити до env vars ключа Coding Plan.
+  <Accordion title="Деталі використання Coding Plan">
+    - API використання Coding Plan: `https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains` (потрібен ключ coding plan).
+    - OpenClaw нормалізує використання coding plan MiniMax до того самого відображення `% left`, що й в інших провайдерів. Сирі поля `usage_percent` / `usagePercent` у MiniMax означають залишкову квоту, а не використану квоту, тому OpenClaw інвертує їх. Поля на основі підрахунку мають пріоритет, якщо вони доступні.
+    - Коли API повертає `model_remains`, OpenClaw надає перевагу запису chat-моделі, за потреби виводить мітку вікна з `start_time` / `end_time` і включає вибрану назву моделі до мітки плану, щоб вікна coding plan було легше розрізняти.
+    - Знімки використання розглядають `minimax`, `minimax-cn` і `minimax-portal` як одну й ту саму поверхню квоти MiniMax та надають перевагу збереженому OAuth MiniMax перед переходом до змінних середовища з ключем Coding Plan.
  </Accordion>
 </AccordionGroup>

 ## Примітки

- Посилання на моделі відповідають шляху auth:
+- Посилання на моделі відповідають шляху автентифікації:
  - Налаштування з API key: `minimax/<model>`
  - Налаштування з OAuth: `minimax-portal/<model>`
- Типова chat-модель: `MiniMax-M2.7`
- Альтернативна chat-модель: `MiniMax-M2.7-highspeed`
- Онбординг і пряме налаштування з API key записують явні визначення моделей з `input: ["text", "image"]` для обох варіантів M2.7
- Bundled-каталог провайдерів наразі відкриває посилання на chat як метадані лише для тексту, доки не з’явиться явна конфігурація провайдера MiniMax
+- Типова чат-модель: `MiniMax-M2.7`
+- Альтернативна чат-модель: `MiniMax-M2.7-highspeed`
+- Онбординг і пряме налаштування API key записують визначення лише текстових моделей для обох варіантів M2.7
+- Для розпізнавання зображень використовується медіапровайдер `MiniMax-VL-01`, що належить плагіну
 - Оновіть значення цін у `models.json`, якщо вам потрібне точне відстеження вартості
- Використовуйте `openclaw models list`, щоб підтвердити поточний id провайдера, а потім перемкніть його через `openclaw models set minimax/MiniMax-M2.7` або `openclaw models set minimax-portal/MiniMax-M2.7`
+- Використовуйте `openclaw models list`, щоб підтвердити поточний ID провайдера, а потім перемкніться за допомогою `openclaw models set minimax/MiniMax-M2.7` або `openclaw models set minimax-portal/MiniMax-M2.7`

 <Tip>
 Реферальне посилання для MiniMax Coding Plan (знижка 10%): [MiniMax Coding Plan](https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link)
 </Tip>

 <Note>
-Правила провайдерів див. у [Провайдери моделей](/uk/concepts/model-providers).
+Див. [Провайдери моделей](/uk/concepts/model-providers) для правил провайдерів.
 </Note>

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

 <AccordionGroup>
-  <Accordion title='"Unknown model: minimax/MiniMax-M2.7"'>
-    Зазвичай це означає, що **провайдер MiniMax не налаштовано** (немає відповідного запису провайдера і не знайдено профілю auth/env key MiniMax). Виправлення для цього виявлення є у **2026.1.12**. Виправити можна так:
+  <Accordion title='"Невідома модель: minimax/MiniMax-M2.7"'>
+    Зазвичай це означає, що **провайдер MiniMax не налаштований** (немає відповідного запису провайдера і не знайдено профілю автентифікації/env key MiniMax). Виправлення для цього виявлення є у **2026.1.12**. Виправити можна так:

-    - Оновіться до **2026.1.12** (або запускайте з вихідного `main`), а потім перезапустіть gateway.
-    - Запустіть `openclaw configure` і виберіть варіант auth **MiniMax**, або
-    - Додайте вручну відповідний блок `models.providers.minimax` або `models.providers.minimax-portal`, або
-    - Задайте `MINIMAX_API_KEY`, `MINIMAX_OAUTH_TOKEN` або профіль auth MiniMax, щоб можна було інжектувати відповідний провайдер.
+    - Оновіться до **2026.1.12** (або запустіть із вихідного коду `main`), а потім перезапустіть Gateway.
+    - Запустіть `openclaw configure` і виберіть параметр автентифікації **MiniMax**, або
+    - Додайте відповідний блок `models.providers.minimax` або `models.providers.minimax-portal` вручну, або
+    - Задайте `MINIMAX_API_KEY`, `MINIMAX_OAUTH_TOKEN` або профіль автентифікації MiniMax, щоб можна було інжектувати відповідний провайдер.

-    Переконайтеся, що id моделі **чутливий до регістру**:
+    Переконайтеся, що ID моделі **чутливий до регістру**:

    - Шлях API key: `minimax/MiniMax-M2.7` або `minimax/MiniMax-M2.7-highspeed`
    - Шлях OAuth: `minimax-portal/MiniMax-M2.7` або `minimax-portal/MiniMax-M2.7-highspeed`
@ -443,7 +440,7 @@ Plugin MiniMax також реєструє `web_search` через API пошу
 </AccordionGroup>

 <Note>
-Додаткова допомога: [Усунення несправностей](/uk/help/troubleshooting) і [FAQ](/uk/help/faq).
+Більше допомоги: [Усунення несправностей](/uk/help/troubleshooting) і [FAQ](/uk/help/faq).
 </Note>

 ## Пов’язане
@ -453,15 +450,15 @@ Plugin MiniMax також реєструє `web_search` через API пошу
    Вибір провайдерів, посилань на моделі та поведінки failover.
  </Card>
  <Card title="Генерація зображень" href="/uk/tools/image-generation" icon="image">
-    Спільні параметри інструмента зображень і вибір провайдера.
+    Спільні параметри інструмента для зображень і вибір провайдера.
  </Card>
  <Card title="Генерація музики" href="/uk/tools/music-generation" icon="music">
-    Спільні параметри інструмента музики і вибір провайдера.
+    Спільні параметри музичного інструмента та вибір провайдера.
  </Card>
  <Card title="Генерація відео" href="/uk/tools/video-generation" icon="video">
-    Спільні параметри інструмента відео і вибір провайдера.
+    Спільні параметри відеоінструмента та вибір провайдера.
  </Card>
-  <Card title="MiniMax Search" href="/uk/tools/minimax-search" icon="magnifying-glass">
+  <Card title="Пошук MiniMax" href="/uk/tools/minimax-search" icon="magnifying-glass">
    Конфігурація вебпошуку через MiniMax Coding Plan.
  </Card>
  <Card title="Усунення несправностей" href="/uk/help/troubleshooting" icon="wrench">