chore(i18n): refresh uk translations

2026-04-21 06:15:13 +00:00 · 2026-04-21 06:15:13 +00:00 · 0990badf89
commit 0990badf89
parent 6d178e5225
7 changed files with 2249 additions and 2274 deletions
--- a/docs/uk/concepts/active-memory.md
+++ b/docs/uk/concepts/active-memory.md
@ -1,27 +1,27 @@
 ---
 read_when:
    - Ви хочете зрозуміти, для чого потрібна Active Memory
-    - Ви хочете ввімкнути Active Memory для розмовного агента
+    - Ви хочете увімкнути Active Memory для розмовного агента
    - Ви хочете налаштувати поведінку Active Memory, не вмикаючи її всюди
-summary: Підлеглий агент блокувальної пам’яті, що належить Plugin, який впроваджує релевантну пам’ять в інтерактивні сеанси чату
+summary: Плагінний блокувальний під-агент пам’яті, який впроваджує релевантну пам’ять в інтерактивні сеанси чату
 title: Active Memory
 x-i18n:
-    generated_at: "2026-04-18T19:33:21Z"
+    generated_at: "2026-04-21T06:04:48Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 30fb5d12f1f2e3845d95b90925814faa5c84240684ebd4325c01598169088432
+    source_hash: 1a41ec10a99644eda5c9f73aedb161648e0a5c9513680743ad92baa57417d9ce
    source_path: concepts/active-memory.md
    workflow: 15
 ---

 # Active Memory

-Active Memory — це необов’язковий підлеглий агент блокувальної пам’яті, що належить Plugin і запускається
-перед основною відповіддю для відповідних розмовних сеансів.
+Active Memory — це необов’язковий плагінний блокувальний під-агент пам’яті, який запускається
+перед основною відповіддю для придатних розмовних сеансів.

-Він існує тому, що більшість систем пам’яті є функціональними, але реактивними. Вони покладаються на
-основного агента, який має вирішити, коли шукати в пам’яті, або на те, що користувач скаже щось
-на кшталт «запам’ятай це» чи «пошукай у пам’яті». На той момент мить, коли пам’ять
+Він існує, тому що більшість систем пам’яті є потужними, але реактивними. Вони покладаються на
+основного агента, який має вирішити, коли шукати в пам’яті, або на користувача, який має сказати щось
+на кшталт «запам’ятай це» чи «пошукай у пам’яті». До цього моменту мить, коли пам’ять
 могла б зробити відповідь природною, уже минула.

 Active Memory дає системі одну обмежену можливість підняти релевантну пам’ять
@ -29,8 +29,8 @@ Active Memory дає системі одну обмежену можливіст

 ## Вставте це у свого агента

-Вставте це у свого агента, якщо хочете ввімкнути Active Memory із
-самодостатнім, безпечним за замовчуванням налаштуванням:
+Вставте це у свого агента, якщо хочете ввімкнути Active Memory за допомогою
+самодостатньої конфігурації з безпечними значеннями за замовчуванням:

 ```json5
 {
@ -56,9 +56,10 @@ Active Memory дає системі одну обмежену можливіст
 }
 ```

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

 Після цього перезапустіть Gateway:

@ -66,7 +67,7 @@ Active Memory дає системі одну обмежену можливіст
 openclaw gateway
 ```

-Щоб переглядати це наживо в розмові:
+Щоб переглянути це наживо в розмові:

 ```text
 /verbose on
@ -75,11 +76,11 @@ openclaw gateway

 ## Увімкнення active memory

-Найбезпечніше налаштування таке:
+Найбезпечніше налаштування:

-1. увімкнути Plugin
+1. увімкнути плагін
 2. націлити його на одного розмовного агента
-3. залишити журналювання ввімкненим лише на час налаштування
+3. залишати журналювання увімкненим лише під час налаштування

 Почніть із цього в `openclaw.json`:

@ -114,24 +115,24 @@ openclaw gateway

 Що це означає:

- `plugins.entries.active-memory.enabled: true` вмикає Plugin
- `config.agents: ["main"]` підключає до active memory лише агента `main`
- `config.allowedChatTypes: ["direct"]` за замовчуванням залишає active memory увімкненою лише для сеансів у стилі прямих повідомлень
- якщо `config.model` не задано, active memory спочатку успадковує модель поточного сеансу
- `config.modelFallback` за бажанням задає вашу власну резервну provider/model для відновлення пам’яті
- `config.promptStyle: "balanced"` використовує стандартний універсальний стиль prompt для режиму `recent`
- active memory усе одно запускається лише у відповідних інтерактивних постійних чат-сеансах
+- `plugins.entries.active-memory.enabled: true` вмикає плагін
+- `config.agents: ["main"]` підключає до Active Memory лише агента `main`
+- `config.allowedChatTypes: ["direct"]` за замовчуванням залишає Active Memory увімкненим лише для сеансів у стилі прямих повідомлень
+- якщо `config.model` не задано, Active Memory спочатку успадковує модель поточного сеансу
+- `config.modelFallback` за потреби надає власну резервну модель постачальника/модель для відновлення пам’яті
+- `config.promptStyle: "balanced"` використовує типовий універсальний стиль підказки для режиму `recent`
+- Active Memory усе одно запускається лише в придатних інтерактивних постійних чат-сеансах

 ## Рекомендації щодо швидкодії

-Найпростіше налаштування — залишити `config.model` незаданим і дозволити Active Memory використовувати
-ту саму модель, яку ви вже використовуєте для звичайних відповідей. Це найнадійніша поведінка за замовчуванням,
-оскільки вона дотримується ваших поточних налаштувань provider, авторизації та моделі.
+Найпростіше налаштування — залишити `config.model` незаданим і дозволити Active Memory
+використовувати ту саму модель, яку ви вже використовуєте для звичайних відповідей. Це найбезпечніша типова поведінка,
+оскільки вона дотримується ваших наявних уподобань щодо постачальника, авторизації та моделі.

-Якщо ви хочете, щоб Active Memory здавалася швидшою, використовуйте виділену inference-модель
-замість запозичення основної моделі чату.
+Якщо ви хочете, щоб Active Memory працювала швидше, використовуйте виділену inference-модель
+замість запозичення основної чат-моделі.

-Приклад налаштування зі швидким provider:
+Приклад конфігурації зі швидким постачальником:

 ```json5
 models: {
@ -158,22 +159,22 @@ plugins: {

 Варіанти швидких моделей, які варто розглянути:

- `cerebras/gpt-oss-120b` для швидкої виділеної моделі відновлення пам’яті з вузькою поверхнею інструментів
- ваша звичайна модель сеансу, якщо залишити `config.model` незаданим
- низьколатентна резервна модель, така як `google/gemini-3-flash`, якщо ви хочете окрему модель відновлення пам’яті без зміни основної моделі чату
+- `cerebras/gpt-oss-120b` як швидку виділену модель відновлення пам’яті з вузькою поверхнею інструментів
+- вашу звичайну модель сеансу, якщо залишити `config.model` незаданим
+- резервну модель з низькою затримкою, таку як `google/gemini-3-flash`, якщо ви хочете окрему модель відновлення пам’яті без зміни основної чат-моделі

-Чому Cerebras є сильним варіантом, орієнтованим на швидкість, для Active Memory:
+Чому Cerebras є сильним варіантом для Active Memory, орієнтованим на швидкодію:

 - поверхня інструментів Active Memory вузька: вона викликає лише `memory_search` і `memory_get`
 - якість відновлення пам’яті важлива, але затримка важливіша, ніж для основного шляху відповіді
- окремий швидкий provider дозволяє не прив’язувати затримку відновлення пам’яті до вашого основного chat provider
+- виділений швидкий постачальник дозволяє не прив’язувати затримку відновлення пам’яті до вашого основного чат-постачальника

-Якщо ви не хочете окрему оптимізовану на швидкість модель, залиште `config.model` незаданим
+Якщо вам не потрібна окрема модель, оптимізована під швидкість, залиште `config.model` незаданим
 і дозвольте Active Memory успадковувати модель поточного сеансу.

 ### Налаштування Cerebras

-Додайте запис provider ось так:
+Додайте запис постачальника на кшталт цього:

 ```json5
 models: {
@ -188,7 +189,7 @@ models: {
 }
 ```

-Потім націльте на нього Active Memory:
+Потім спрямуйте на нього Active Memory:

 ```json5
 plugins: {
@ -205,17 +206,17 @@ plugins: {

 Застереження:

- переконайтеся, що ключ API Cerebras справді має доступ до вибраної вами моделі, оскільки сама лише видимість `/v1/models` не гарантує доступу до `chat/completions`
+- переконайтеся, що ключ API Cerebras справді має доступ до вибраної вами моделі, тому що сама лише видимість `/v1/models` не гарантує доступу до `chat/completions`

 ## Як це побачити

-Active memory впроваджує прихований ненадійний префікс prompt для моделі. Вона
+Active Memory впроваджує прихований недовірений префікс підказки для моделі. Вона
 не показує сирі теги `<active_memory_plugin>...</active_memory_plugin>` у
-звичайній відповіді, видимій клієнту.
+звичайній видимій клієнту відповіді.

 ## Перемикач сеансу

-Використовуйте команду Plugin, коли хочете призупинити або відновити active memory для
+Використовуйте команду плагіна, якщо хочете призупинити або відновити Active Memory для
 поточного чат-сеансу без редагування конфігурації:

 ```text
@ -224,11 +225,11 @@ Active memory впроваджує прихований ненадійний п
 /active-memory on
 ```

-Це діє на рівні сеансу. Воно не змінює
-`plugins.entries.active-memory.enabled`, націлювання агента чи іншу глобальну
+Це прив’язано до сеансу. Це не змінює
+`plugins.entries.active-memory.enabled`, націлювання на агента чи іншу глобальну
 конфігурацію.

-Якщо ви хочете, щоб команда записувала конфігурацію та призупиняла або відновлювала active memory для
+Якщо ви хочете, щоб команда записувала конфігурацію та призупиняла або відновлювала Active Memory для
 всіх сеансів, використовуйте явну глобальну форму:

 ```text
@ -238,10 +239,10 @@ Active memory впроваджує прихований ненадійний п
 ```

 Глобальна форма записує `plugins.entries.active-memory.config.enabled`. Вона залишає
-`plugins.entries.active-memory.enabled` увімкненим, щоб команда залишалася доступною для
-подальшого повторного ввімкнення active memory.
+`plugins.entries.active-memory.enabled` увімкненим, щоб команда й надалі була доступною для
+повторного ввімкнення Active Memory пізніше.

-Якщо ви хочете побачити, що робить active memory у живому сеансі, увімкніть
+Якщо ви хочете бачити, що робить Active Memory у живому сеансі, увімкніть
 перемикачі сеансу, які відповідають потрібному вам виводу:

 ```text
@ -251,15 +252,16 @@ Active memory впроваджує прихований ненадійний п

 Коли їх увімкнено, OpenClaw може показувати:

- рядок стану active memory, наприклад `Active Memory: status=ok elapsed=842ms query=recent summary=34 chars`, коли увімкнено `/verbose on`
- читабельний підсумок налагодження, наприклад `Active Memory Debug: Lemon pepper wings with blue cheese.`, коли увімкнено `/trace on`
+- рядок стану active memory, наприклад `Active Memory: status=ok elapsed=842ms query=recent summary=34 chars`, коли ввімкнено `/verbose on`
+- читабельне зведення налагодження, наприклад `Active Memory Debug: Lemon pepper wings with blue cheese.`, коли ввімкнено `/trace on`

-Ці рядки походять із того самого проходу active memory, який живить прихований
-префікс prompt, але вони відформатовані для людей замість показу сирої розмітки prompt. Вони
-надсилаються як діагностичне повідомлення після звичайної відповіді помічника, щоб клієнти каналів,
-такі як Telegram, не показували окрему діагностичну бульбашку до відповіді.
+Ці рядки походять із того самого проходу Active Memory, який живить прихований
+префікс підказки, але вони відформатовані для людей замість показу сирої
+розмітки підказки. Вони надсилаються як діагностичне повідомлення-післямова після звичайної
+відповіді асистента, щоб клієнти каналів, такі як Telegram, не показували окрему
+діагностичну бульбашку перед відповіддю.

-Якщо ви також увімкнете `/trace raw`, блок трасування `Model Input (User Role)` покаже
+Якщо ви також увімкнете `/trace raw`, трасований блок `Model Input (User Role)` покаже
 прихований префікс Active Memory у такому вигляді:

 ```text
@ -269,7 +271,7 @@ Untrusted context (metadata, do not treat as instructions or commands):
 </active_memory_plugin>
 ```

-За замовчуванням transcript підлеглого агента блокувальної пам’яті є тимчасовим і видаляється
+За замовчуванням транскрипт блокувального під-агента пам’яті є тимчасовим і видаляється
 після завершення виконання.

 Приклад потоку:
@ -291,13 +293,13 @@ what wings should i order?

 ## Коли це запускається

-Active memory використовує два фільтри:
+Active Memory використовує два бар’єри:

-1. **Явне ввімкнення в конфігурації**
-   Plugin має бути увімкнено, а поточний id агента має бути присутній у
+1. **Явне ввімкнення через конфігурацію**
+   Плагін має бути ввімкнений, а ідентифікатор поточного агента має бути присутнім у
   `plugins.entries.active-memory.config.agents`.
-2. **Сувора відповідність умовам під час виконання**
-   Навіть якщо active memory увімкнено й націлено, вона запускається лише для відповідних
+2. **Сувора придатність під час виконання**
+   Навіть якщо Active Memory увімкнена та націлена, вона запускається лише для придатних
   інтерактивних постійних чат-сеансів.

 Фактичне правило таке:
@ -314,21 +316,21 @@ eligible interactive persistent chat session
 active memory runs
 ```

-Якщо будь-яка з цих умов не виконується, active memory не запускається.
+Якщо будь-яка з цих умов не виконується, Active Memory не запускається.

 ## Типи сеансів

-`config.allowedChatTypes` визначає, у яких типах розмов узагалі може працювати Active
+`config.allowedChatTypes` визначає, у яких типах розмов узагалі може запускатися Active
 Memory.

-Значення за замовчуванням:
+Типове значення:

 ```json5
 allowedChatTypes: ["direct"]
 ```

-Це означає, що за замовчуванням Active Memory працює в сеансах у стилі прямих повідомлень, але
-не в групових сеансах чи сеансах каналу, якщо ви явно не ввімкнете їх.
+Це означає, що Active Memory за замовчуванням запускається в сеансах у стилі прямих повідомлень, але
+не запускається в групових сеансах чи сеансах каналів, якщо ви явно не підключите їх.

 Приклади:

@ -344,44 +346,44 @@ allowedChatTypes: ["direct", "group"]
 allowedChatTypes: ["direct", "group", "channel"]
 ```

-## Де це працює
+## Де це запускається

-Active memory — це функція покращення розмови, а не загальноплатформна
-можливість inference.
+Active Memory — це функція збагачення розмови, а не загальноплатформна
+inference-функція.

-| Поверхня                                                           | Active Memory працює?                                   |
-| ------------------------------------------------------------------ | ------------------------------------------------------- |
-| Постійні сеанси Control UI / вебчату                               | Так, якщо Plugin увімкнено і агент націлено            |
-| Інші інтерактивні сеанси каналів на тому самому шляху постійного чату | Так, якщо Plugin увімкнено і агент націлено            |
-| Headless одноразові запуски                                        | Ні                                                      |
-| Heartbeat/фонові запуски                                           | Ні                                                      |
-| Загальні внутрішні шляхи `agent-command`                           | Ні                                                      |
-| Виконання підлеглих агентів/внутрішніх допоміжних засобів          | Ні                                                      |
+| Поверхня                                                             | Active Memory запускається?                             |
+| -------------------------------------------------------------------- | ------------------------------------------------------- |
+| Постійні сеанси Control UI / вебчату                                 | Так, якщо плагін увімкнено і агент націлено             |
+| Інші інтерактивні сеанси каналів на тому самому шляху постійного чату | Так, якщо плагін увімкнено і агент націлено             |
+| Безголові одноразові запуски                                         | Ні                                                      |
+| Запуски Heartbeat/фонові запуски                                     | Ні                                                      |
+| Загальні внутрішні шляхи `agent-command`                             | Ні                                                      |
+| Виконання під-агентів/внутрішніх допоміжних процесів                 | Ні                                                      |

 ## Навіщо це використовувати

 Використовуйте active memory, коли:

- сеанс є постійним і орієнтованим на користувача
- агент має значущу довготривалу пам’ять, у якій можна шукати
- безперервність і персоналізація важливіші за чисту детермінованість prompt
+- сеанс є постійним і призначеним для користувача
+- агент має значущу довгострокову пам’ять для пошуку
+- безперервність і персоналізація важливіші за сиру детермінованість підказок

-Вона особливо добре працює для:
+Це особливо добре працює для:

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

-Вона погано підходить для:
+Це погано підходить для:

 - автоматизації
 - внутрішніх воркерів
 - одноразових API-завдань
- місць, де прихована персоналізація виглядала б неочікувано
+- місць, де прихована персоналізація була б несподіваною

 ## Як це працює

-Структура під час виконання така:
+Форма виконання така:

 ```mermaid
 flowchart LR
@ -392,32 +394,32 @@ flowchart LR
  I --> M["Main Reply"]
 ```

-Підлеглий агент блокувальної пам’яті може використовувати лише:
+Блокувальний під-агент пам’яті може використовувати лише:

 - `memory_search`
 - `memory_get`

-Якщо з’єднання слабке, він має повернути `NONE`.
+Якщо з’єднання слабке, він має повертати `NONE`.

 ## Режими запиту

-`config.queryMode` визначає, яку частину розмови бачить підлеглий агент блокувальної пам’яті.
+`config.queryMode` визначає, який обсяг розмови бачить блокувальний під-агент пам’яті.

-## Стилі prompt
+## Стилі підказок

-`config.promptStyle` визначає, наскільки охоче або суворо підлеглий агент блокувальної пам’яті
+`config.promptStyle` визначає, наскільки охоче або суворо блокувальний під-агент пам’яті
 вирішує, чи повертати пам’ять.

 Доступні стилі:

- `balanced`: універсальний варіант за замовчуванням для режиму `recent`
- `strict`: найменш охочий; найкраще підходить, коли ви хочете якомога менше впливу від сусіднього контексту
- `contextual`: найбільш дружній до безперервності; найкраще підходить, коли історія розмови має мати більше значення
- `recall-heavy`: охочіше піднімає пам’ять за слабшими, але все ще правдоподібними збігами
- `precision-heavy`: агресивно віддає перевагу `NONE`, якщо збіг не є очевидним
- `preference-only`: оптимізований для фаворитів, звичок, рутин, смаків і повторюваних особистих фактів
+- `balanced`: універсальний типовий варіант для режиму `recent`
+- `strict`: найменш охочий; найкращий, коли ви хочете дуже мало впливу від сусіднього контексту
+- `contextual`: найбільш дружній до безперервності; найкращий, коли історія розмови має мати більше значення
+- `recall-heavy`: більш охоче піднімає пам’ять за слабших, але все ще правдоподібних збігів
+- `precision-heavy`: агресивно надає перевагу `NONE`, якщо збіг не є очевидним
+- `preference-only`: оптимізований для улюбленого, звичок, рутин, смаків і повторюваних особистих фактів

-Відображення за замовчуванням, коли `config.promptStyle` не задано:
+Типове зіставлення, коли `config.promptStyle` не задано:

 ```text
 message -> strict
@ -425,7 +427,7 @@ recent -> balanced
 full -> contextual
 ```

-Якщо ви явно задаєте `config.promptStyle`, саме це перевизначення має пріоритет.
+Якщо ви явно задасте `config.promptStyle`, цей перевизначений варіант матиме пріоритет.

 Приклад:

@ -452,47 +454,47 @@ explicit plugin model
 modelFallback: "google/gemini-3-flash"
 ```

-Якщо не вдається визначити явну, успадковану або налаштовану резервну модель, Active Memory
+Якщо не вдається визначити ані явну, ані успадковану, ані налаштовану резервну модель, Active Memory
 пропускає відновлення пам’яті для цього ходу.

 `config.modelFallbackPolicy` збережено лише як застаріле поле сумісності
 для старіших конфігурацій. Воно більше не змінює поведінку під час виконання.

-## Розширені аварійні варіанти
+## Розширені аварійні обхідні механізми

 Ці параметри навмисно не входять до рекомендованого налаштування.

-`config.thinking` може перевизначити рівень thinking підлеглого агента блокувальної пам’яті:
+`config.thinking` може перевизначити рівень thinking для блокувального під-агента пам’яті:

 ```json5
 thinking: "medium"
 ```

-За замовчуванням:
+Типове значення:

 ```json5
 thinking: "off"
 ```

 Не вмикайте це за замовчуванням. Active Memory працює на шляху відповіді, тож додатковий
-час на thinking напряму збільшує видиму для користувача затримку.
+час на thinking безпосередньо збільшує видиму для користувача затримку.

-`config.promptAppend` додає додаткові інструкції оператора після стандартного prompt Active
+`config.promptAppend` додає додаткові операторські інструкції після типової підказки Active
 Memory і перед контекстом розмови:

 ```json5
 promptAppend: "Prefer stable long-term preferences over one-off events."
 ```

-`config.promptOverride` замінює стандартний prompt Active Memory. OpenClaw
-усе одно додає контекст розмови після нього:
+`config.promptOverride` замінює типову підказку Active Memory. OpenClaw
+усе одно додає контекст розмови після неї:

 ```json5
 promptOverride: "You are a memory search agent. Return NONE or one compact user fact."
 ```

-Налаштування prompt не рекомендується, якщо тільки ви не тестуєте навмисно
-інший контракт відновлення пам’яті. Стандартний prompt налаштовано так, щоб повертати або `NONE`,
+Налаштування підказок не рекомендується, якщо тільки ви навмисно не тестуєте
+інший контракт відновлення пам’яті. Типова підказка налаштована так, щоб повертати або `NONE`,
 або компактний контекст фактів про користувача для основної моделі.

 ### `message`
@ -500,48 +502,48 @@ promptOverride: "You are a memory search agent. Return NONE or one compact user
 Надсилається лише останнє повідомлення користувача.

 ```text
-Лише останнє повідомлення користувача
+Latest user message only
 ```

 Використовуйте це, коли:

- вам потрібна найшвидша поведінка
- вам потрібен найсильніший ухил у бік відновлення сталих уподобань
+- вам потрібна найвища швидкодія
+- вам потрібен найсильніший ухил у бік відновлення стабільних уподобань
 - наступні ходи не потребують контексту розмови

-Рекомендований timeout:
+Рекомендований тайм-аут:

 - починайте приблизно з `3000` до `5000` мс

 ### `recent`

-Надсилається останнє повідомлення користувача плюс невеликий хвіст нещодавньої розмови.
+Надсилається останнє повідомлення користувача разом із невеликим хвостом недавньої розмови.

 ```text
-Хвіст нещодавньої розмови:
+Recent conversation tail:
 user: ...
 assistant: ...
 user: ...

-Останнє повідомлення користувача:
+Latest user message:
 ...
 ```

 Використовуйте це, коли:

- ви хочете кращий баланс між швидкістю та прив’язкою до контексту розмови
- запитання-продовження часто залежать від кількох останніх ходів
+- вам потрібен кращий баланс між швидкодією та прив’язкою до контексту розмови
+- наступні запитання часто залежать від кількох останніх ходів

-Рекомендований timeout:
+Рекомендований тайм-аут:

 - починайте приблизно з `15000` мс

 ### `full`

-Підлеглому агенту блокувальної пам’яті надсилається вся розмова.
+До блокувального під-агента пам’яті надсилається вся розмова.

 ```text
-Повний контекст розмови:
+Full conversation context:
 user: ...
 assistant: ...
 user: ...
@ -551,31 +553,31 @@ user: ...
 Використовуйте це, коли:

 - найвища якість відновлення пам’яті важливіша за затримку
- розмова містить важливі налаштування далеко вище у гілці
+- розмова містить важливу підготовчу інформацію далеко вище в потоці

-Рекомендований timeout:
+Рекомендований тайм-аут:

- суттєво збільшуйте його порівняно з `message` або `recent`
- починайте приблизно з `15000` мс або вище залежно від розміру гілки
+- суттєво збільште його порівняно з `message` або `recent`
+- починайте приблизно з `15000` мс або вище залежно від розміру потоку

-Загалом timeout має збільшуватися разом із розміром контексту:
+Загалом тайм-аут має зростати разом із розміром контексту:

 ```text
 message < recent < full
 ```

-## Збереження transcript
+## Збереження транскриптів

-Запуски підлеглого агента блокувальної пам’яті Active Memory створюють справжній `session.jsonl`
-під час виклику підлеглого агента блокувальної пам’яті.
+Запуски блокувального під-агента пам’яті Active Memory створюють справжній транскрипт `session.jsonl`
+під час виклику блокувального під-агента пам’яті.

-За замовчуванням цей transcript є тимчасовим:
+За замовчуванням цей транскрипт є тимчасовим:

- він записується в тимчасовий каталог
- він використовується лише для запуску підлеглого агента блокувальної пам’яті
+- він записується до тимчасового каталогу
+- він використовується лише для запуску блокувального під-агента пам’яті
 - він видаляється одразу після завершення запуску

-Якщо ви хочете зберігати ці transcript підлеглого агента блокувальної пам’яті на диску для налагодження або
+Якщо ви хочете зберігати ці транскрипти блокувального під-агента пам’яті на диску для налагодження або
 перевірки, явно ввімкніть збереження:

 ```json5
@ -595,8 +597,9 @@ message < recent < full
 }
 ```

-Коли це ввімкнено, active memory зберігає transcript в окремому каталозі в
-теці sessions цільового агента, а не в шляху transcript основної розмови з користувачем.
+Коли це ввімкнено, active memory зберігає транскрипти в окремому каталозі в теці
+сеансів цільового агента, а не в основному шляху транскриптів розмови
+користувача.

 Типова структура концептуально виглядає так:

@ -608,13 +611,13 @@ agents/<agent>/sessions/active-memory/<blocking-memory-sub-agent-session-id>.jso

 Використовуйте це обережно:

- transcript підлеглого агента блокувальної пам’яті можуть швидко накопичуватися в активних сеансах
- режим запиту `full` може дублювати великий обсяг контексту розмови
- ці transcript містять прихований контекст prompt і відновлені спогади
+- транскрипти блокувального під-агента пам’яті можуть швидко накопичуватися в активних сеансах
+- режим запиту `full` може дублювати велику кількість контексту розмови
+- ці транскрипти містять прихований контекст підказки та відновлені спогади

 ## Конфігурація

-Уся конфігурація active memory розташована тут:
+Уся конфігурація active memory розміщується тут:

 ```text
 plugins.entries.active-memory
@ -624,34 +627,34 @@ plugins.entries.active-memory

 | Ключ                        | Тип                                                                                                  | Значення                                                                                               |
 | --------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
-| `enabled`                   | `boolean`                                                                                            | Вмикає сам Plugin                                                                                      |
-| `config.agents`             | `string[]`                                                                                           | Id агентів, які можуть використовувати active memory                                                   |
-| `config.model`              | `string`                                                                                             | Необов’язкове посилання на модель підлеглого агента блокувальної пам’яті; якщо не задано, active memory використовує модель поточного сеансу |
-| `config.queryMode`          | `"message" \| "recent" \| "full"`                                                                    | Визначає, яку частину розмови бачить підлеглий агент блокувальної пам’яті                              |
-| `config.promptStyle`        | `"balanced" \| "strict" \| "contextual" \| "recall-heavy" \| "precision-heavy" \| "preference-only"` | Визначає, наскільки охоче або суворо підлеглий агент блокувальної пам’яті вирішує, чи повертати пам’ять |
-| `config.thinking`           | `"off" \| "minimal" \| "low" \| "medium" \| "high" \| "xhigh" \| "adaptive"`                         | Розширене перевизначення thinking для підлеглого агента блокувальної пам’яті; за замовчуванням `off` для швидкодії |
-| `config.promptOverride`     | `string`                                                                                             | Розширена повна заміна prompt; не рекомендується для звичайного використання                           |
-| `config.promptAppend`       | `string`                                                                                             | Розширені додаткові інструкції, що додаються до стандартного або перевизначеного prompt                |
-| `config.timeoutMs`          | `number`                                                                                             | Жорсткий timeout для підлеглого агента блокувальної пам’яті, обмежений 120000 мс                       |
-| `config.maxSummaryChars`    | `number`                                                                                             | Максимальна загальна кількість символів, дозволена в підсумку active-memory                            |
+| `enabled`                   | `boolean`                                                                                            | Вмикає сам плагін                                                                                      |
+| `config.agents`             | `string[]`                                                                                           | Ідентифікатори агентів, які можуть використовувати active memory                                       |
+| `config.model`              | `string`                                                                                             | Необов’язкове посилання на модель блокувального під-агента пам’яті; якщо не задано, active memory використовує модель поточного сеансу |
+| `config.queryMode`          | `"message" \| "recent" \| "full"`                                                                    | Визначає, який обсяг розмови бачить блокувальний під-агент пам’яті                                     |
+| `config.promptStyle`        | `"balanced" \| "strict" \| "contextual" \| "recall-heavy" \| "precision-heavy" \| "preference-only"` | Визначає, наскільки охоче або суворо блокувальний під-агент пам’яті вирішує, чи повертати пам’ять     |
+| `config.thinking`           | `"off" \| "minimal" \| "low" \| "medium" \| "high" \| "xhigh" \| "adaptive" \| "max"`                | Розширене перевизначення thinking для блокувального під-агента пам’яті; типове значення `off` для швидкодії |
+| `config.promptOverride`     | `string`                                                                                             | Розширена повна заміна підказки; не рекомендується для звичайного використання                         |
+| `config.promptAppend`       | `string`                                                                                             | Розширені додаткові інструкції, додані після типової або перевизначеної підказки                       |
+| `config.timeoutMs`          | `number`                                                                                             | Жорсткий тайм-аут для блокувального під-агента пам’яті, обмежений 120000 мс                            |
+| `config.maxSummaryChars`    | `number`                                                                                             | Максимальна загальна кількість символів, дозволена в зведенні active-memory                            |
 | `config.logging`            | `boolean`                                                                                            | Виводить журнали active memory під час налаштування                                                    |
-| `config.persistTranscripts` | `boolean`                                                                                            | Зберігає transcript підлеглого агента блокувальної пам’яті на диску замість видалення тимчасових файлів |
-| `config.transcriptDir`      | `string`                                                                                             | Відносний каталог transcript підлеглого агента блокувальної пам’яті в теці sessions агента             |
+| `config.persistTranscripts` | `boolean`                                                                                            | Зберігає транскрипти блокувального під-агента пам’яті на диску замість видалення тимчасових файлів    |
+| `config.transcriptDir`      | `string`                                                                                             | Відносний каталог транскриптів блокувального під-агента пам’яті в теці сеансів агента                  |

 Корисні поля для налаштування:

 | Ключ                          | Тип      | Значення                                                      |
 | ----------------------------- | -------- | ------------------------------------------------------------- |
-| `config.maxSummaryChars`      | `number` | Максимальна загальна кількість символів, дозволена в підсумку active-memory |
-| `config.recentUserTurns`      | `number` | Попередні ходи користувача, які слід включати, коли `queryMode` має значення `recent` |
-| `config.recentAssistantTurns` | `number` | Попередні ходи помічника, які слід включати, коли `queryMode` має значення `recent` |
-| `config.recentUserChars`      | `number` | Максимум символів на один нещодавній хід користувача          |
-| `config.recentAssistantChars` | `number` | Максимум символів на один нещодавній хід помічника            |
-| `config.cacheTtlMs`           | `number` | Повторне використання кешу для повторюваних однакових запитів |
+| `config.maxSummaryChars`      | `number` | Максимальна загальна кількість символів, дозволена в зведенні active-memory |
+| `config.recentUserTurns`      | `number` | Попередні ходи користувача, які слід включити, коли `queryMode` має значення `recent` |
+| `config.recentAssistantTurns` | `number` | Попередні ходи асистента, які слід включити, коли `queryMode` має значення `recent` |
+| `config.recentUserChars`      | `number` | Максимум символів на один недавній хід користувача            |
+| `config.recentAssistantChars` | `number` | Максимум символів на один недавній хід асистента              |
+| `config.cacheTtlMs`           | `number` | Повторне використання кешу для повторюваних ідентичних запитів |

 ## Рекомендоване налаштування

-Починайте з `recent`.
+Почніть із `recent`.

 ```json5
 {
@ -673,90 +676,91 @@ plugins.entries.active-memory
 }
 ```

-Якщо ви хочете перевіряти живу поведінку під час налаштування, використовуйте `/verbose on` для
-звичайного рядка стану та `/trace on` для підсумку налагодження active-memory замість
+Якщо ви хочете перевіряти поведінку наживо під час налаштування, використовуйте `/verbose on` для
+звичайного рядка стану та `/trace on` для зведення налагодження active-memory замість
 пошуку окремої команди налагодження active-memory. У чат-каналах ці
-діагностичні рядки надсилаються після основної відповіді помічника, а не до неї.
+діагностичні рядки надсилаються після основної відповіді асистента, а не перед нею.

 Потім переходьте до:

- `message`, якщо вам потрібна менша затримка
- `full`, якщо ви вирішите, що додатковий контекст вартий повільнішого підлеглого агента блокувальної пам’яті
+- `message`, якщо хочете нижчу затримку
+- `full`, якщо вирішите, що додатковий контекст вартий повільнішого блокувального під-агента пам’яті

 ## Налагодження

 Якщо active memory не з’являється там, де ви очікуєте:

-1. Підтвердьте, що Plugin увімкнено в `plugins.entries.active-memory.enabled`.
-2. Підтвердьте, що поточний id агента вказано в `config.agents`.
-3. Підтвердьте, що ви тестуєте через інтерактивний постійний чат-сеанс.
-4. Увімкніть `config.logging: true` і перегляньте журнали Gateway.
-5. Переконайтеся, що сам пошук у пам’яті працює, за допомогою `openclaw memory status --deep`.
+1. Переконайтеся, що плагін увімкнений у `plugins.entries.active-memory.enabled`.
+2. Переконайтеся, що ідентифікатор поточного агента вказаний у `config.agents`.
+3. Переконайтеся, що ви тестуєте через інтерактивний постійний чат-сеанс.
+4. Увімкніть `config.logging: true` і стежте за журналами Gateway.
+5. Переконайтеся, що сам пошук пам’яті працює, за допомогою `openclaw memory status --deep`.

 Якщо збіги пам’яті шумні, посильте обмеження:

 - `maxSummaryChars`

-Якщо active memory занадто повільна:
+Якщо active memory працює надто повільно:

 - зменште `queryMode`
 - зменште `timeoutMs`
- зменште кількість нещодавніх ходів
- зменште ліміти символів на один хід
+- зменште кількість недавніх ходів
+- зменште ліміти символів на хід

 ## Поширені проблеми

-### Provider ембедингів неочікувано змінився
+### Постачальник embeddings неочікувано змінився

 Active Memory використовує звичайний конвеєр `memory_search` у
-`agents.defaults.memorySearch`. Це означає, що налаштування provider ембедингів є вимогою лише тоді, коли
-ваше налаштування `memorySearch` потребує ембедингів для потрібної вам поведінки.
+`agents.defaults.memorySearch`. Це означає, що налаштування постачальника embeddings є
+вимогою лише тоді, коли ваша конфігурація `memorySearch` потребує embeddings для бажаної
+поведінки.

 На практиці:

- явне налаштування provider **потрібне**, якщо ви хочете provider, який не
+- явне налаштування постачальника **обов’язкове**, якщо вам потрібен постачальник, який не
  визначається автоматично, наприклад `ollama`
- явне налаштування provider **потрібне**, якщо автовизначення не знаходить
-  жодного придатного provider ембедингів для вашого середовища
- явне налаштування provider **наполегливо рекомендується**, якщо ви хочете детермінований
-  вибір provider замість підходу «перемагає перший доступний»
- явне налаштування provider зазвичай **не потрібне**, якщо автовизначення вже
-  знаходить потрібний вам provider і цей provider стабільний у вашому середовищі розгортання
+- явне налаштування постачальника **обов’язкове**, якщо автоматичне визначення не знаходить
+  жодного придатного постачальника embeddings для вашого середовища
+- явне налаштування постачальника **дуже рекомендоване**, якщо вам потрібен детермінований
+  вибір постачальника замість «перший доступний перемагає»
+- явне налаштування постачальника зазвичай **не обов’язкове**, якщо автоматичне визначення вже
+  знаходить потрібного вам постачальника і цей постачальник є стабільним у вашому розгортанні

-Якщо `memorySearch.provider` не задано, OpenClaw автоматично визначає перший доступний
-provider ембедингів.
+Якщо `memorySearch.provider` не задано, OpenClaw автоматично визначає першого доступного
+постачальника embeddings.

 У реальних розгортаннях це може збивати з пантелику:

- новий доступний ключ API може змінити те, який provider використовує пошук у пам’яті
- одна команда або діагностична поверхня можуть створювати враження, що вибраний provider
-  відрізняється від шляху, який фактично використовується під час живої синхронізації пам’яті або
-  початкового запуску пошуку
- хостингові provider можуть завершуватися помилками квоти або rate-limit, які проявляються
-  лише коли Active Memory починає виконувати запити на відновлення пам’яті перед кожною відповіддю
+- новий доступний API-ключ може змінити те, який постачальник використовується для пошуку в пам’яті
+- одна команда або діагностична поверхня може показувати вибраного постачальника
+  інакше, ніж той шлях, у який ви фактично потрапляєте під час живої синхронізації пам’яті або
+  початкового етапу пошуку
+- хостовані постачальники можуть завершуватися помилками квоти або обмеження швидкості, які проявляються лише
+  після того, як Active Memory починає виконувати пошуки відновлення пам’яті перед кожною відповіддю

-Active Memory усе ще може працювати без ембедингів, коли `memory_search` може працювати
+Active Memory усе ще може працювати без embeddings, коли `memory_search` може працювати
 у деградованому режимі лише з лексичним пошуком, що зазвичай трапляється, коли не вдається
-визначити жодного provider ембедингів.
+визначити жодного постачальника embeddings.

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

 На практиці:

- якщо не вдається визначити provider ембедингів, `memory_search` може деградувати до
+- якщо не вдається визначити жодного постачальника embeddings, `memory_search` може деградувати до
  лише лексичного відновлення
- якщо provider ембедингів визначено, але він завершується помилкою під час виконання, OpenClaw наразі
-  не гарантує лексичний резервний механізм для цього запиту
- якщо вам потрібен детермінований вибір provider, зафіксуйте
+- якщо постачальника embeddings визначено, а потім він завершується помилкою під час виконання, OpenClaw
+  наразі не гарантує лексичний резервний механізм для цього запиту
+- якщо вам потрібен детермінований вибір постачальника, зафіксуйте
  `agents.defaults.memorySearch.provider`
- якщо вам потрібен failover provider у разі помилок виконання, явно налаштуйте
+- якщо вам потрібне перемикання на резервного постачальника у разі помилок під час виконання, явно налаштуйте
  `agents.defaults.memorySearch.fallback`

-Якщо ви залежите від відновлення пам’яті на основі ембедингів, мультимодального індексування або конкретного
-локального/віддаленого provider, явно зафіксуйте provider замість того, щоб покладатися на
-автовизначення.
+Якщо ви залежите від відновлення пам’яті на основі embeddings, мультимодального індексування або конкретного
+локального/віддаленого постачальника, явно зафіксуйте постачальника замість того, щоб покладатися на
+автоматичне визначення.

 Поширені приклади фіксації:

@ -805,8 +809,8 @@ Ollama:
 }
 ```

-Якщо ви очікуєте failover provider у разі помилок виконання, таких як
-вичерпання квоти, недостатньо лише зафіксувати provider. Також налаштуйте явний резервний варіант:
+Якщо ви очікуєте перемикання на резервного постачальника у разі помилок під час виконання, таких як вичерпання квоти,
+лише фіксації постачальника недостатньо. Також налаштуйте явний резервний варіант:

 ```json5
 {
@ -821,31 +825,30 @@ Ollama:
 }
 ```

-### Налагодження проблем із provider
+### Налагодження проблем із постачальником

-Якщо Active Memory повільна, порожня або здається, що неочікувано перемикає provider:
+Якщо Active Memory працює повільно, не повертає результатів або ніби неочікувано перемикає постачальників:

- переглядайте журнали Gateway під час відтворення проблеми; шукайте рядки на кшталт
+- стежте за журналами Gateway під час відтворення проблеми; шукайте рядки на кшталт
  `active-memory: ... start|done`, `memory sync failed (search-bootstrap)` або
-  специфічні для provider помилки ембедингів
- увімкніть `/trace on`, щоб показувати в сеансі підсумок налагодження Active Memory, що належить Plugin
- увімкніть `/verbose on`, якщо ви також хочете бачити звичайний рядок стану
+  помилки embeddings, пов’язані з конкретним постачальником
+- увімкніть `/trace on`, щоб показувати в сеансі зведення налагодження Active Memory, яким володіє плагін
+- увімкніть `/verbose on`, якщо також хочете бачити звичайний рядок стану
  `🧩 Active Memory: ...` після кожної відповіді
- запустіть `openclaw memory status --deep`, щоб перевірити поточний
-  backend пошуку в пам’яті та стан індексу
- перевірте `agents.defaults.memorySearch.provider` і пов’язані auth/config, щоб
-  переконатися, що provider, який ви очікуєте, справді може визначатися під час виконання
- якщо ви використовуєте `ollama`, переконайтеся, що налаштовану модель ембедингів встановлено, наприклад через
-  `ollama list`
+- запустіть `openclaw memory status --deep`, щоб перевірити поточний бекенд пошуку в пам’яті
+  і стан індексу
+- перевірте `agents.defaults.memorySearch.provider` і пов’язану авторизацію/конфігурацію, щоб
+  переконатися, що постачальник, якого ви очікуєте, справді може бути визначений під час виконання
+- якщо ви використовуєте `ollama`, переконайтеся, що налаштовану модель embeddings установлено, наприклад через `ollama list`

 Приклад циклу налагодження:

 ```text
-1. Запустіть Gateway і переглядайте його журнали
-2. У чат-сеансі виконайте /trace on
-3. Надішліть одне повідомлення, яке має активувати Active Memory
-4. Порівняйте видимий у чаті рядок налагодження з рядками в журналі Gateway
-5. Якщо вибір provider неоднозначний, явно зафіксуйте agents.defaults.memorySearch.provider
+1. Start the gateway and watch its logs
+2. In the chat session, run /trace on
+3. Send one message that should trigger Active Memory
+4. Compare the chat-visible debug line with the gateway log lines
+5. If provider choice is ambiguous, pin agents.defaults.memorySearch.provider explicitly
 ```

 Приклад:
@ -863,7 +866,7 @@ Ollama:
 }
 ```

-Або, якщо ви хочете ембединги Gemini:
+Або, якщо ви хочете embeddings Gemini:

 ```json5
 {
@ -877,8 +880,8 @@ Ollama:
 }
 ```

-Після зміни provider перезапустіть Gateway і виконайте новий тест із
-`/trace on`, щоб рядок налагодження Active Memory відображав новий шлях ембедингів.
+Після зміни постачальника перезапустіть Gateway і виконайте новий тест із
+`/trace on`, щоб рядок налагодження Active Memory відображав новий шлях embeddings.

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

--- a/docs/uk/concepts/model-providers.md
+++ b/docs/uk/concepts/model-providers.md
@ -1,41 +1,41 @@
 ---
 read_when:
-    - Потрібен довідник із налаштування моделей для кожного провайдера окремо
-    - Вам потрібні приклади конфігурацій або команд онбордингу CLI для провайдерів моделей
-summary: Огляд провайдерів моделей із прикладами конфігурацій + потоками CLI
-title: Провайдери моделей
+    - Вам потрібен довідник із налаштування моделей для кожного постачальника окремо
+    - Вам потрібні приклади конфігурацій або команди онбордингу CLI для постачальників моделей
+summary: Огляд постачальника моделей із прикладами конфігурацій + потоками CLI
+title: Постачальники моделей
 x-i18n:
-    generated_at: "2026-04-21T05:21:16Z"
+    generated_at: "2026-04-21T06:04:45Z"
    model: gpt-5.4
    provider: openai
-    source_hash: aafd4d0da950a4ccdec64f85cf485a7da95da6a858588d43be3f7ac5fd0e05b7
+    source_hash: e433dfd51d1721832480089cb35ab1243e5c873a587f9968e14744840cb912cf
    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`, це стане списком дозволених значень.
+- Якщо ви задаєте `agents.defaults.models`, це стає списком дозволених значень.
 - Допоміжні команди CLI: `openclaw onboard`, `openclaw models list`, `openclaw models set <provider/model>`.
- Резервні правила під час виконання, cooldown-проби та збереження session-override
-  задокументовані в [/concepts/model-failover](/uk/concepts/model-failover).
- `models.providers.*.models[].contextWindow` — це власні метадані моделі;
-  `models.providers.*.models[].contextTokens` — це фактичне обмеження під час виконання.
- Провайдерські Plugin можуть впроваджувати каталоги моделей через `registerProvider({ catalog })`;
-  OpenClaw об’єднує цей вивід у `models.providers` перед записом
+- Резервні правила рантайму, зондування cooldown і збереження session-override
+  задокументовано в [/concepts/model-failover](/uk/concepts/model-failover).
+- `models.providers.*.models[].contextWindow` — це нативні метадані моделі;
+  `models.providers.*.models[].contextTokens` — це фактичне обмеження рантайму.
+- Плагіни постачальників можуть інʼєктувати каталоги моделей через `registerProvider({ catalog })`;
+  OpenClaw обʼєднує цей вивід у `models.providers` перед записом
  `models.json`.
- Маніфести провайдерів можуть оголошувати `providerAuthEnvVars` і
-  `providerAuthAliases`, щоб загальні auth-проби на основі env і варіанти провайдерів
-  не потребували завантаження середовища виконання Plugin. Решта мапи env-змінних у core тепер
-  потрібна лише для не-Plugin/core провайдерів і кількох випадків загального пріоритету, таких
-  як онбординг Anthropic зі схемою API-key-first.
- Провайдерські Plugin також можуть володіти поведінкою провайдера під час виконання через
+- Маніфести постачальників можуть оголошувати `providerAuthEnvVars` і
+  `providerAuthAliases`, щоб загальні перевірки автентифікації на основі env і варіанти постачальників
+  не потребували завантаження рантайму Plugin. Решта мапи env-змінних у ядрі тепер
+  використовується лише для постачальників ядра/не Plugin і кількох випадків із загальним пріоритетом, таких
+  як онбординг Anthropic із пріоритетом API-ключа.
+- Плагіни постачальників також можуть володіти поведінкою рантайму постачальника через
  `normalizeModelId`, `normalizeTransport`, `normalizeConfig`,
  `applyNativeStreamingUsageCompat`, `resolveConfigApiKey`,
  `resolveSyntheticAuth`, `shouldDeferSyntheticProfileAuth`,
@ -50,223 +50,188 @@ x-i18n:
  `matchesContextOverflowError`, `classifyFailoverReason`,
  `isCacheTtlEligible`, `buildMissingAuthMessage`, `suppressBuiltInModel`,
  `augmentModelCatalog`, `isBinaryThinking`, `supportsXHighThinking`,
-  `supportsAdaptiveThinking`,
+  `supportsAdaptiveThinking`, `supportsMaxThinking`,
  `resolveDefaultThinkingLevel`, `applyConfigDefaults`, `isModernModelRef`,
  `prepareRuntimeAuth`, `resolveUsageAuth`, `fetchUsageSnapshot`, і
  `onModelSelected`.
- Примітка: `capabilities` провайдера під час виконання — це спільні метадані раннера (сімейство провайдера,
-  особливості transcript/tooling, підказки щодо transport/cache). Це не те саме, що [публічна модель capability](/uk/plugins/architecture#public-capability-model),
+- Примітка: рантаймові `capabilities` постачальника — це спільні метадані раннера (сімейство постачальника,
+  особливості transcript/tooling, підказки для transport/cache). Це не те
+  саме, що [публічна модель можливостей](/uk/plugins/architecture#public-capability-model),
  яка описує, що реєструє Plugin (текстовий inference, мовлення тощо).
- Вбудований провайдер `codex` поєднаний із вбудованим harness агента Codex.
-  Використовуйте `codex/gpt-*`, коли вам потрібні login під керуванням Codex, виявлення моделей,
-  нативне відновлення thread і виконання на сервері застосунку. Звичайні посилання `openai/gpt-*`
-  і надалі використовують провайдера OpenAI та звичайний transport провайдера OpenClaw.
-  Розгортання лише з Codex можуть вимкнути автоматичний резервний перехід до PI через
+- Вбудований постачальник `codex` поєднаний із вбудованим агентним harness Codex.
+  Використовуйте `codex/gpt-*`, коли вам потрібні вхід, що належить Codex, виявлення моделей,
+  нативне відновлення thread і виконання app-server. Звичайні посилання `openai/gpt-*`
+  і далі використовують постачальника OpenAI та звичайний transport постачальника OpenClaw.
+  У розгортаннях лише з Codex можна вимкнути автоматичний резервний перехід на PI за допомогою
  `agents.defaults.embeddedHarness.fallback: "none"`; див.
  [Codex Harness](/uk/plugins/codex-harness).

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

-Тепер провайдерські Plugin можуть володіти більшістю специфічної для провайдера логіки, тоді як OpenClaw зберігає
+Плагіни постачальників тепер можуть володіти більшістю логіки, специфічної для постачальника, тоді як OpenClaw зберігає
 загальний цикл inference.

-Типовий поділ:
+Типовий розподіл:

- `auth[].run` / `auth[].runNonInteractive`: провайдер володіє потоками онбордингу/login
-  для `openclaw onboard`, `openclaw models auth` і безголового налаштування
- `wizard.setup` / `wizard.modelPicker`: провайдер володіє мітками вибору auth,
-  застарілими псевдонімами, підказками щодо списку дозволених значень для онбордингу та записами налаштування в засобах вибору онбордингу/моделей
- `catalog`: провайдер з’являється в `models.providers`
- `normalizeModelId`: провайдер нормалізує застарілі/preview ідентифікатори моделей перед
+- `auth[].run` / `auth[].runNonInteractive`: постачальник володіє потоками
+  онбордингу/входу для `openclaw onboard`, `openclaw models auth` і безголового налаштування
+- `wizard.setup` / `wizard.modelPicker`: постачальник володіє мітками вибору автентифікації,
+  застарілими псевдонімами, підказками щодо allowlist під час онбордингу та записами налаштування
+  у вибірниках онбордингу/моделей
+- `catalog`: постачальник зʼявляється в `models.providers`
+- `normalizeModelId`: постачальник нормалізує застарілі/preview ідентифікатори моделей перед
  пошуком або канонізацією
- `normalizeTransport`: провайдер нормалізує `api` / `baseUrl` сімейства transport
-  перед загальним складанням моделі; OpenClaw спочатку перевіряє відповідний провайдер,
-  а потім інші провайдерські Plugin, здатні працювати з цим hook, доки один із них справді не змінить
-  transport
- `normalizeConfig`: провайдер нормалізує конфігурацію `models.providers.<id>` перед
-  її використанням під час виконання; OpenClaw спочатку перевіряє відповідний провайдер, а потім інші
-  провайдерські Plugin, здатні працювати з цим hook, доки один із них справді не змінить конфігурацію. Якщо жоден
-  provider hook не переписує конфігурацію, вбудовані допоміжні засоби сімейства Google все одно
-  нормалізують підтримувані записи провайдерів Google.
- `applyNativeStreamingUsageCompat`: провайдер застосовує переписування compat для native streaming-usage на основі endpoint для конфігурованих провайдерів
- `resolveConfigApiKey`: провайдер визначає auth env-marker для конфігурованих провайдерів
-  без примусового повного завантаження auth під час виконання. `amazon-bedrock` також має
-  тут вбудований розпізнавач AWS env-marker, хоча auth Bedrock під час виконання використовує
-  типовий ланцюжок AWS SDK.
- `resolveSyntheticAuth`: провайдер може показувати доступність локального/self-hosted або іншого
-  auth на основі конфігурації без збереження секретів у відкритому вигляді
- `shouldDeferSyntheticProfileAuth`: провайдер може позначати збережені синтетичні profile-заповнювачі
-  як нижчі за пріоритетом, ніж auth на основі env/конфігурації
- `resolveDynamicModel`: провайдер приймає ідентифікатори моделей, яких ще немає в локальному
+- `normalizeTransport`: постачальник нормалізує `api` / `baseUrl` сімейства transport
+  перед загальним складанням моделі; OpenClaw спочатку перевіряє відповідного постачальника,
+  потім інші плагіни постачальників, здатні працювати через hook, доки один із них
+  фактично не змінить transport
+- `normalizeConfig`: постачальник нормалізує конфігурацію `models.providers.<id>` перед
+  використанням рантаймом; OpenClaw спочатку перевіряє відповідного постачальника, а потім інші
+  плагіни постачальників, здатні працювати через hook, доки один із них фактично не змінить конфігурацію. Якщо жоден
+  hook постачальника не переписує конфігурацію, вбудовані допоміжні засоби сімейства Google
+  усе ще нормалізують підтримувані записи постачальників Google.
+- `applyNativeStreamingUsageCompat`: постачальник застосовує сумісні переписування native streaming-usage для постачальників конфігурації залежно від endpoint
+- `resolveConfigApiKey`: постачальник визначає автентифікацію env-marker для постачальників конфігурації
+  без примусового завантаження повної рантаймової автентифікації. `amazon-bedrock` також має
+  тут вбудований резолвер AWS env-marker, хоча рантаймова автентифікація Bedrock використовує
+  стандартний ланцюг AWS SDK.
+- `resolveSyntheticAuth`: постачальник може повідомляти про доступність локальної/self-hosted або іншої
+  автентифікації, що спирається на конфігурацію, без збереження секретів у відкритому тексті
+- `shouldDeferSyntheticProfileAuth`: постачальник може позначати збережені заповнювачі synthetic profile
+  як такі, що мають нижчий пріоритет, ніж автентифікація на основі env/config
+- `resolveDynamicModel`: постачальник приймає ідентифікатори моделей, яких іще немає в локальному
  статичному каталозі
- `prepareDynamicModel`: провайдеру потрібне оновлення метаданих перед повторною спробою
+- `prepareDynamicModel`: постачальнику потрібно оновлення метаданих перед повторною спробою
  динамічного визначення
- `normalizeResolvedModel`: провайдеру потрібні переписування transport або base URL
- `contributeResolvedModelCompat`: провайдер додає compat-прапорці для своїх
-  vendor-моделей, навіть коли вони надходять через інший сумісний transport
- `capabilities`: провайдер публікує особливості transcript/tooling/provider-family
- `normalizeToolSchemas`: провайдер очищує схеми інструментів до того, як вбудований
-  раннер їх побачить
- `inspectToolSchemas`: провайдер показує специфічні для transport попередження схем
+- `normalizeResolvedModel`: постачальнику потрібні переписування transport або базового URL
+- `contributeResolvedModelCompat`: постачальник додає прапорці сумісності для своїх
+  моделей постачальника, навіть коли вони надходять через інший сумісний transport
+- `capabilities`: постачальник публікує особливості transcript/tooling/provider-family
+- `normalizeToolSchemas`: постачальник очищає схеми інструментів перед тим, як їх побачить вбудований
+  раннер
+- `inspectToolSchemas`: постачальник показує попередження схем, специфічні для transport,
  після нормалізації
- `resolveReasoningOutputMode`: провайдер вибирає контракти виводу reasoning — native чи tagged
- `prepareExtraParams`: провайдер задає типові значення або нормалізує параметри запиту для кожної моделі
- `createStreamFn`: провайдер замінює звичайний шлях stream повністю
-  користувацьким transport
- `wrapStreamFn`: провайдер застосовує обгортки сумісності заголовків/тіла/моделі запиту
- `resolveTransportTurnState`: провайдер постачає нативні заголовки або метадані transport
-  для кожного ходу
- `resolveWebSocketSessionPolicy`: провайдер постачає нативні заголовки сесії WebSocket
+- `resolveReasoningOutputMode`: постачальник обирає native чи tagged
+  контракти виводу reasoning
+- `prepareExtraParams`: постачальник задає типові значення або нормалізує параметри запиту для кожної моделі
+- `createStreamFn`: постачальник замінює звичайний шлях потоку повністю
+  кастомним transport
+- `wrapStreamFn`: постачальник застосовує обгортки сумісності для заголовків/тіла/моделі запиту
+- `resolveTransportTurnState`: постачальник надає нативні заголовки transport
+  або метадані для кожного ходу
+- `resolveWebSocketSessionPolicy`: постачальник надає нативні заголовки сесії WebSocket
  або політику cool-down сесії
- `createEmbeddingProvider`: провайдер володіє поведінкою embedding для пам’яті, коли вона
-  має належати провайдерському Plugin, а не core-перемикачу embedding
- `formatApiKey`: провайдер форматує збережені auth profile у
-  рядок `apiKey` під час виконання, якого очікує transport
- `refreshOAuth`: провайдер володіє оновленням OAuth, коли спільних
-  засобів оновлення `pi-ai` недостатньо
- `buildAuthDoctorHint`: провайдер додає підказки щодо виправлення, коли оновлення OAuth
-  зазнає невдачі
- `matchesContextOverflowError`: провайдер розпізнає специфічні для провайдера
-  помилки переповнення context-window, які загальні евристики можуть пропустити
- `classifyFailoverReason`: провайдер зіставляє специфічні для провайдера необроблені помилки transport/API
-  з причинами резервного переходу, такими як rate limit або overload
- `isCacheTtlEligible`: провайдер визначає, які upstream-ідентифікатори моделей підтримують TTL кешу prompt
- `buildMissingAuthMessage`: провайдер замінює загальну помилку сховища auth
-  на специфічну для провайдера підказку щодо відновлення
- `suppressBuiltInModel`: провайдер приховує застарілі upstream-рядки та може повертати
-  помилку під керуванням vendor для прямих збоїв визначення
- `augmentModelCatalog`: провайдер додає синтетичні/фінальні рядки каталогу після
-  виявлення та злиття конфігурації
- `isBinaryThinking`: провайдер володіє UX двійкового thinking — увімк./вимк.
- `supportsXHighThinking`: провайдер вмикає `xhigh` для вибраних моделей
- `supportsAdaptiveThinking`: провайдер вмикає `adaptive` для вибраних моделей
- `resolveDefaultThinkingLevel`: провайдер володіє типовою політикою `/think` для
+- `createEmbeddingProvider`: постачальник володіє поведінкою embedding для памʼяті, коли вона
+  має належати плагіну постачальника, а не центральному перемикачу embedding у ядрі
+- `formatApiKey`: постачальник форматує збережені профілі автентифікації у
+  рядок рантайму `apiKey`, якого очікує transport
+- `refreshOAuth`: постачальник володіє оновленням OAuth, коли спільних засобів оновлення `pi-ai`
+  недостатньо
+- `buildAuthDoctorHint`: постачальник додає підказку з відновлення, коли оновлення OAuth
+  не вдається
+- `matchesContextOverflowError`: постачальник розпізнає помилки переповнення
+  вікна контексту, специфічні для постачальника, які загальні евристики не побачили б
+- `classifyFailoverReason`: постачальник зіставляє сирі помилки transport/API, специфічні для постачальника,
+  із причинами резервного переходу, такими як rate limit або overload
+- `isCacheTtlEligible`: постачальник визначає, які upstream ідентифікатори моделей підтримують prompt-cache TTL
+- `buildMissingAuthMessage`: постачальник замінює загальну помилку auth-store
+  на підказку відновлення, специфічну для постачальника
+- `suppressBuiltInModel`: постачальник приховує застарілі upstream-рядки й може повертати
+  помилку, що належить постачальнику, для прямих збоїв визначення
+- `augmentModelCatalog`: постачальник додає synthetic/final рядки каталогу після
+  виявлення й обʼєднання конфігурації
+- `isBinaryThinking`: постачальник володіє UX двійкового thinking увімк./вимк.
+- `supportsXHighThinking`: постачальник вмикає `xhigh` для вибраних моделей
+- `supportsAdaptiveThinking`: постачальник вмикає `adaptive` для вибраних моделей
+- `supportsMaxThinking`: постачальник вмикає `max` для вибраних моделей
+- `resolveDefaultThinkingLevel`: постачальник володіє типовою політикою `/think` для
  сімейства моделей
- `applyConfigDefaults`: провайдер застосовує специфічні для провайдера глобальні типові значення
-  під час матеріалізації конфігурації залежно від режиму auth, env або сімейства моделей
- `isModernModelRef`: провайдер володіє зіставленням бажаної моделі для live/smoke
- `prepareRuntimeAuth`: провайдер перетворює налаштовані облікові дані на короткоживучий
-  токен для виконання
- `resolveUsageAuth`: провайдер визначає облікові дані usage/quota для `/usage`
-  і пов’язаних поверхонь status/reporting
- `fetchUsageSnapshot`: провайдер володіє отриманням/розбором endpoint usage, тоді як
-  core і далі володіє оболонкою підсумку та форматуванням
- `onModelSelected`: провайдер виконує побічні ефекти після вибору моделі, наприклад
-  telemetry або bookkeeping сесії під керуванням провайдера
+- `applyConfigDefaults`: постачальник застосовує глобальні типові значення, специфічні для постачальника,
+  під час матеріалізації конфігурації на основі режиму автентифікації, env або сімейства моделей
+- `isModernModelRef`: постачальник володіє зіставленням бажаних моделей для live/smoke
+- `prepareRuntimeAuth`: постачальник перетворює налаштовані облікові дані на короткоживучий
+  рантаймовий токен
+- `resolveUsageAuth`: постачальник визначає облікові дані використання/квоти для `/usage`
+  та повʼязаних поверхонь status/reporting
+- `fetchUsageSnapshot`: постачальник володіє отриманням/парсингом endpoint використання, тоді як
+  ядро все ще володіє оболонкою підсумку та форматуванням
+- `onModelSelected`: постачальник виконує побічні ефекти після вибору моделі, наприклад
+  телеметрію або ведення сесії, що належить постачальнику

 Поточні вбудовані приклади:

- `anthropic`: резервний механізм прямої сумісності вперед для Claude 4.6, підказки з відновлення auth, отримання
-  endpoint usage, метадані cache-TTL/provider-family і глобальні
-  типові значення конфігурації з урахуванням auth
- `amazon-bedrock`: зіставлення переповнення контексту під керуванням провайдера та класифікація
-  причин резервного переходу для специфічних помилок Bedrock `throttle`/`not-ready`, а також
-  спільне сімейство повторного відтворення `anthropic-by-model` для захистів політики replay лише для Claude на трафіку Anthropic
- `anthropic-vertex`: захисти політики replay лише для Claude на трафіку повідомлень Anthropic
- `openrouter`: наскрізні ідентифікатори моделей, обгортки запитів, підказки щодо provider capability,
-  очищення thought-signature Gemini на проксійованому трафіку Gemini, впровадження reasoning через проксі
-  через сімейство stream `openrouter-thinking`, пересилання метаданих маршрутизації
-  і політика cache-TTL
- `github-copilot`: онбординг/login пристрою, резервний механізм прямої сумісності вперед для моделей,
-  підказки transcript для Claude-thinking, обмін токенів під час виконання та отримання endpoint usage
- `openai`: резервний механізм прямої сумісності вперед для GPT-5.4, пряма нормалізація
-  transport OpenAI, підказки відсутньої auth з урахуванням Codex, придушення Spark, синтетичні
-  рядки каталогу OpenAI/Codex, політика thinking/live-model, нормалізація псевдонімів usage-token
-  (сімейства `input` / `output` і `prompt` / `completion`), спільне
-  сімейство stream `openai-responses-defaults` для нативних обгорток OpenAI/Codex,
-  метадані provider-family, реєстрація вбудованого провайдера генерації зображень
-  для `gpt-image-1` і реєстрація вбудованого провайдера генерації відео
-  для `sora-2`
- `google` і `google-gemini-cli`: резервний механізм прямої сумісності вперед для Gemini 3.1,
-  нативна перевірка replay Gemini, очищення bootstrap replay, режим
-  виводу reasoning з тегами, зіставлення сучасних моделей, реєстрація вбудованого провайдера
-  генерації зображень для моделей Gemini image-preview і вбудована
-  реєстрація провайдера генерації відео для моделей Veo; OAuth Gemini CLI також
-  володіє форматуванням токенів auth-profile, розбором usage-token і отриманням
-  endpoint квот для поверхонь usage
- `moonshot`: спільний transport, нормалізація payload thinking під керуванням Plugin
- `kilocode`: спільний transport, заголовки запитів під керуванням Plugin, нормалізація payload reasoning,
-  очищення thought-signature проксійованого Gemini та політика cache-TTL
- `zai`: резервний механізм прямої сумісності вперед для GLM-5, типові значення `tool_stream`, політика cache-TTL,
-  політика binary-thinking/live-model і auth usage + отримання квот;
-  невідомі ідентифікатори `glm-5*` синтезуються з вбудованого шаблону `glm-4.7`
- `xai`: нативна нормалізація transport Responses, переписування псевдонімів `/fast` для
-  швидких варіантів Grok, типовий `tool_stream`, очищення tool-schema /
-  reasoning-payload, специфічне для xAI, і вбудована реєстрація провайдера генерації відео
-  для `grok-imagine-video`
- `mistral`: метадані capability під керуванням Plugin
- `opencode` і `opencode-go`: метадані capability під керуванням Plugin плюс
-  очищення thought-signature проксійованого Gemini
- `alibaba`: каталог генерації відео під керуванням Plugin для прямих посилань на моделі Wan,
-  таких як `alibaba/wan2.6-t2v`
- `byteplus`: каталоги під керуванням Plugin плюс вбудована реєстрація провайдера генерації відео
-  для моделей Seedance text-to-video/image-to-video
- `fal`: вбудована реєстрація провайдера генерації відео для розміщених сторонніх
-  моделей, реєстрація провайдера генерації зображень для моделей FLUX плюс вбудована
-  реєстрація провайдера генерації відео для розміщених сторонніх відеомоделей
+- `anthropic`: резервний режим прямої сумісності вперед для Claude 4.6, підказки щодо відновлення автентифікації, отримання endpoint використання, метадані cache-TTL/сімейства постачальника та глобальні типові налаштування конфігурації з урахуванням автентифікації
+- `amazon-bedrock`: зіставлення переповнення контексту під керуванням постачальника та класифікація причин резервного переходу для специфічних для Bedrock помилок throttle/not-ready, а також спільне сімейство відтворення `anthropic-by-model` для захистів replay-policy лише для Claude на трафіку Anthropic
+- `anthropic-vertex`: захисти replay-policy лише для Claude на трафіку Anthropic-message
+- `openrouter`: наскрізні ідентифікатори моделей, обгортки запитів, підказки можливостей постачальника, санітизація thought-signature Gemini на проксійованому трафіку Gemini, інʼєкція reasoning через проксі через сімейство потоків `openrouter-thinking`, пересилання метаданих маршрутизації та політика cache-TTL
+- `github-copilot`: онбординг/вхід через пристрій, резервний режим сумісності вперед для моделей, підказки transcript для Claude-thinking, обмін рантаймових токенів та отримання endpoint використання
+- `openai`: резервний режим сумісності вперед для GPT-5.4, нормалізація прямого transport OpenAI, підказки щодо відсутньої автентифікації з урахуванням Codex, придушення Spark, synthetic рядки каталогу OpenAI/Codex, політика thinking/live-model, нормалізація псевдонімів токенів використання (`input` / `output` і сімейства `prompt` / `completion`), спільне сімейство потоків `openai-responses-defaults` для нативних обгорток OpenAI/Codex, метадані сімейства постачальника, реєстрація вбудованого постачальника генерації зображень для `gpt-image-1` і реєстрація вбудованого постачальника генерації відео для `sora-2`
+- `google` і `google-gemini-cli`: резервний режим сумісності вперед для Gemini 3.1, нативна перевірка відтворення Gemini, санітизація bootstrap replay, режим виводу reasoning із тегами, зіставлення сучасних моделей, реєстрація вбудованого постачальника генерації зображень для моделей Gemini image-preview і реєстрація вбудованого постачальника генерації відео для моделей Veo; Gemini CLI OAuth також володіє форматуванням токенів профілю автентифікації, парсингом токенів використання та отриманням endpoint квот для поверхонь використання
+- `moonshot`: спільний transport, нормалізація thinking payload під керуванням Plugin
+- `kilocode`: спільний transport, заголовки запитів під керуванням Plugin, нормалізація reasoning payload, санітизація thought-signature proxy-Gemini та політика cache-TTL
+- `zai`: резервний режим сумісності вперед для GLM-5, типові значення `tool_stream`, політика cache-TTL, політика binary-thinking/live-model та автентифікація використання + отримання квот; невідомі ідентифікатори `glm-5*` синтезуються з вбудованого шаблону `glm-4.7`
+- `xai`: нативна нормалізація transport Responses, переписування псевдонімів `/fast` для швидких варіантів Grok, типовий `tool_stream`, очищення tool-schema / reasoning-payload, специфічне для xAI, і реєстрація вбудованого постачальника генерації відео для `grok-imagine-video`
+- `mistral`: метадані можливостей під керуванням Plugin
+- `opencode` і `opencode-go`: метадані можливостей під керуванням Plugin плюс санітизація thought-signature proxy-Gemini
+- `alibaba`: каталог генерації відео під керуванням Plugin для прямих посилань на моделі Wan, таких як `alibaba/wan2.6-t2v`
+- `byteplus`: каталоги під керуванням Plugin плюс реєстрація вбудованого постачальника генерації відео для моделей Seedance text-to-video/image-to-video
+- `fal`: реєстрація вбудованого постачальника генерації відео для розміщених сторонніх моделей, реєстрація постачальника генерації зображень для моделей FLUX image плюс реєстрація вбудованого постачальника генерації відео для розміщених сторонніх відеомоделей
 - `cloudflare-ai-gateway`, `huggingface`, `kimi`, `nvidia`, `qianfan`,
  `stepfun`, `synthetic`, `venice`, `vercel-ai-gateway` і `volcengine`:
  лише каталоги під керуванням Plugin
- `qwen`: каталоги під керуванням Plugin для текстових моделей плюс спільні
-  реєстрації провайдерів media-understanding і генерації відео для його
-  мультимодальних поверхонь; генерація відео Qwen використовує стандартні відеоendpoint-и DashScope з
-  вбудованими моделями Wan, такими як `wan2.6-t2v` і `wan2.7-r2v`
- `runway`: реєстрація провайдера генерації відео під керуванням Plugin для нативних
-  моделей на основі завдань Runway, таких як `gen4.5`
- `minimax`: каталоги під керуванням Plugin, вбудована реєстрація провайдера генерації відео
-  для моделей Hailuo, вбудована реєстрація провайдера генерації зображень
-  для `image-01`, вибір політики replay гібридного Anthropic/OpenAI та логіка auth/snapshot usage
- `together`: каталоги під керуванням Plugin плюс вбудована реєстрація провайдера генерації відео
-  для відеомоделей Wan
- `xiaomi`: каталоги під керуванням Plugin плюс логіка auth/snapshot usage
+- `qwen`: каталоги текстових моделей під керуванням Plugin плюс спільні реєстрації постачальників media-understanding і video-generation для його мультимодальних поверхонь; генерація відео Qwen використовує стандартні video endpoint DashScope із вбудованими моделями Wan, такими як `wan2.6-t2v` і `wan2.7-r2v`
+- `runway`: реєстрація постачальника генерації відео під керуванням Plugin для нативних моделей Runway на основі задач, таких як `gen4.5`
+- `minimax`: каталоги під керуванням Plugin, реєстрація вбудованого постачальника генерації відео для моделей Hailuo, реєстрація вбудованого постачальника генерації зображень для `image-01`, гібридний вибір replay-policy Anthropic/OpenAI і логіка автентифікації/знімка використання
+- `together`: каталоги під керуванням Plugin плюс реєстрація вбудованого постачальника генерації відео для моделей Wan video
+- `xiaomi`: каталоги під керуванням Plugin плюс логіка автентифікації/знімка використання

-Вбудований Plugin `openai` тепер володіє обома ідентифікаторами провайдера: `openai` і
+Вбудований Plugin `openai` тепер володіє обома ідентифікаторами постачальника: `openai` і
 `openai-codex`.

-Це охоплює провайдерів, які все ще вписуються у звичайні transport OpenClaw. Провайдер,
-якому потрібен повністю користувацький виконавець запитів, — це окрема, глибша поверхня розширення.
+Це охоплює постачальників, які все ще вкладаються у звичайні transport OpenClaw. Постачальник,
+якому потрібен повністю кастомний виконавець запитів, — це окрема, глибша поверхня розширення.

 ## Ротація 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
+- Запити повторюються з наступним ключем лише у відповідь на rate-limit помилки (наприклад
+  `429`, `rate_limit`, `quota`, `resource exhausted`, `Too many
 concurrent requests`, `ThrottlingException`, `concurrency limit reached`,
-  `workers_ai ... quota limit exceeded` або періодичні повідомлення про ліміт usage).
- Збої, не пов’язані з обмеженням швидкості, завершуються негайно; ротація ключів не виконується.
- Коли всі можливі ключі зазнають невдачі, повертається фінальна помилка з останньої спроби.
+  `workers_ai ... quota limit exceeded` або періодичні повідомлення про ліміт використання).
+- Помилки, не повʼязані з rate-limit, завершуються негайно; ротація ключів не виконується.
+- Коли всі кандидати ключів вичерпано, повертається фінальна помилка з останньої спроби.

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

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

 ### OpenAI

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

 ```json5
 {
@ -276,14 +241,14 @@ OpenClaw постачається з каталогом pi‑ai. Для цих

 ### Anthropic

- Провайдер: `anthropic`
- Auth: `ANTHROPIC_API_KEY`
- Необов’язкова ротація: `ANTHROPIC_API_KEYS`, `ANTHROPIC_API_KEY_1`, `ANTHROPIC_API_KEY_2`, а також `OPENCLAW_LIVE_ANTHROPIC_KEY` (одне перевизначення)
+- Постачальник: `anthropic`
+- Автентифікація: `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`, включно з трафіком з auth через API-ключ і OAuth, надісланим до `api.anthropic.com`; OpenClaw зіставляє це з `service_tier` Anthropic (`auto` vs `standard_only`)
- Примітка щодо Anthropic: співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволене, тож OpenClaw вважає повторне використання Claude CLI і використання `claude -p` санкціонованими для цієї інтеграції, якщо Anthropic не опублікує нову політику.
- Setup-token Anthropic і далі доступний як підтримуваний шлях токена OpenClaw, але тепер OpenClaw віддає перевагу повторному використанню Claude CLI і `claude -p`, коли це можливо.
+- Прямі публічні запити 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`, коли це доступно.

 ```json5
 {
@ -293,20 +258,20 @@ OpenClaw постачається з каталогом pi‑ai. Для цих

 ### OpenAI Code (Codex)

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

 ```json5
 {
@ -326,17 +291,17 @@ OpenClaw постачається з каталогом pi‑ai. Для цих
 }
 ```

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

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

 ### OpenCode

- Auth: `OPENCODE_API_KEY` (або `OPENCODE_ZEN_API_KEY`)
- Провайдер середовища виконання Zen: `opencode`
- Провайдер середовища виконання Go: `opencode-go`
+- Автентифікація: `OPENCODE_API_KEY` (або `OPENCODE_ZEN_API_KEY`)
+- Постачальник рантайму Zen: `opencode`
+- Постачальник рантайму Go: `opencode-go`
 - Приклади моделей: `opencode/claude-opus-4-6`, `opencode-go/kimi-k2.5`
 - CLI: `openclaw onboard --auth-choice opencode-zen` або `openclaw onboard --auth-choice opencode-go`

@ -348,89 +313,87 @@ 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` (одне перевизначення)
+- Постачальник: `google`
+- Автентифікація: `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/...`; cache hits 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 і використовуйте неважливий обліковий запис, якщо вирішите продовжити.
+- Постачальники: `google-vertex`, `google-gemini-cli`
+- Автентифікація: 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`
+  - Модель за замовчуванням: `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`; usage резервно береться з
+    токени в профілях автентифікації на хості 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`
+- Автентифікація: `ZAI_API_KEY`
 - Приклад моделі: `zai/glm-5.1`
 - CLI: `openclaw onboard --auth-choice zai-api-key`
  - Псевдоніми: `z.ai/*` і `z-ai/*` нормалізуються до `zai/*`
-  - `zai-api-key` автоматично визначає відповідний endpoint Z.AI; `zai-coding-global`, `zai-coding-cn`, `zai-global` і `zai-cn` примусово задають конкретну поверхню
+  - `zai-api-key` автоматично виявляє відповідний endpoint Z.AI; `zai-coding-global`, `zai-coding-cn`, `zai-global` і `zai-cn` примусово вибирають конкретну поверхню

 ### Vercel AI Gateway

- Провайдер: `vercel-ai-gateway`
- Auth: `AI_GATEWAY_API_KEY`
+- Постачальник: `vercel-ai-gateway`
+- Автентифікація: `AI_GATEWAY_API_KEY`
 - Приклад моделі: `vercel-ai-gateway/anthropic/claude-opus-4.6`
 - CLI: `openclaw onboard --auth-choice ai-gateway-api-key`

 ### Kilo Gateway

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

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

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

 - OpenRouter: `openrouter` (`OPENROUTER_API_KEY`)
 - Приклад моделі: `openrouter/auto`
 - OpenClaw застосовує задокументовані заголовки атрибуції застосунку OpenRouter лише тоді, коли
  запит справді спрямований на `openrouter.ai`
- Специфічні для OpenRouter маркери Anthropic `cache_control` так само обмежуються
+- Специфічні для OpenRouter маркери Anthropic `cache_control` так само обмежені
  перевіреними маршрутами OpenRouter, а не довільними URL проксі
- OpenRouter залишається на OpenAI-сумісному шляху у стилі проксі, тому нативне
-  формування запитів, притаманне лише OpenAI (`serviceTier`, Responses `store`,
-  підказки кешу prompt, payload сумісності reasoning OpenAI), не пересилається
- Посилання OpenRouter на основі Gemini зберігають лише очищення thought-signature для проксійованого Gemini;
-  нативна перевірка replay Gemini та переписування bootstrap залишаються вимкненими
+- OpenRouter залишається на проксі-шляху в стилі OpenAI-сумісності, тому формування запитів, притаманне лише нативному OpenAI (`serviceTier`, `store` у Responses,
+  підказки prompt-cache, payload сумісності reasoning OpenAI), не пересилається
+- Посилання OpenRouter на основі Gemini зберігають лише шлях санітизації thought-signature proxy-Gemini; нативна перевірка відтворення Gemini і переписування bootstrap лишаються вимкненими
 - Kilo Gateway: `kilocode` (`KILOCODE_API_KEY`)
 - Приклад моделі: `kilocode/kilo/auto`
- Посилання Kilo на основі Gemini зберігають той самий шлях очищення
-  thought-signature для проксійованого Gemini; `kilocode/kilo/auto` та інші підказки,
-  де reasoning проксі не підтримується, пропускають впровадження reasoning через проксі
+- Посилання Kilo на основі Gemini зберігають той самий шлях
+  санітизації thought-signature proxy-Gemini; `kilocode/kilo/auto` та інші підказки proxy-reasoning-unsupported
+  пропускають інʼєкцію reasoning через проксі
 - MiniMax: `minimax` (API-ключ) і `minimax-portal` (OAuth)
- Auth: `MINIMAX_API_KEY` для `minimax`; `MINIMAX_OAUTH_TOKEN` або `MINIMAX_API_KEY` для `minimax-portal`
+- Автентифікація: `MINIMAX_API_KEY` для `minimax`; `MINIMAX_OAUTH_TOKEN` або `MINIMAX_API_KEY` для `minimax-portal`
 - Приклад моделі: `minimax/MiniMax-M2.7` або `minimax-portal/MiniMax-M2.7`
- Налаштування онбордингу/API-ключа MiniMax записує явні визначення моделей M2.7 з
-  `input: ["text", "image"]`; вбудований каталог провайдера зберігає chat-посилання
-  лише текстовими, доки не буде матеріалізовано конфігурацію цього провайдера
+- Онбординг/налаштування API-ключа MiniMax записує явні визначення моделей M2.7 з
+  `input: ["text", "image"]`; вбудований каталог постачальника тримає посилання чату
+  лише текстовими, доки не буде матеріалізовано конфігурацію цього постачальника
 - Moonshot: `moonshot` (`MOONSHOT_API_KEY`)
 - Приклад моделі: `moonshot/kimi-k2.6`
 - Kimi Coding: `kimi` (`KIMI_API_KEY` або `KIMICODE_API_KEY`)
@ -442,7 +405,7 @@ OpenClaw постачається з каталогом pi‑ai. Для цих
 - NVIDIA: `nvidia` (`NVIDIA_API_KEY`)
 - Приклад моделі: `nvidia/nvidia/llama-3.1-nemotron-70b-instruct`
 - StepFun: `stepfun` / `stepfun-plan` (`STEPFUN_API_KEY`)
- Приклад моделі: `stepfun/step-3.5-flash`, `stepfun-plan/step-3.5-flash-2603`
+- Приклади моделей: `stepfun/step-3.5-flash`, `stepfun-plan/step-3.5-flash-2603`
 - Together: `together` (`TOGETHER_API_KEY`)
 - Приклад моделі: `together/moonshotai/Kimi-K2.5`
 - Venice: `venice` (`VENICE_API_KEY`)
@ -457,9 +420,9 @@ OpenClaw постачається з каталогом pi‑ai. Для цих
 - Приклад моделі: `byteplus-plan/ark-code-latest`
 - xAI: `xai` (`XAI_API_KEY`)
  - Нативні вбудовані запити xAI використовують шлях xAI Responses
-  - `/fast` або `params.fastMode: true` переписує `grok-3`, `grok-3-mini`,
+  - `/fast` або `params.fastMode: true` переписують `grok-3`, `grok-3-mini`,
    `grok-4` і `grok-4-0709` на їхні варіанти `*-fast`
-  - `tool_stream` типово ввімкнено; встановіть
+  - `tool_stream` типово ввімкнено; задайте
    `agents.defaults.models["xai/<model>"].params.tool_stream` у `false`, щоб
    вимкнути його
 - Mistral: `mistral` (`MISTRAL_API_KEY`)
@ -467,27 +430,28 @@ OpenClaw постачається з каталогом pi‑ai. Для цих
 - CLI: `openclaw onboard --auth-choice mistral-api-key`
 - Groq: `groq` (`GROQ_API_KEY`)
 - Cerebras: `cerebras` (`CEREBRAS_API_KEY`)
-  - Моделі GLM на Cerebras використовують ідентифікатори `zai-glm-4.7` і `zai-glm-4.6`.
-  - Base URL, сумісний з OpenAI: `https://api.cerebras.ai/v1`.
+  - Моделі GLM у Cerebras використовують ідентифікатори `zai-glm-4.7` і `zai-glm-4.6`.
+  - Базовий URL у форматі OpenAI-compatible: `https://api.cerebras.ai/v1`.
 - GitHub Copilot: `github-copilot` (`COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN`)
 - Приклад моделі Hugging Face Inference: `huggingface/deepseek-ai/DeepSeek-R1`; CLI: `openclaw onboard --auth-choice huggingface-api-key`. Див. [Hugging Face (Inference)](/uk/providers/huggingface).

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

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

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

 ### Moonshot AI (Kimi)

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

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

@ -524,10 +488,10 @@ Moonshot постачається як вбудований провайдерс

 ### Kimi Coding

-Kimi Coding використовує Anthropic-сумісний endpoint Moonshot AI:
+Kimi Coding використовує Anthropic-compatible endpoint Moonshot AI:

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

 ```json5
@ -539,14 +503,14 @@ Kimi Coding використовує Anthropic-сумісний endpoint Moonsho
 }
 ```

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

 ### Volcano Engine (Doubao)

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

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

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

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

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

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

@ -582,12 +546,12 @@ OpenClaw повертається до нефільтрованого катал
 - `volcengine-plan/kimi-k2-thinking`
 - `volcengine-plan/glm-4.7`

-### BytePlus (міжнародний)
+### BytePlus (Міжнародний)

 BytePlus ARK надає міжнародним користувачам доступ до тих самих моделей, що й Volcano Engine.

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

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

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

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

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

@ -623,10 +587,10 @@ OpenClaw повертається до нефільтрованого катал

 ### Synthetic

-Synthetic надає Anthropic-сумісні моделі через провайдер `synthetic`:
+Synthetic надає Anthropic-compatible моделі через постачальника `synthetic`:

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

@ -651,37 +615,37 @@ Synthetic надає Anthropic-сумісні моделі через прова

 ### MiniMax

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

- MiniMax OAuth (глобальний): `--auth-choice minimax-global-oauth`
+- MiniMax OAuth (Global): `--auth-choice minimax-global-oauth`
 - MiniMax OAuth (CN): `--auth-choice minimax-cn-oauth`
- API-ключ MiniMax (глобальний): `--auth-choice minimax-global-api`
+- API-ключ MiniMax (Global): `--auth-choice minimax-global-api`
 - API-ключ MiniMax (CN): `--auth-choice minimax-cn-api`
- Auth: `MINIMAX_API_KEY` для `minimax`; `MINIMAX_OAUTH_TOKEN` або
+- Автентифікація: `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-compatible шляху потокової передачі MiniMax OpenClaw типово вимикає thinking,
+якщо ви явно його не задасте, а `/fast on` переписує
 `MiniMax-M2.7` на `MiniMax-M2.7-highspeed`.

-Поділ capability під керуванням Plugin:
+Розподіл можливостей під керуванням Plugin:

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

 ### LM Studio

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

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

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

 ```json5
 {
@ -693,14 +657,14 @@ LM Studio постачається як вбудований провайдер

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

 ### Ollama

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

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

@ -717,27 +681,26 @@ 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).

 ### vLLM

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

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

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

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

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

 ```json5
 {
@ -747,25 +710,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 постачальника для швидких self-hosted
+OpenAI-compatible серверів:

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

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

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

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

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

-Докладніше див. у [/providers/sglang](/uk/providers/sglang).
+Подробиці дивіться в [/providers/sglang](/uk/providers/sglang).

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

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

 ```json5
 {
@ -814,20 +777,20 @@ export SGLANG_API_KEY="sglang-local"

 Примітки:

- Для користувацьких провайдерів `reasoning`, `input`, `cost`, `contextWindow` і `maxTokens` необов’язкові.
-  Якщо їх пропущено, OpenClaw типово використовує:
+- Для кастомних постачальників `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"` на не-нативних endpoint-ах (будь-який непорожній `baseUrl`, чий хост не є `api.openai.com`) OpenClaw примусово встановлює `compat.supportsDeveloperRole: false`, щоб уникати помилок провайдера 400 для непідтримуваних ролей `developer`.
- Маршрути OpenAI-сумісного типу через проксі також пропускають нативне формування
-  запитів, притаманне лише OpenAI: без `service_tier`, без `store` Responses, без підказок кешу prompt, без
+- Рекомендовано: задайте явні значення, які відповідають обмеженням вашого проксі/моделі.
+- Для `api: "openai-completions"` на не нативних endpoint (будь-який непорожній `baseUrl`, чий хост не є `api.openai.com`), OpenClaw примусово задає `compat.supportsDeveloperRole: false`, щоб уникати помилок постачальника 400 для непідтримуваних ролей `developer`.
+- Проксі-маршрути в стилі OpenAI-compatible також пропускають нативне формування запитів лише для OpenAI:
+  без `service_tier`, без `store` у Responses, без підказок prompt-cache, без
  формування payload сумісності reasoning OpenAI і без прихованих заголовків атрибуції OpenClaw.
- Якщо `baseUrl` порожній/пропущений, OpenClaw зберігає типову поведінку OpenAI (яка веде до `api.openai.com`).
- З міркувань безпеки явне `compat.supportsDeveloperRole: true` усе одно перевизначається на не-нативних endpoint-ах `openai-completions`.
+- Якщо `baseUrl` порожній/не вказаний, OpenClaw зберігає типову поведінку OpenAI (яка резолвиться в `api.openai.com`).
+- Для безпеки явне `compat.supportsDeveloperRole: true` усе одно перевизначається на не нативних endpoint `openai-completions`.

 ## Приклади CLI

@ -839,9 +802,9 @@ openclaw models list

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

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

 - [Models](/uk/concepts/models) — конфігурація моделей і псевдоніми
- [Model Failover](/uk/concepts/model-failover) — ланцюжки резервного переходу та поведінка повторних спроб
+- [Model Failover](/uk/concepts/model-failover) — ланцюги резервного переходу й поведінка повторних спроб
 - [Configuration Reference](/uk/gateway/configuration-reference#agent-defaults) — ключі конфігурації моделей
- [Providers](/uk/providers) — посібники з налаштування для кожного провайдера
+- [Providers](/uk/providers) — посібники з налаштування для кожного постачальника окремо
--- a/docs/uk/gateway/configuration-reference.md
+++ b/docs/uk/gateway/configuration-reference.md
--- a/docs/uk/plugins/architecture.md
+++ b/docs/uk/plugins/architecture.md
--- a/docs/uk/plugins/sdk-provider-plugins.md
+++ b/docs/uk/plugins/sdk-provider-plugins.md
@ -1,40 +1,40 @@
 ---
 read_when:
    - Ви створюєте новий плагін постачальника моделей
-    - Ви хочете додати до OpenClaw OpenAI-сумісний проксі або власну LLM
+    - Ви хочете додати OpenAI-сумісний проксі або власну LLM до OpenClaw
    - Вам потрібно зрозуміти автентифікацію постачальника, каталоги та runtime-хуки
 sidebarTitle: Provider Plugins
 summary: Покроковий посібник зі створення плагіна постачальника моделей для OpenClaw
 title: Створення плагінів постачальників
 x-i18n:
-    generated_at: "2026-04-21T05:21:17Z"
+    generated_at: "2026-04-21T06:04:47Z"
    model: gpt-5.4
    provider: openai
-    source_hash: ac15d705e805dfb74a2a13538bcddf9a2fc78a4529657f2e1c1aab676cb3984d
+    source_hash: 459761118c7394c1643c170edfec97c87e1c6323b436183b53ad7a2fed783b04
    source_path: plugins/sdk-provider-plugins.md
    workflow: 15
 ---

 # Створення плагінів постачальників

-Цей посібник допоможе вам створити плагін постачальника, який додає постачальника
-моделей (LLM) до OpenClaw. Наприкінці у вас буде постачальник із каталогом моделей,
+Цей посібник проводить через створення плагіна постачальника, який додає постачальника моделей
+(LLM) до OpenClaw. Наприкінці у вас буде постачальник із каталогом моделей,
 автентифікацією через API-ключ і динамічним визначенням моделей.

 <Info>
  Якщо ви раніше не створювали жодного плагіна OpenClaw, спочатку прочитайте
-  [Початок роботи](/uk/plugins/building-plugins), щоб ознайомитися з базовою
-  структурою пакета та налаштуванням маніфесту.
+  [Початок роботи](/uk/plugins/building-plugins) про базову структуру
+  пакета та налаштування маніфесту.
 </Info>

 <Tip>
-  Плагіни постачальників додають моделі до стандартного циклу інференсу OpenClaw. Якщо модель
-  має працювати через нативний агентний демон, який керує потоками, Compaction або подіями
+  Плагіни постачальників додають моделі до звичайного циклу інференсу OpenClaw. Якщо модель
+  має працювати через нативний демон агента, який керує потоками, Compaction або подіями
  інструментів, поєднайте постачальника з [agent harness](/uk/plugins/sdk-agent-harness),
  замість того щоб виносити деталі протоколу демона в core.
 </Tip>

-## Покрокова інструкція
+## Покроковий розбір

 <Steps>
  <a id="step-1-package-and-manifest"></a>
@ -97,12 +97,12 @@ x-i18n:
    </CodeGroup>

    Маніфест оголошує `providerAuthEnvVars`, щоб OpenClaw міг виявляти
-    облікові дані без завантаження runtime вашого плагіна. Додайте `providerAuthAliases`,
+    облікові дані без завантаження runtime вашого плагіна. Додавайте `providerAuthAliases`,
    коли варіант постачальника має повторно використовувати автентифікацію іншого id постачальника. `modelSupport`
-    необов’язковий і дозволяє OpenClaw автоматично завантажувати ваш плагін постачальника зі скорочених
+    є необов’язковим і дозволяє OpenClaw автоматично завантажувати ваш плагін постачальника зі скорочених
    id моделей, таких як `acme-large`, ще до появи runtime-хуків. Якщо ви публікуєте
-    постачальника в ClawHub, поля `openclaw.compat` і `openclaw.build`
-    у `package.json` є обов’язковими.
+    постачальника в ClawHub, ці поля `openclaw.compat` і `openclaw.build`
+    є обов’язковими в `package.json`.

  </Step>

@ -182,8 +182,8 @@ x-i18n:
    `openclaw onboard --acme-ai-api-key <key>` і вибрати
    `acme-ai/acme-large` як свою модель.

-    Якщо постачальник вище за течією використовує інші керівні токени, ніж OpenClaw, додайте
-    невелике двоспрямоване текстове перетворення замість заміни шляху потоку:
+    Якщо вхідний постачальник використовує інші керувальні токени, ніж OpenClaw, додайте
+    невелике двонапрямне текстове перетворення замість заміни шляху потоку:

    ```typescript
    api.registerTextTransforms({
@ -200,13 +200,13 @@ x-i18n:
    });
    ```

-    `input` переписує фінальний системний промпт і текстовий вміст повідомлення перед
-    передаванням. `output` переписує текстові дельти асистента та фінальний текст до того, як
-    OpenClaw розбере власні керівні маркери або виконає доставку через канал.
+    `input` переписує фінальний системний промпт і вміст текстового повідомлення перед
+    транспортуванням. `output` переписує текстові дельти асистента і фінальний текст до того,
+    як OpenClaw розбере власні керувальні маркери або доставку через канал.

-    Для вбудованих постачальників, які реєструють лише одного текстового постачальника з
-    автентифікацією через API-ключ плюс один runtime на основі каталогу, краще використовувати вужчий
-    хелпер `defineSingleProviderPluginEntry(...)`:
+    Для вбудованих постачальників, які реєструють лише одного текстового постачальника з API-key
+    автентифікацією плюс один runtime на основі каталогу, надавайте перевагу
+    вужчому хелперу `defineSingleProviderPluginEntry(...)`:

    ```typescript
    import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry";
@ -241,24 +241,25 @@ x-i18n:
    });
    ```

-    Якщо ваш потік автентифікації також має оновлювати `models.providers.*`, aliases і
-    модель агента за замовчуванням під час onboarding, використовуйте preset-хелпери з
+    Якщо ваш потік автентифікації також має оновлювати `models.providers.*`, псевдоніми
+    та модель агента за замовчуванням під час onboarding, використовуйте хелпери пресетів з
    `openclaw/plugin-sdk/provider-onboard`. Найвужчі хелпери —
    `createDefaultModelPresetAppliers(...)`,
    `createDefaultModelsPresetAppliers(...)` і
    `createModelCatalogPresetAppliers(...)`.

-    Коли нативна кінцева точка постачальника підтримує блоки використання в потоці на
-    звичайному транспорті `openai-completions`, віддавайте перевагу спільним хелперам каталогу з
-    `openclaw/plugin-sdk/provider-catalog-shared` замість жорсткого кодування перевірок id постачальника.
+    Коли нативний endpoint постачальника підтримує потокові блоки usage на
+    звичайному транспорті `openai-completions`, надавайте перевагу спільним хелперам каталогу з
+    `openclaw/plugin-sdk/provider-catalog-shared` замість жорсткого кодування перевірок за id постачальника.
    `supportsNativeStreamingUsageCompat(...)` і
-    `applyProviderNativeStreamingUsageCompat(...)` визначають підтримку за мапою можливостей кінцевої точки, тож нативні
-    кінцеві точки в стилі Moonshot/DashScope також можуть підключатися, навіть якщо плагін використовує власний id постачальника.
+    `applyProviderNativeStreamingUsageCompat(...)` визначають підтримку за картою можливостей endpoint, тож
+    нативні endpoint-и на кшталт Moonshot/DashScope усе одно підключаються, навіть якщо плагін використовує
+    власний id постачальника.

  </Step>

  <Step title="Додайте динамічне визначення моделей">
-    Якщо ваш постачальник приймає довільні id моделей (як проксі або маршрутизатор),
+    Якщо ваш постачальник приймає довільні id моделей (наприклад, проксі або маршрутизатор),
    додайте `resolveDynamicModel`:

    ```typescript
@ -281,16 +282,16 @@ x-i18n:
    ```

    Якщо для визначення потрібен мережевий виклик, використовуйте `prepareDynamicModel` для асинхронного
-    прогріву — після його завершення `resolveDynamicModel` запускається знову.
+    попереднього прогріву — після його завершення `resolveDynamicModel` буде виконано знову.

  </Step>

  <Step title="Додайте runtime-хуки (за потреби)">
-    Більшості постачальників достатньо лише `catalog` + `resolveDynamicModel`. Додавайте хуки
-    поступово, коли це буде потрібно вашому постачальнику.
+    Більшості постачальників потрібні лише `catalog` + `resolveDynamicModel`. Додавайте хуки
+    поступово, коли цього вимагатиме ваш постачальник.

-    Спільні builder-хелпери тепер охоплюють найпоширеніші сімейства replay/tool-compat,
-    тож плагінам зазвичай не потрібно вручну підключати кожен хук окремо:
+    Спільні builder-хелпери тепер покривають найпоширеніші сімейства replay/tool-compat,
+    тому плагінам зазвичай не потрібно вручну підключати кожен хук окремо:

    ```typescript
    import { buildProviderReplayFamilyHooks } from "openclaw/plugin-sdk/provider-model-shared";
@ -310,15 +311,15 @@ x-i18n:
    });
    ```

-    Доступні на сьогодні сімейства replay:
+    Доступні сьогодні сімейства replay:

    | Сімейство | Що воно підключає |
    | --- | --- |
-    | `openai-compatible` | Спільна політика replay у стилі OpenAI для OpenAI-сумісних транспортів, включно з очищенням tool-call-id, виправленням порядку assistant-first і загальною валідацією Gemini-turn там, де це потрібно транспорту |
-    | `anthropic-by-model` | Політика replay з урахуванням Claude, яка вибирається за `modelId`, тож транспорти Anthropic-message отримують Claude-специфічне очищення thinking-block лише тоді, коли визначена модель справді має id Claude |
-    | `google-gemini` | Нативна політика replay для Gemini плюс очищення bootstrap replay і режим tagged reasoning-output |
-    | `passthrough-gemini` | Очищення thought-signature для моделей Gemini, що працюють через OpenAI-сумісні проксі-транспорти; не вмикає нативну валідацію replay Gemini або bootstrap-перезаписи |
-    | `hybrid-anthropic-openai` | Гібридна політика для постачальників, які поєднують поверхні моделей Anthropic-message і OpenAI-compatible в одному плагіні; необов’язкове відкидання thinking-block лише для Claude залишається обмеженим стороною Anthropic |
+    | `openai-compatible` | Спільну політику replay у стилі OpenAI для OpenAI-сумісних транспортів, включно з очищенням tool-call-id, виправленнями порядку assistant-first і загальною валідацією Gemini-turn там, де цього потребує транспорт |
+    | `anthropic-by-model` | Політику replay з урахуванням Claude, яка вибирається за `modelId`, тож транспорти Anthropic-message отримують специфічне для Claude очищення thinking-block лише тоді, коли визначена модель справді має id Claude |
+    | `google-gemini` | Нативну політику replay Gemini плюс очищення bootstrap replay і режим tagged reasoning-output |
+    | `passthrough-gemini` | Очищення Gemini thought-signature для моделей Gemini, що працюють через OpenAI-сумісні проксі-транспорти; не вмикає нативну валідацію replay Gemini або переписування bootstrap |
+    | `hybrid-anthropic-openai` | Гібридну політику для постачальників, які поєднують поверхні моделей Anthropic-message та OpenAI-compatible в одному плагіні; необов’язкове видалення thinking-block лише для Claude залишається обмеженим стороною Anthropic |

    Реальні вбудовані приклади:

@ -328,17 +329,17 @@ x-i18n:
    - `minimax`: `hybrid-anthropic-openai`
    - `moonshot`, `ollama`, `xai` і `zai`: `openai-compatible`

-    Доступні на сьогодні сімейства потоків:
+    Доступні сьогодні сімейства потоків:

    | Сімейство | Що воно підключає |
    | --- | --- |
-    | `google-thinking` | Нормалізація payload thinking Gemini на спільному шляху потоку |
-    | `kilocode-thinking` | Обгортка reasoning Kilo на спільному шляху потоку проксі, де `kilo/auto` і непідтримувані id reasoning проксі пропускають ін’єкцію thinking |
-    | `moonshot-thinking` | Відображення payload native-thinking Moonshot у двійковому форматі з config + рівня `/think` |
-    | `minimax-fast-mode` | Перезапис моделі fast-mode MiniMax на спільному шляху потоку |
-    | `openai-responses-defaults` | Спільні нативні обгортки OpenAI/Codex Responses: заголовки attribution, `/fast`/`serviceTier`, деталізація тексту, нативний вебпошук Codex, формування payload для сумісності reasoning і керування контекстом Responses |
-    | `openrouter-thinking` | Обгортка reasoning OpenRouter для маршрутів проксі, з централізованою обробкою пропусків для непідтримуваних моделей/`auto` |
-    | `tool-stream-default-on` | Обгортка `tool_stream`, увімкнена за замовчуванням, для постачальників на кшталт Z.AI, які хочуть потокову передачу інструментів, якщо її не вимкнено явно |
+    | `google-thinking` | Нормалізацію payload thinking Gemini у спільному шляху потоку |
+    | `kilocode-thinking` | Обгортку Kilo reasoning у спільному шляху проксі-потоку, де `kilo/auto` і непідтримувані id reasoning проксі пропускають ін’єкцію thinking |
+    | `moonshot-thinking` | Відображення бінарного payload native-thinking Moonshot із config + рівня `/think` |
+    | `minimax-fast-mode` | Переписування моделі MiniMax fast-mode у спільному шляху потоку |
+    | `openai-responses-defaults` | Спільні нативні обгортки OpenAI/Codex Responses: заголовки attribution, `/fast`/`serviceTier`, текстова verbosity, нативний вебпошук Codex, формування payload для reasoning-compat і керування контекстом Responses |
+    | `openrouter-thinking` | Обгортку OpenRouter reasoning для маршрутів проксі, з централізованою обробкою пропусків для непідтримуваних моделей/`auto` |
+    | `tool-stream-default-on` | Обгортку `tool_stream`, увімкнену за замовчуванням, для постачальників на кшталт Z.AI, яким потрібен потоковий режим інструментів, якщо його явно не вимкнено |

    Реальні вбудовані приклади:

@ -351,23 +352,23 @@ x-i18n:
    - `zai`: `tool-stream-default-on`

    `openclaw/plugin-sdk/provider-model-shared` також експортує enum сімейств
-    replay, а також спільні хелпери, з яких ці сімейства побудовані. Поширені публічні
+    replay, а також спільні хелпери, з яких ці сімейства побудовані. Типові публічні
    експорти включають:

    - `ProviderReplayFamily`
    - `buildProviderReplayFamilyHooks(...)`
-    - спільні builder-хелпери replay, такі як `buildOpenAICompatibleReplayPolicy(...)`,
+    - спільні builder-и replay, такі як `buildOpenAICompatibleReplayPolicy(...)`,
      `buildAnthropicReplayPolicyForModel(...)`,
      `buildGoogleGeminiReplayPolicy(...)` і
      `buildHybridAnthropicOrOpenAIReplayPolicy(...)`
    - хелпери replay Gemini, такі як `sanitizeGoogleGeminiReplayHistory(...)`
      і `resolveTaggedReasoningOutputMode()`
-    - хелпери для кінцевих точок/моделей, такі як `resolveProviderEndpoint(...)`,
+    - хелпери endpoint/model, такі як `resolveProviderEndpoint(...)`,
      `normalizeProviderId(...)`, `normalizeGooglePreviewModelId(...)` і
      `normalizeNativeXaiModelId(...)`

-    `openclaw/plugin-sdk/provider-stream` надає і builder сімейств, і
-    публічні хелпери-обгортки, які ці сімейства повторно використовують. Поширені публічні експорти
+    `openclaw/plugin-sdk/provider-stream` надає як builder сімейств, так і
+    публічні хелпери-обгортки, які ці сімейства повторно використовують. Типові публічні експорти
    включають:

    - `ProviderStreamFamily`
@ -386,45 +387,45 @@ x-i18n:
    приклад: `@openclaw/anthropic-provider` експортує
    `wrapAnthropicProviderStream`, `resolveAnthropicBetas`,
    `resolveAnthropicFastMode`, `resolveAnthropicServiceTier` і
-    низькорівневі builder-обгортки Anthropic зі свого публічного шва `api.ts` /
+    низькорівневі builder-и обгорток Anthropic через свій публічний seam `api.ts` /
    `contract-api.ts`. Ці хелпери залишаються специфічними для Anthropic, тому
-    що вони також кодують обробку бета-версій Claude OAuth і gating `context1m`.
+    що вони також кодують обробку Claude OAuth beta і gating `context1m`.

-    Інші вбудовані постачальники також зберігають специфічні для транспорту обгортки локально, коли
-    таку поведінку неможливо чисто поділити між сімействами. Поточний приклад: вбудований
-    плагін xAI зберігає нативне формування Responses xAI у власному
-    `wrapStreamFn`, включно з перезаписами псевдонімів `/fast`, `tool_stream`
+    Інші вбудовані постачальники також тримають локальними обгортки, специфічні для транспорту, коли
+    цю поведінку не можна чисто поділити між сімействами. Поточний приклад: вбудований
+    плагін xAI тримає формування нативних xAI Responses у власному
+    `wrapStreamFn`, включно з переписуванням псевдонімів `/fast`, `tool_stream`
    за замовчуванням, очищенням непідтримуваних strict-tool і видаленням
-    payload reasoning, специфічного для xAI.
+    payload reasoning, специфічним для xAI.

    `openclaw/plugin-sdk/provider-tools` наразі надає одне спільне
-    сімейство схем інструментів плюс спільні хелпери схем/сумісності:
+    сімейство схем інструментів плюс спільні хелпери schema/compat:

-    - `ProviderToolCompatFamily` документує поточний спільний перелік сімейств.
-    - `buildProviderToolCompatFamilyHooks("gemini")` підключає
-      очищення схеми Gemini + діагностику для постачальників, яким потрібні безпечні для Gemini схеми інструментів.
+    - `ProviderToolCompatFamily` документує поточний набір спільних сімейств.
+    - `buildProviderToolCompatFamilyHooks("gemini")` підключає очищення схеми Gemini
+      + діагностику для постачальників, яким потрібні безпечні для Gemini схеми інструментів.
    - `normalizeGeminiToolSchemas(...)` і `inspectGeminiToolSchemas(...)`
-      — це базові публічні хелпери схем Gemini.
-    - `resolveXaiModelCompatPatch()` повертає вбудований патч сумісності xAI:
-      `toolSchemaProfile: "xai"`, непідтримувані ключові слова схем, нативну
-      підтримку `web_search` і декодування HTML-сутностей у аргументах виклику інструментів.
-    - `applyXaiModelCompat(model)` застосовує той самий патч сумісності xAI до
-      визначеної моделі, перш ніж вона потрапить до runner.
+      є базовими публічними хелперами схем Gemini.
+    - `resolveXaiModelCompatPatch()` повертає вбудований compat patch xAI:
+      `toolSchemaProfile: "xai"`, непідтримувані ключові слова схеми, нативну
+      підтримку `web_search` і декодування аргументів виклику інструментів із HTML-entity.
+    - `applyXaiModelCompat(model)` застосовує той самий compat patch xAI до
+      визначеної моделі до того, як вона потрапить до runner.

    Реальний вбудований приклад: плагін xAI використовує `normalizeResolvedModel` плюс
-    `contributeResolvedModelCompat`, щоб ці метадані сумісності залишалися у володінні
-    постачальника, а не були жорстко закодовані в core.
+    `contributeResolvedModelCompat`, щоб ці метадані compat належали
+    постачальнику, а не жорстко кодували правила xAI в core.

-    Той самий шаблон package-root також лежить в основі інших вбудованих постачальників:
+    Такий самий шаблон package-root також використовується в інших вбудованих постачальниках:

    - `@openclaw/openai-provider`: `api.ts` експортує builder-и постачальників,
      хелпери моделей за замовчуванням і builder-и realtime-постачальників
    - `@openclaw/openrouter-provider`: `api.ts` експортує builder
-      постачальника, а також хелпери onboarding/config
+      постачальника разом із хелперами onboarding/config

    <Tabs>
-      <Tab title="Обмін токенами">
-        Для постачальників, яким потрібен обмін токенами перед кожним викликом інференсу:
+      <Tab title="Обмін токенів">
+        Для постачальників, яким потрібен обмін токенів перед кожним викликом інференсу:

        ```typescript
        prepareRuntimeAuth: async (ctx) => {
@ -456,8 +457,8 @@ x-i18n:
        ```
      </Tab>
      <Tab title="Ідентичність нативного транспорту">
-        Для постачальників, яким потрібні нативні заголовки або метадані запиту/сесії на
-        загальних HTTP- або WebSocket-транспортах:
+        Для постачальників, яким потрібні нативні заголовки запиту/сесії або метадані в
+        узагальнених HTTP- чи WebSocket-транспортах:

        ```typescript
        resolveTransportTurnState: (ctx) => ({
@ -477,7 +478,7 @@ x-i18n:
        }),
        ```
      </Tab>
-      <Tab title="Використання та білінг">
+      <Tab title="Використання й білінг">
        Для постачальників, які надають дані про використання/білінг:

        ```typescript
@ -493,83 +494,84 @@ x-i18n:
    </Tabs>

    <Accordion title="Усі доступні хуки постачальника">
-      OpenClaw викликає хуки в такому порядку. Більшість постачальників використовують лише 2-3:
+      OpenClaw викликає хуки в такому порядку. Більшість постачальників використовують лише 2–3:

-      | # | Hook | Коли використовувати |
+      | # | Хук | Коли використовувати |
      | --- | --- | --- |
-      | 1 | `catalog` | Каталог моделей або значення `baseUrl` за замовчуванням |
+      | 1 | `catalog` | Каталог моделей або базові значення `baseUrl` |
      | 2 | `applyConfigDefaults` | Глобальні значення за замовчуванням, що належать постачальнику, під час materialization config |
-      | 3 | `normalizeModelId` | Очищення псевдонімів legacy/preview model-id перед пошуком |
-      | 4 | `normalizeTransport` | Очищення `api` / `baseUrl` сімейства постачальника перед загальним збиранням моделі |
+      | 3 | `normalizeModelId` | Очищення застарілих/preview псевдонімів model-id перед пошуком |
+      | 4 | `normalizeTransport` | Очищення `api` / `baseUrl` сімейства постачальника перед збиранням узагальненої моделі |
      | 5 | `normalizeConfig` | Нормалізація config `models.providers.<id>` |
-      | 6 | `applyNativeStreamingUsageCompat` | Перезаписи сумісності native streaming-usage для постачальників config |
+      | 6 | `applyNativeStreamingUsageCompat` | Переписування native streaming-usage compat для постачальників config |
      | 7 | `resolveConfigApiKey` | Визначення автентифікації env-marker, що належить постачальнику |
-      | 8 | `resolveSyntheticAuth` | Синтетична автентифікація для локальних/self-hosted або config-backed випадків |
-      | 9 | `shouldDeferSyntheticProfileAuth` | Опускати синтетичні placeholder-и збережених профілів нижче за env/config auth |
+      | 8 | `resolveSyntheticAuth` | Синтетична автентифікація для local/self-hosted або на основі config |
+      | 9 | `shouldDeferSyntheticProfileAuth` | Опускання синтетичних placeholder-ів збереженого профілю нижче за env/config auth |
      | 10 | `resolveDynamicModel` | Приймати довільні id моделей upstream |
      | 11 | `prepareDynamicModel` | Асинхронне отримання метаданих перед визначенням |
-      | 12 | `normalizeResolvedModel` | Перезаписи транспорту перед runner |
+      | 12 | `normalizeResolvedModel` | Переписування транспорту перед runner |

    Примітки щодо runtime fallback:

-    - `normalizeConfig` спочатку перевіряє відповідний постачальник, а потім інші
+    - `normalizeConfig` спочатку перевіряє відповідного постачальника, а потім інші
      плагіни постачальників із підтримкою хуків, доки один із них справді не змінить config.
      Якщо жоден хук постачальника не переписує підтримуваний запис config сімейства Google,
-      усе одно застосовується вбудований нормалізатор config Google.
+      усе одно застосовується вбудований normalizer config Google.
    - `resolveConfigApiKey` використовує хук постачальника, якщо він доступний. Вбудований
      шлях `amazon-bedrock` також має тут вбудований resolver AWS env-marker,
-      хоча сама runtime-автентифікація Bedrock і далі використовує стандартний
+      хоча сама runtime-автентифікація Bedrock усе ще використовує стандартний
      ланцюжок AWS SDK.
-      | 13 | `contributeResolvedModelCompat` | Прапори сумісності для моделей постачальників за іншим сумісним транспортом |
-      | 14 | `capabilities` | Legacy-мішок статичних можливостей; лише для сумісності |
+      | 13 | `contributeResolvedModelCompat` | Прапори compat для моделей постачальників за іншим сумісним транспортом |
+      | 14 | `capabilities` | Застарілий статичний набір capability; лише для сумісності |
      | 15 | `normalizeToolSchemas` | Очищення схеми інструментів, що належить постачальнику, перед реєстрацією |
      | 16 | `inspectToolSchemas` | Діагностика схеми інструментів, що належить постачальнику |
-      | 17 | `resolveReasoningOutputMode` | Контракт виходу reasoning: tagged чи native |
+      | 17 | `resolveReasoningOutputMode` | Контракт tagged vs native reasoning-output |
      | 18 | `prepareExtraParams` | Параметри запиту за замовчуванням |
      | 19 | `createStreamFn` | Повністю власний транспорт StreamFn |
-      | 20 | `wrapStreamFn` | Власні обгортки заголовків/тіла на стандартному шляху потоку |
-      | 21 | `resolveTransportTurnState` | Нативні заголовки/метадані для кожного ходу |
-      | 22 | `resolveWebSocketSessionPolicy` | Нативні заголовки сесії WS / час охолодження |
-      | 23 | `formatApiKey` | Власна форма runtime-токена |
+      | 20 | `wrapStreamFn` | Власні обгортки заголовків/тіла в звичайному шляху потоку |
+      | 21 | `resolveTransportTurnState` | Нативні заголовки/метадані для кожного turn |
+      | 22 | `resolveWebSocketSessionPolicy` | Нативні заголовки сесії WS / cool-down |
+      | 23 | `formatApiKey` | Власний формат runtime-токена |
      | 24 | `refreshOAuth` | Власне оновлення OAuth |
-      | 25 | `buildAuthDoctorHint` | Підказка для відновлення автентифікації |
-      | 26 | `matchesContextOverflowError` | Визначення переповнення, що належить постачальнику |
+      | 25 | `buildAuthDoctorHint` | Порада з відновлення автентифікації |
+      | 26 | `matchesContextOverflowError` | Визначення overflow, що належить постачальнику |
      | 27 | `classifyFailoverReason` | Класифікація rate-limit/overload, що належить постачальнику |
-      | 28 | `isCacheTtlEligible` | Керування TTL кешу промптів |
+      | 28 | `isCacheTtlEligible` | Контроль TTL кешу промптів |
      | 29 | `buildMissingAuthMessage` | Власна підказка про відсутню автентифікацію |
      | 30 | `suppressBuiltInModel` | Приховати застарілі рядки upstream |
-      | 31 | `augmentModelCatalog` | Синтетичні рядки для forward-compat |
-      | 32 | `isBinaryThinking` | Увімкнення/вимкнення двійкового thinking |
+      | 31 | `augmentModelCatalog` | Синтетичні рядки для прямої forward-compat |
+      | 32 | `isBinaryThinking` | Бінарний режим thinking увімк./вимк. |
      | 33 | `supportsXHighThinking` | Підтримка reasoning `xhigh` |
      | 34 | `supportsAdaptiveThinking` | Підтримка adaptive thinking |
-      | 35 | `resolveDefaultThinkingLevel` | Політика `/think` за замовчуванням |
-      | 36 | `isModernModelRef` | Відповідність моделей для live/smoke |
-      | 37 | `prepareRuntimeAuth` | Обмін токенами перед інференсом |
-      | 38 | `resolveUsageAuth` | Власний розбір облікових даних використання |
-      | 39 | `fetchUsageSnapshot` | Власна кінцева точка використання |
-      | 40 | `createEmbeddingProvider` | Адаптер embedding, що належить постачальнику, для пам’яті/пошуку |
-      | 41 | `buildReplayPolicy` | Власна політика replay/Compaction транскрипту |
-      | 42 | `sanitizeReplayHistory` | Специфічні для постачальника перезаписи replay після загального очищення |
-      | 43 | `validateReplayTurns` | Сувора валідація ходів replay перед вбудованим runner |
-      | 44 | `onModelSelected` | Зворотний виклик після вибору моделі (наприклад, телеметрія) |
+      | 35 | `supportsMaxThinking` | Підтримка reasoning `max` |
+      | 36 | `resolveDefaultThinkingLevel` | Політика `/think` за замовчуванням |
+      | 37 | `isModernModelRef` | Відповідність моделей live/smoke |
+      | 38 | `prepareRuntimeAuth` | Обмін токенів перед інференсом |
+      | 39 | `resolveUsageAuth` | Власний парсинг облікових даних usage |
+      | 40 | `fetchUsageSnapshot` | Власний endpoint usage |
+      | 41 | `createEmbeddingProvider` | Адаптер embedding, що належить постачальнику, для пам’яті/пошуку |
+      | 42 | `buildReplayPolicy` | Власна політика replay/Compaction транскрипту |
+      | 43 | `sanitizeReplayHistory` | Переписування replay, специфічні для постачальника, після узагальненого очищення |
+      | 44 | `validateReplayTurns` | Строга валідація replay-turn перед вбудованим runner |
+      | 45 | `onModelSelected` | Колбек після вибору моделі (наприклад, telemetry) |

      Примітка щодо налаштування промптів:

-      - `resolveSystemPromptContribution` дозволяє постачальнику інжектувати
-        cache-aware інструкції для системного промпту для сімейства моделей. Віддавайте перевагу йому замість
-        `before_prompt_build`, коли поведінка належить одному сімейству постачальника/моделі
-        і має зберігати стабільний/динамічний поділ кешу.
+      - `resolveSystemPromptContribution` дозволяє постачальнику додавати cache-aware
+        настанови для системного промпту для сімейства моделей. Надавайте йому перевагу перед
+        `before_prompt_build`, коли поведінка належить одному постачальнику/сімейству моделей
+        і має зберігати стабільний/динамічний розподіл кешу.

-      Докладні описи та приклади з реального світу див. у
-      [Внутрішні компоненти: runtime-хуки постачальника](/uk/plugins/architecture#provider-runtime-hooks).
+      Докладні описи та приклади з реального світу дивіться в
+      [Інтернали: Runtime-хуки постачальника](/uk/plugins/architecture#provider-runtime-hooks).
    </Accordion>

  </Step>

  <Step title="Додайте додаткові можливості (необов’язково)">
    <a id="step-5-add-extra-capabilities"></a>
-    Плагін постачальника може реєструвати мовлення, транскрипцію в реальному часі, голос у реальному
-    часі, розуміння медіа, генерацію зображень, генерацію відео, web fetch
+    Плагін постачальника може реєструвати speech, realtime transcription, realtime
+    voice, media understanding, image generation, video generation, web fetch
    і web search поряд із текстовим інференсом:

    ```typescript
@ -679,19 +681,19 @@ x-i18n:
    ```

    OpenClaw класифікує це як плагін **hybrid-capability**. Це
-    рекомендований шаблон для корпоративних плагінів (один плагін на одного постачальника). Див.
-    [Внутрішні компоненти: володіння можливостями](/uk/plugins/architecture#capability-ownership-model).
+    рекомендований шаблон для корпоративних плагінів (один плагін на постачальника). Див.
+    [Інтернали: Володіння можливостями](/uk/plugins/architecture#capability-ownership-model).

-    Для генерації відео віддавайте перевагу показаній вище структурі можливостей з урахуванням режимів:
+    Для генерації відео надавайте перевагу показаній вище структурі можливостей з урахуванням режимів:
    `generate`, `imageToVideo` і `videoToVideo`. Плоскі агреговані поля, такі
    як `maxInputImages`, `maxInputVideos` і `maxDurationSeconds`, не
-    достатні, щоб чисто оголосити підтримку режимів перетворення або вимкнених режимів.
+    достатні, щоб коректно оголосити підтримку режимів перетворення або вимкнених режимів.

    Постачальники генерації музики мають дотримуватися того самого шаблону:
    `generate` для генерації лише за промптом і `edit` для генерації
-    на основі референсного зображення. Плоскі агреговані поля, такі як `maxInputImages`,
+    на основі зображення-референсу. Плоскі агреговані поля, такі як `maxInputImages`,
    `supportsLyrics` і `supportsFormat`, не достатні, щоб оголосити
-    підтримку редагування; очікуваний контракт — це явні блоки `generate` / `edit`.
+    підтримку редагування; очікуваним контрактом є явні блоки `generate` / `edit`.

  </Step>

@ -732,43 +734,43 @@ x-i18n:

 ## Публікація в ClawHub

-Плагіни постачальників публікуються так само, як і будь-які інші зовнішні кодові плагіни:
+Плагіни постачальників публікуються так само, як і будь-який інший зовнішній кодовий плагін:

 ```bash
 clawhub package publish your-org/your-plugin --dry-run
 clawhub package publish your-org/your-plugin
 ```

-Не використовуйте тут застарілий псевдонім публікації лише для Skills; пакети плагінів мають використовувати
+Не використовуйте тут застарілий псевдонім публікації лише для Skills; пакети плагінів повинні використовувати
 `clawhub package publish`.

 ## Структура файлів

 ```
 <bundled-plugin-root>/acme-ai/
-├── package.json              # Метадані openclaw.providers
-├── openclaw.plugin.json      # Маніфест із метаданими автентифікації постачальника
+├── package.json              # metadata openclaw.providers
+├── openclaw.plugin.json      # Маніфест із metadata автентифікації постачальника
 ├── index.ts                  # definePluginEntry + registerProvider
 └── src/
    ├── provider.test.ts      # Тести
-    └── usage.ts              # Кінцева точка використання (необов’язково)
+    └── usage.ts              # Endpoint usage (необов’язково)
 ```

-## Довідник щодо порядку каталогу
+## Довідка щодо порядку каталогу

-`catalog.order` визначає, коли ваш каталог зливається відносно вбудованих
+`catalog.order` керує тим, коли ваш каталог об’єднується відносно вбудованих
 постачальників:

-| Порядок     | Коли          | Випадок використання                          |
-| --------- | ------------- | ----------------------------------------------- |
-| `simple`  | Перший прохід    | Звичайні постачальники з API-ключем                         |
-| `profile` | Після simple  | Постачальники, обмежені профілями автентифікації                |
-| `paired`  | Після profile | Синтез кількох пов’язаних записів             |
-| `late`    | Останній прохід     | Перевизначення наявних постачальників (перемагає при конфлікті) |
+| Порядок   | Коли          | Випадок використання                           |
+| --------- | ------------- | ---------------------------------------------- |
+| `simple`  | Перший прохід | Звичайні постачальники з API-key               |
+| `profile` | Після simple  | Постачальники, що залежать від профілів auth   |
+| `paired`  | Після profile | Синтез кількох пов’язаних записів              |
+| `late`    | Останній прохід | Перевизначення наявних постачальників (перемагає при конфлікті) |

 ## Наступні кроки

 - [Плагіни каналів](/uk/plugins/sdk-channel-plugins) — якщо ваш плагін також надає канал
- [SDK Runtime](/uk/plugins/sdk-runtime) — хелпери `api.runtime` (TTS, пошук, subagent)
- [Огляд SDK](/uk/plugins/sdk-overview) — повний довідник з імпортів subpath
- [Внутрішні компоненти плагінів](/uk/plugins/architecture#provider-runtime-hooks) — деталі хуків і вбудовані приклади
+- [SDK Runtime](/uk/plugins/sdk-runtime) — хелпери `api.runtime` (TTS, search, subagent)
+- [Огляд SDK](/uk/plugins/sdk-overview) — повний довідник імпортів subpath
+- [Інтернали плагінів](/uk/plugins/architecture#provider-runtime-hooks) — подробиці про хуки та вбудовані приклади
--- a/docs/uk/providers/mistral.md
+++ b/docs/uk/providers/mistral.md
@ -1,22 +1,22 @@
 ---
 read_when:
    - Ви хочете використовувати моделі Mistral в OpenClaw
-    - Вам потрібні онбординг ключа API Mistral і посилання на моделі
+    - Вам потрібні онбординг для ключа API Mistral і посилання на моделі
 summary: Використовуйте моделі Mistral і транскрипцію Voxtral з OpenClaw
 title: Mistral
 x-i18n:
-    generated_at: "2026-04-12T10:33:33Z"
+    generated_at: "2026-04-21T06:04:44Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 0474f55587909ce9bbdd47b881262edbeb1b07eb3ed52de1090a8ec4d260c97b
+    source_hash: e87d04e3d45c04280c90821b1addd87dd612191249836747fba27cde48b9890f
    source_path: providers/mistral.md
    workflow: 15
 ---

 # Mistral

-OpenClaw підтримує Mistral як для маршрутизації текстових/зображувальних моделей (`mistral/...`), так і для транскрипції аудіо через Voxtral у media understanding.
-Mistral також можна використовувати для ембедингів пам’яті (`memorySearch.provider = "mistral"`).
+OpenClaw підтримує Mistral як для маршрутизації текстових/графічних моделей (`mistral/...`), так і для аудіотранскрипції через Voxtral у media understanding.
+Mistral також можна використовувати для вбудовувань пам’яті (`memorySearch.provider = "mistral"`).

 - Провайдер: `mistral`
 - Автентифікація: `MISTRAL_API_KEY`
@ -26,14 +26,14 @@ Mistral також можна використовувати для ембеди

 <Steps>
  <Step title="Отримайте свій ключ API">
-    Створіть ключ API в [Mistral Console](https://console.mistral.ai/).
+    Створіть ключ API у [Mistral Console](https://console.mistral.ai/).
  </Step>
  <Step title="Запустіть онбординг">
    ```bash
    openclaw onboard --auth-choice mistral-api-key
    ```

-    Або передайте ключ безпосередньо:
+    Або передайте ключ напряму:

    ```bash
    openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
@ -48,7 +48,7 @@ Mistral також можна використовувати для ембеди
    }
    ```
  </Step>
-  <Step title="Переконайтеся, що модель доступна">
+  <Step title="Перевірте, що модель доступна">
    ```bash
    openclaw models list --provider mistral
    ```
@ -61,17 +61,17 @@ Mistral також можна використовувати для ембеди

 | Посилання на модель               | Вхідні дані | Контекст | Макс. вивід | Примітки                                                         |
 | --------------------------------- | ----------- | -------- | ----------- | ---------------------------------------------------------------- |
-| `mistral/mistral-large-latest`   | text, image | 262,144  | 16,384      | Модель за замовчуванням                                          |
-| `mistral/mistral-medium-2508`    | text, image | 262,144  | 8,192       | Mistral Medium 3.1                                               |
-| `mistral/mistral-small-latest`   | text, image | 128,000  | 16,384      | Mistral Small 4; регульоване міркування через API `reasoning_effort` |
-| `mistral/pixtral-large-latest`   | text, image | 128,000  | 32,768      | Pixtral                                                          |
-| `mistral/codestral-latest`       | text        | 256,000  | 4,096       | Програмування                                                    |
-| `mistral/devstral-medium-latest` | text        | 262,144  | 32,768      | Devstral 2                                                       |
-| `mistral/magistral-small`        | text        | 128,000  | 40,000      | З увімкненим міркуванням                                         |
+| `mistral/mistral-large-latest`    | текст, зображення | 262,144 | 16,384      | Модель за замовчуванням                                          |
+| `mistral/mistral-medium-2508`     | текст, зображення | 262,144 | 8,192       | Mistral Medium 3.1                                               |
+| `mistral/mistral-small-latest`    | текст, зображення | 128,000 | 16,384      | Mistral Small 4; регульоване мислення через API `reasoning_effort` |
+| `mistral/pixtral-large-latest`    | текст, зображення | 128,000 | 32,768      | Pixtral                                                          |
+| `mistral/codestral-latest`        | текст       | 256,000 | 4,096       | Програмування                                                    |
+| `mistral/devstral-medium-latest`  | текст       | 262,144 | 32,768      | Devstral 2                                                       |
+| `mistral/magistral-small`         | текст       | 128,000 | 40,000      | Із підтримкою міркування                                         |

-## Транскрипція аудіо (Voxtral)
+## Аудіотранскрипція (Voxtral)

-Використовуйте Voxtral для транскрипції аудіо через конвеєр media understanding.
+Використовуйте Voxtral для аудіотранскрипції через конвеєр media understanding.

 ```json5
 {
@ -93,24 +93,24 @@ Mistral також можна використовувати для ембеди
 ## Розширена конфігурація

 <AccordionGroup>
-  <Accordion title="Регульоване міркування (mistral-small-latest)">
-    `mistral/mistral-small-latest` відповідає Mistral Small 4 і підтримує [регульоване міркування](https://docs.mistral.ai/capabilities/reasoning/adjustable) в API Chat Completions через `reasoning_effort` (`none` мінімізує додаткове міркування у виводі; `high` показує повні сліди міркування перед фінальною відповіддю).
+  <Accordion title="Регульоване мислення (mistral-small-latest)">
+    `mistral/mistral-small-latest` відповідає Mistral Small 4 і підтримує [регульоване мислення](https://docs.mistral.ai/capabilities/reasoning/adjustable) в API Chat Completions через `reasoning_effort` (`none` зводить додаткові міркування у виводі до мінімуму; `high` показує повні сліди міркувань перед фінальною відповіддю).

-    OpenClaw зіставляє рівень **thinking** сесії з API Mistral:
+    OpenClaw зіставляє рівень **мислення** сесії з API Mistral:

-    | Рівень thinking в OpenClaw                    | Mistral `reasoning_effort` |
-    | --------------------------------------------- | -------------------------- |
-    | **off** / **minimal**                         | `none`                     |
-    | **low** / **medium** / **high** / **xhigh** / **adaptive** | `high`             |
+    | Рівень мислення OpenClaw                         | Mistral `reasoning_effort` |
+    | ------------------------------------------------ | -------------------------- |
+    | **off** / **minimal**                            | `none`                     |
+    | **low** / **medium** / **high** / **xhigh** / **adaptive** / **max** | `high`     |

    <Note>
-    Інші моделі у вбудованому каталозі Mistral не використовують цей параметр. Продовжуйте використовувати моделі `magistral-*`, якщо вам потрібна нативна поведінка Mistral, орієнтована насамперед на міркування.
+    Інші моделі з вбудованого каталогу Mistral не використовують цей параметр. Продовжуйте використовувати моделі `magistral-*`, якщо вам потрібна рідна для Mistral поведінка, орієнтована насамперед на міркування.
    </Note>

  </Accordion>

-  <Accordion title="Ембединги пам’яті">
-    Mistral може надавати ембединги пам’яті через `/v1/embeddings` (модель за замовчуванням: `mistral-embed`).
+  <Accordion title="Вбудовування пам’яті">
+    Mistral може надавати вбудовування пам’яті через `/v1/embeddings` (модель за замовчуванням: `mistral-embed`).

    ```json5
    {
@ -123,7 +123,7 @@ Mistral також можна використовувати для ембеди
  <Accordion title="Автентифікація та базовий URL">
    - Автентифікація Mistral використовує `MISTRAL_API_KEY`.
    - Базовий URL провайдера за замовчуванням: `https://api.mistral.ai/v1`.
-    - Модель онбордингу за замовчуванням — `mistral/mistral-large-latest`.
+    - Моделлю за замовчуванням для онбордингу є `mistral/mistral-large-latest`.
    - Z.AI використовує Bearer-автентифікацію з вашим ключем API.
  </Accordion>
 </AccordionGroup>
@ -135,6 +135,6 @@ Mistral також можна використовувати для ембеди
    Вибір провайдерів, посилань на моделі та поведінки резервного перемикання.
  </Card>
  <Card title="Media understanding" href="/tools/media-understanding" icon="microphone">
-    Налаштування транскрипції аудіо та вибір провайдера.
+    Налаштування аудіотранскрипції та вибір провайдера.
  </Card>
 </CardGroup>
--- a/docs/uk/tools/thinking.md
+++ b/docs/uk/tools/thinking.md
@ -1,124 +1,127 @@
 ---
 read_when:
-    - Налаштування синтаксичного аналізу або значень за замовчуванням для директив мислення, швидкого режиму чи докладності
+    - Налаштування аналізу директив мислення, швидкого режиму або докладного режиму чи їхніх значень за замовчуванням
 summary: Синтаксис директив для /think, /fast, /verbose, /trace і видимості міркувань
 title: Рівні мислення
 x-i18n:
-    generated_at: "2026-04-21T05:21:16Z"
+    generated_at: "2026-04-21T06:04:47Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 7fbcb2feb14331e000ae0bcb908f060dba0ce900d6628a42e87e98502b13f6e9
+    source_hash: edee9420e1cc3eccfa18d87061c4a4d6873e70cb51fff85305fafbcd6a5d6a7d
    source_path: tools/thinking.md
    workflow: 15
 ---

-# Рівні мислення (/think директиви)
+# Рівні мислення (директиви `/think`)

 ## Що це робить

 - Вбудована директива в будь-якому вхідному тілі: `/t <level>`, `/think:<level>` або `/thinking <level>`.
- Рівні (аліаси): `off | minimal | low | medium | high | xhigh | adaptive`
+- Рівні (псевдоніми): `off | minimal | low | medium | high | xhigh | adaptive | max`
  - minimal → «think»
  - low → «think hard»
  - medium → «think harder»
  - high → «ultrathink» (максимальний бюджет)
-  - xhigh → «ultrathink+» (зусилля GPT-5.2 + моделей Codex і Anthropic Claude Opus 4.7)
-  - adaptive → adaptive thinking, кероване провайдером (підтримується для Claude 4.6 на Anthropic/Bedrock і Anthropic Claude Opus 4.7)
+  - xhigh → «ultrathink+» (зусилля GPT-5.2 + Codex models і Anthropic Claude Opus 4.7)
+  - adaptive → кероване провайдером адаптивне мислення (підтримується для Claude 4.6 на Anthropic/Bedrock і Anthropic Claude Opus 4.7)
+  - max → максимальне міркування провайдера (наразі Anthropic Claude Opus 4.7)
  - `x-high`, `x_high`, `extra-high`, `extra high` і `extra_high` зіставляються з `xhigh`.
-  - `highest`, `max` зіставляються з `high`.
+  - `highest` зіставляється з `high`.
 - Примітки щодо провайдерів:
-  - `adaptive` рекламується лише в нативних меню команд і засобах вибору для провайдерів/моделей, які заявляють підтримку adaptive thinking. Воно, як і раніше, приймається як введена директива для сумісності з наявними конфігураціями та аліасами.
+  - `adaptive` показується лише в нативних меню команд і засобах вибору для провайдерів/моделей, які декларують підтримку adaptive thinking. Воно, як і раніше, приймається як введена директива для сумісності з наявними конфігураціями та псевдонімами.
+  - `max` показується лише в нативних меню команд і засобах вибору для провайдерів/моделей, які декларують підтримку max thinking. Наявні збережені параметри `max` повторно зіставляються з найбільшим підтримуваним рівнем для вибраної моделі, якщо модель не підтримує `max`.
  - Моделі Anthropic Claude 4.6 за замовчуванням використовують `adaptive`, якщо явний рівень мислення не задано.
-  - Anthropic Claude Opus 4.7 не використовує adaptive thinking за замовчуванням. Типове значення effort в його API залишається на боці провайдера, якщо ви явно не задасте рівень мислення.
-  - Anthropic Claude Opus 4.7 зіставляє `/think xhigh` з adaptive thinking плюс `output_config.effort: "xhigh"`, тому що `/think` — це директива мислення, а `xhigh` — це параметр effort для Opus 4.7.
-  - Моделі OpenAI GPT зіставляють `/think` через підтримку effort у Responses API, специфічну для моделі. `/think off` надсилає `reasoning.effort: "none"` лише коли цільова модель це підтримує; інакше OpenClaw пропускає payload із вимкненим reasoning, а не надсилає непідтримуване значення.
-  - MiniMax (`minimax/*`) на Anthropic-сумісному потоковому шляху за замовчуванням використовує `thinking: { type: "disabled" }`, якщо ви явно не задали thinking у параметрах моделі або параметрах запиту. Це запобігає витоку delta `reasoning_content` із ненативного для Anthropic потокового формату MiniMax.
-  - Z.AI (`zai/*`) підтримує лише бінарне мислення (`on`/`off`). Будь-який рівень, відмінний від `off`, трактується як `on` (зіставляється з `low`).
+  - Anthropic Claude Opus 4.7 не використовує adaptive thinking за замовчуванням. Його стандартне значення зусилля API залишається під керуванням провайдера, якщо ви явно не задасте рівень мислення.
+  - Anthropic Claude Opus 4.7 зіставляє `/think xhigh` з adaptive thinking плюс `output_config.effort: "xhigh"`, оскільки `/think` — це директива мислення, а `xhigh` — це налаштування зусилля Opus 4.7.
+  - Anthropic Claude Opus 4.7 також підтримує `/think max`; воно зіставляється з тим самим шляхом максимального зусилля під керуванням провайдера.
+  - Моделі OpenAI GPT зіставляють `/think` через підтримку effort API Responses, специфічну для моделі. `/think off` надсилає `reasoning.effort: "none"` лише тоді, коли цільова модель це підтримує; інакше OpenClaw пропускає payload вимкненого міркування замість надсилання непідтримуваного значення.
+  - MiniMax (`minimax/*`) на сумісному з Anthropic шляху потокової передачі за замовчуванням використовує `thinking: { type: "disabled" }`, якщо ви явно не задасте thinking у params моделі або params запиту. Це запобігає витоку дельт `reasoning_content` із ненативного Anthropic-формату потоку MiniMax.
+  - Z.AI (`zai/*`) підтримує лише двійкове мислення (`on`/`off`). Будь-який рівень, відмінний від `off`, трактується як `on` (зіставляється з `low`).
  - Moonshot (`moonshot/*`) зіставляє `/think off` з `thinking: { type: "disabled" }`, а будь-який рівень, відмінний від `off`, — з `thinking: { type: "enabled" }`. Коли thinking увімкнено, Moonshot приймає лише `tool_choice` `auto|none`; OpenClaw нормалізує несумісні значення до `auto`.

 ## Порядок визначення

 1. Вбудована директива в повідомленні (застосовується лише до цього повідомлення).
 2. Перевизначення сесії (задається надсиланням повідомлення, що містить лише директиву).
-3. Типове значення для агента (`agents.list[].thinkingDefault` у конфігурації).
-4. Глобальне типове значення (`agents.defaults.thinkingDefault` у конфігурації).
-5. Резервний варіант: `adaptive` для моделей Anthropic Claude 4.6, `off` для Anthropic Claude Opus 4.7, якщо не налаштовано явно, `low` для інших моделей із підтримкою reasoning, інакше `off`.
+3. Значення за замовчуванням для агента (`agents.list[].thinkingDefault` у конфігурації).
+4. Глобальне значення за замовчуванням (`agents.defaults.thinkingDefault` у конфігурації).
+5. Резервне значення: `adaptive` для моделей Anthropic Claude 4.6, `off` для Anthropic Claude Opus 4.7, якщо це явно не налаштовано, `low` для інших моделей із підтримкою міркування, інакше `off`.

-## Установлення типового значення для сесії
+## Установлення значення за замовчуванням для сесії

 - Надішліть повідомлення, яке **містить лише** директиву (допускаються пробіли), наприклад `/think:medium` або `/t high`.
- Це закріплюється за поточною сесією (типово для кожного відправника окремо); скидається через `/think:off` або після скидання через неактивність сесії.
- Надсилається відповідь-підтвердження (`Thinking level set to high.` / `Thinking disabled.`). Якщо рівень невалідний (наприклад, `/thinking big`), команда відхиляється з підказкою, а стан сесії залишається без змін.
+- Воно закріплюється для поточної сесії (за замовчуванням для кожного відправника окремо); скидається через `/think:off` або скидання через неактивність сесії.
+- Надсилається відповідь-підтвердження (`Thinking level set to high.` / `Thinking disabled.`). Якщо рівень недійсний (наприклад, `/thinking big`), команду буде відхилено з підказкою, а стан сесії залишиться без змін.
 - Надішліть `/think` (або `/think:`) без аргументу, щоб побачити поточний рівень мислення.

 ## Застосування за агентом

- **Вбудований Pi**: визначений рівень передається в runtime внутрішнього агента Pi.
+- **Вбудований Pi**: визначений рівень передається до внутрішньопроцесного середовища виконання агента Pi.

-## Швидкий режим (/fast)
+## Швидкий режим (`/fast`)

 - Рівні: `on|off`.
- Повідомлення лише з директивою перемикає перевизначення швидкого режиму для сесії та відповідає `Fast mode enabled.` / `Fast mode disabled.`.
+- Повідомлення лише з директивою перемикає перевизначення швидкого режиму для сесії та повертає `Fast mode enabled.` / `Fast mode disabled.`.
 - Надішліть `/fast` (або `/fast status`) без режиму, щоб побачити поточний ефективний стан швидкого режиму.
 - OpenClaw визначає швидкий режим у такому порядку:
  1. Вбудована/окрема директива `/fast on|off`
  2. Перевизначення сесії
-  3. Типове значення для агента (`agents.list[].fastModeDefault`)
+  3. Значення за замовчуванням для агента (`agents.list[].fastModeDefault`)
  4. Конфігурація для моделі: `agents.defaults.models["<provider>/<model>"].params.fastMode`
-  5. Резервний варіант: `off`
- Для `openai/*` швидкий режим зіставляється з пріоритетною обробкою OpenAI через надсилання `service_tier=priority` у підтримуваних запитах Responses.
- Для `openai-codex/*` швидкий режим надсилає той самий прапорець `service_tier=priority` у Codex Responses. OpenClaw підтримує один спільний перемикач `/fast` для обох шляхів автентифікації.
- Для прямих публічних запитів `anthropic/*`, включно з трафіком, автентифікованим через OAuth і надісланим до `api.anthropic.com`, швидкий режим зіставляється з рівнями сервісу Anthropic: `/fast on` задає `service_tier=auto`, `/fast off` задає `service_tier=standard_only`.
+  5. Резервне значення: `off`
+- Для `openai/*` швидкий режим зіставляється з пріоритетною обробкою OpenAI шляхом надсилання `service_tier=priority` у підтримуваних запитах Responses.
+- Для `openai-codex/*` швидкий режим надсилає той самий прапорець `service_tier=priority` у Codex Responses. OpenClaw зберігає один спільний перемикач `/fast` для обох шляхів автентифікації.
+- Для прямих публічних запитів `anthropic/*`, включно з трафіком з OAuth-автентифікацією, надісланим до `api.anthropic.com`, швидкий режим зіставляється з рівнями сервісу Anthropic: `/fast on` задає `service_tier=auto`, `/fast off` задає `service_tier=standard_only`.
 - Для `minimax/*` на Anthropic-сумісному шляху `/fast on` (або `params.fastMode: true`) переписує `MiniMax-M2.7` на `MiniMax-M2.7-highspeed`.
- Явні параметри моделі Anthropic `serviceTier` / `service_tier` мають пріоритет над типовим значенням швидкого режиму, якщо задано обидва. OpenClaw усе одно пропускає вставлення рівня сервісу Anthropic для проксі base URL, які не належать Anthropic.
+- Явні параметри моделі Anthropic `serviceTier` / `service_tier` перевизначають стандартне значення швидкого режиму, якщо задано обидва. OpenClaw, як і раніше, пропускає вставлення рівня сервісу Anthropic для проксі URL-адрес, що не належать Anthropic.

-## Директиви докладності (/verbose або /v)
+## Докладні директиви (`/verbose` або `/v`)

 - Рівні: `on` (мінімальний) | `full` | `off` (типово).
- Повідомлення лише з директивою перемикає докладність для сесії та відповідає `Verbose logging enabled.` / `Verbose logging disabled.`; невалідні рівні повертають підказку без зміни стану.
- `/verbose off` зберігає явне перевизначення сесії; очистіть його через інтерфейс Sessions, вибравши `inherit`.
- Вбудована директива впливає лише на це повідомлення; в інших випадках застосовуються типові значення сесії/глобальні.
+- Повідомлення лише з директивою перемикає докладність сесії та повертає `Verbose logging enabled.` / `Verbose logging disabled.`; недійсні рівні повертають підказку без зміни стану.
+- `/verbose off` зберігає явне перевизначення сесії; очистьте його через інтерфейс Sessions, вибравши `inherit`.
+- Вбудована директива впливає лише на це повідомлення; в інших випадках застосовуються значення за замовчуванням для сесії/глобальні.
 - Надішліть `/verbose` (або `/verbose:`) без аргументу, щоб побачити поточний рівень докладності.
- Коли докладність увімкнена, агенти, які надсилають структуровані результати інструментів (Pi, інші JSON-агенти), повертають кожен виклик інструмента як окреме повідомлення лише з метаданими з префіксом `<emoji> <tool-name>: <arg>`, коли доступно (path/command). Ці короткі зведення інструментів надсилаються щойно кожен інструмент запускається (окремими бульбашками), а не як потокові delta.
- Короткі зведення про збої інструментів залишаються видимими у звичайному режимі, але суфікси з необробленими деталями помилок приховуються, якщо тільки докладність не `on` або `full`.
- Коли докладність `full`, вихідні дані інструментів також пересилаються після завершення (окремою бульбашкою, обрізані до безпечної довжини). Якщо ви перемкнете `/verbose on|full|off` під час активного виконання, наступні бульбашки інструментів врахують нове налаштування.
+- Коли verbose увімкнено, агенти, які надсилають структуровані результати інструментів (Pi, інші JSON-агенти), повертають кожен виклик інструмента як окреме повідомлення лише з метаданими з префіксом `<emoji> <tool-name>: <arg>`, коли доступно (шлях/команда). Ці підсумки інструментів надсилаються щойно кожен інструмент запускається (окремими бульбашками), а не як потокові дельти.
+- Підсумки збоїв інструментів залишаються видимими у звичайному режимі, але суфікси з необробленими подробицями помилок приховуються, якщо verbose не має значення `on` або `full`.
+- Коли verbose має значення `full`, виходи інструментів також пересилаються після завершення (окремою бульбашкою, обрізаною до безпечної довжини). Якщо ви перемкнете `/verbose on|full|off`, поки виконання ще триває, наступні бульбашки інструментів врахують нове налаштування.

-## Директиви trace Plugin (/trace)
+## Директиви трасування Plugin (`/trace`)

 - Рівні: `on` | `off` (типово).
- Повідомлення лише з директивою перемикає виведення trace Plugin для сесії та відповідає `Plugin trace enabled.` / `Plugin trace disabled.`.
- Вбудована директива впливає лише на це повідомлення; в інших випадках застосовуються типові значення сесії/глобальні.
- Надішліть `/trace` (або `/trace:`) без аргументу, щоб побачити поточний рівень trace.
- `/trace` вужчий за `/verbose`: він показує лише trace/debug-рядки, що належать Plugin, як-от зведення налагодження Active Memory.
- Рядки trace можуть з’являтися в `/status` і як додаткове діагностичне повідомлення після звичайної відповіді асистента.
+- Повідомлення лише з директивою перемикає виведення трасування plugin для сесії та повертає `Plugin trace enabled.` / `Plugin trace disabled.`.
+- Вбудована директива впливає лише на це повідомлення; в інших випадках застосовуються значення за замовчуванням для сесії/глобальні.
+- Надішліть `/trace` (або `/trace:`) без аргументу, щоб побачити поточний рівень трасування.
+- `/trace` вужчий за `/verbose`: він показує лише рядки трасування/налагодження, що належать plugin, наприклад підсумки налагодження Active Memory.
+- Рядки трасування можуть з’являтися в `/status` і як діагностичне повідомлення після звичайної відповіді помічника.

-## Видимість reasoning (/reasoning)
+## Видимість міркувань (`/reasoning`)

 - Рівні: `on|off|stream`.
 - Повідомлення лише з директивою перемикає, чи показуються блоки мислення у відповідях.
- Коли увімкнено, reasoning надсилається як **окреме повідомлення** з префіксом `Reasoning:`.
- `stream` (лише Telegram): потоково виводить reasoning у чернеткову бульбашку Telegram під час генерації відповіді, а потім надсилає фінальну відповідь без reasoning.
- Аліас: `/reason`.
- Надішліть `/reasoning` (або `/reasoning:`) без аргументу, щоб побачити поточний рівень reasoning.
- Порядок визначення: вбудована директива, потім перевизначення сесії, потім типове значення для агента (`agents.list[].reasoningDefault`), потім резервний варіант (`off`).
+- Коли ввімкнено, міркування надсилається як **окреме повідомлення** з префіксом `Reasoning:`.
+- `stream` (лише Telegram): транслює міркування в чернетку-бульбашку Telegram під час генерації відповіді, а потім надсилає фінальну відповідь без міркувань.
+- Псевдонім: `/reason`.
+- Надішліть `/reasoning` (або `/reasoning:`) без аргументу, щоб побачити поточний рівень видимості міркувань.
+- Порядок визначення: вбудована директива, потім перевизначення сесії, потім значення за замовчуванням для агента (`agents.list[].reasoningDefault`), потім резервне значення (`off`).

 ## Пов’язане

- Документація про elevated mode розміщена в [Elevated mode](/uk/tools/elevated).
+- Документація для elevated mode міститься в [Elevated mode](/uk/tools/elevated).

 ## Heartbeat

- Тіло запиту Heartbeat — це налаштований prompt heartbeat (типово: `Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`). Вбудовані директиви в повідомленні heartbeat застосовуються як завжди (але уникайте зміни типових значень сесії з heartbeat).
- Доставка Heartbeat за замовчуванням надсилає лише фінальний payload. Щоб також надсилати окреме повідомлення `Reasoning:` (коли доступне), задайте `agents.defaults.heartbeat.includeReasoning: true` або для агента `agents.list[].heartbeat.includeReasoning: true`.
+- Тіло probe Heartbeat — це налаштований запит heartbeat (типово: `Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`). Вбудовані директиви в heartbeat-повідомленні застосовуються як зазвичай (але уникайте зміни значень сесії за замовчуванням із heartbeat).
+- Доставка Heartbeat типово використовує лише фінальний payload. Щоб також надсилати окреме повідомлення `Reasoning:` (коли воно доступне), задайте `agents.defaults.heartbeat.includeReasoning: true` або для конкретного агента `agents.list[].heartbeat.includeReasoning: true`.

-## Інтерфейс вебчату
+## Вебінтерфейс чату

- Селектор мислення у вебчаті відображає збережений рівень сесії зі сховища/конфігурації вхідної сесії під час завантаження сторінки.
- Вибір іншого рівня негайно записує перевизначення сесії через `sessions.patch`; він не чекає наступного надсилання і не є одноразовим перевизначенням `thinkingOnce`.
- Перший варіант завжди `Default (<resolved level>)`, де визначене типове значення береться з активної моделі сесії: `adaptive` для Claude 4.6 на Anthropic, `off` для Anthropic Claude Opus 4.7, якщо не налаштовано, `low` для інших моделей із підтримкою reasoning, інакше `off`.
- Засіб вибору залишається залежним від провайдера:
+- Перемикач мислення у вебчаті відображає збережений рівень сесії зі сховища/конфігурації вхідної сесії під час завантаження сторінки.
+- Вибір іншого рівня відразу записує перевизначення сесії через `sessions.patch`; він не чекає наступного надсилання і не є одноразовим перевизначенням `thinkingOnce`.
+- Перший варіант завжди має вигляд `Default (<resolved level>)`, де визначене значення за замовчуванням походить від активної моделі сесії: `adaptive` для Claude 4.6 на Anthropic, `off` для Anthropic Claude Opus 4.7, якщо не налаштовано інакше, `low` для інших моделей із підтримкою міркування, і `off` в інших випадках.
+- Засіб вибору залишається обізнаним про провайдера:
  - більшість провайдерів показують `off | minimal | low | medium | high`
  - Anthropic/Bedrock Claude 4.6 показує `off | minimal | low | medium | high | adaptive`
-  - Anthropic Claude Opus 4.7 показує `off | minimal | low | medium | high | xhigh | adaptive`
-  - Z.AI показує бінарне `off | on`
- `/think:<level>` як і раніше працює й оновлює той самий збережений рівень сесії, тому директиви чату й засіб вибору залишаються синхронізованими.
+  - Anthropic Claude Opus 4.7 показує `off | minimal | low | medium | high | xhigh | adaptive | max`
+  - Z.AI показує двійкове `off | on`
+- `/think:<level>` як і раніше працює та оновлює той самий збережений рівень сесії, тому директиви чату й засіб вибору залишаються синхронізованими.