chore(i18n): refresh uk translations

2026-04-27 20:12:33 +00:00 · 2026-04-27 20:12:33 +00:00 · 127b373594
commit 127b373594
parent 4991f0bbe4
9 changed files with 1460 additions and 1447 deletions
--- a/docs/uk/cli/message.md
+++ b/docs/uk/cli/message.md
@ -2,21 +2,21 @@
 read_when:
    - Додавання або змінення дій CLI для повідомлень
    - Змінення поведінки вихідного каналу
-summary: Довідка CLI для `openclaw message` (надсилання + дії каналу)
+summary: Довідник CLI для `openclaw message` (надсилання + дії каналу)
 title: Повідомлення
 x-i18n:
-    generated_at: "2026-04-24T04:12:34Z"
+    generated_at: "2026-04-27T20:08:58Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 39932fb54caee37bdf58681da22b30e1b4cc7cc11b654010bf0335b1da3b2b4d
+    source_hash: 43f14b3815d89c92a7503e620e2424f41a3f6b92e20e089504017305b19bace4
    source_path: cli/message.md
    workflow: 15
 ---

 # `openclaw message`

-Єдина вихідна команда для надсилання повідомлень і виконання дій каналу
-(Discord/Google Chat/iMessage/Matrix/Mattermost (Plugin)/Microsoft Teams/Signal/Slack/Telegram/WhatsApp).
+Єдина вихідна команда для надсилання повідомлень і дій каналу
+(Discord/Google Chat/iMessage/Matrix/Mattermost (plugin)/Microsoft Teams/Signal/Slack/Telegram/WhatsApp).

 ## Використання

@ -26,67 +26,68 @@ openclaw message <subcommand> [flags]

 Вибір каналу:

- `--channel` обов’язковий, якщо налаштовано більше ніж один канал.
+- `--channel` обов’язковий, якщо налаштовано більше одного каналу.
 - Якщо налаштовано рівно один канал, він стає типовим.
- Значення: `discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp` (Mattermost вимагає Plugin)
+- Значення: `discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp` (Mattermost потребує plugin)
+- `openclaw message` зіставляє вибраний канал з plugin, якому він належить, коли присутній `--channel` або ціль із префіксом каналу; інакше завантажує налаштовані channel plugins для визначення типового каналу.

-Формати цілі (`--target`):
+Формати цілей (`--target`):

- WhatsApp: E.164 або group JID
- Telegram: id чату або `@username`
- Discord: `channel:<id>` або `user:<id>` (або згадка `<@id>`; необроблені числові id трактуються як канали)
+- WhatsApp: E.164 або груповий JID
+- Telegram: ідентифікатор чату або `@username`
+- Discord: `channel:<id>` або `user:<id>` (або згадка `<@id>`; необроблені числові ідентифікатори вважаються каналами)
 - Google Chat: `spaces/<spaceId>` або `users/<userId>`
- Slack: `channel:<id>` або `user:<id>` (необроблений id каналу підтримується)
- Mattermost (Plugin): `channel:<id>`, `user:<id>` або `@username` (id без префікса трактуються як канали)
+- Slack: `channel:<id>` або `user:<id>` (необроблений ідентифікатор каналу приймається)
+- Mattermost (plugin): `channel:<id>`, `user:<id>` або `@username` (ідентифікатори без префікса вважаються каналами)
 - Signal: `+E.164`, `group:<id>`, `signal:+E.164`, `signal:group:<id>` або `username:<name>`/`u:<name>`
 - iMessage: handle, `chat_id:<id>`, `chat_guid:<guid>` або `chat_identifier:<id>`
 - Matrix: `@user:server`, `!room:server` або `#alias:server`
- Microsoft Teams: id розмови (`19:...@thread.tacv2`) або `conversation:<id>` або `user:<aad-object-id>`
+- Microsoft Teams: ідентифікатор розмови (`19:...@thread.tacv2`) або `conversation:<id>` чи `user:<aad-object-id>`

 Пошук за назвою:

- Для підтримуваних провайдерів (Discord/Slack тощо) назви каналів, як-от `Help` або `#help`, визначаються через кеш каталогу.
- Якщо кеш не містить запису, OpenClaw спробує виконати живий пошук у каталозі, якщо провайдер це підтримує.
+- Для підтримуваних провайдерів (Discord/Slack тощо) назви каналів, як-от `Help` або `#help`, зіставляються через кеш каталогу.
+- Якщо кеш не містить збігу, OpenClaw спробує виконати живий пошук у каталозі, якщо провайдер це підтримує.

 ## Загальні прапорці

 - `--channel <name>`
 - `--account <id>`
 - `--target <dest>` (цільовий канал або користувач для send/poll/read тощо)
- `--targets <name>` (повторюється; лише для broadcast)
+- `--targets <name>` (повторюваний; лише для broadcast)
 - `--json`
 - `--dry-run`
 - `--verbose`

 ## Поведінка SecretRef

- `openclaw message` визначає підтримувані SecretRef каналу перед виконанням вибраної дії.
- Визначення, де можливо, обмежується активною ціллю дії:
-  - на рівні каналу, коли задано `--channel` (або його виведено з цілей із префіксом, як-от `discord:...`)
-  - на рівні облікового запису, коли задано `--account` (глобальні поверхні каналу + поверхні вибраного облікового запису)
-  - якщо `--account` не задано, OpenClaw не примушує до області SecretRef облікового запису `default`
- Невизначені SecretRef в не пов’язаних каналах не блокують цільову дію з повідомленням.
- Якщо SecretRef вибраного каналу/облікового запису не визначено, команда завершується із закритою відмовою для цієї дії.
+- `openclaw message` розв’язує підтримувані channel SecretRef перед виконанням вибраної дії.
+- Розв’язання, коли можливо, обмежується активною ціллю дії:
+  - у межах каналу, коли задано `--channel` (або його визначено з цілей із префіксом, як-от `discord:...`)
+  - у межах облікового запису, коли задано `--account` (глобальні значення каналу + поверхні вибраного облікового запису)
+  - якщо `--account` не вказано, OpenClaw не примусово застосовує область SecretRef облікового запису `default`
+- Нерозв’язані SecretRef в нерелевантних каналах не блокують цільову дію повідомлення.
+- Якщо SecretRef вибраного каналу/облікового запису не розв’язано, команда завершується безпечною відмовою для цієї дії.

 ## Дії

-### Основні
+### Ядро

 - `send`
-  - Канали: WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (Plugin)/Signal/iMessage/Matrix/Microsoft Teams
+  - Канали: WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (plugin)/Signal/iMessage/Matrix/Microsoft Teams
  - Обов’язково: `--target`, а також `--message`, `--media` або `--presentation`
  - Необов’язково: `--media`, `--presentation`, `--delivery`, `--pin`, `--reply-to`, `--thread-id`, `--gif-playback`, `--force-document`, `--silent`
-  - Спільні payload presentation: `--presentation` надсилає семантичні блоки (`text`, `context`, `divider`, `buttons`, `select`), які core рендерить через оголошені можливості вибраного каналу. Див. [Message Presentation](/uk/plugins/message-presentation).
-  - Загальні параметри доставки: `--delivery` приймає підказки доставки, як-от `{ "pin": true }`; `--pin` є скороченням для закріпленої доставки, коли канал це підтримує.
-  - Лише Telegram: `--force-document` (надсилати зображення та GIF як документи, щоб уникнути стиснення Telegram)
-  - Лише Telegram: `--thread-id` (id теми форуму)
-  - Лише Slack: `--thread-id` (timestamp гілки; `--reply-to` використовує те саме поле)
+  - Спільні presentation payload: `--presentation` надсилає семантичні блоки (`text`, `context`, `divider`, `buttons`, `select`), які ядро рендерить через оголошені можливості вибраного каналу. Див. [Message Presentation](/uk/plugins/message-presentation).
+  - Загальні параметри доставки: `--delivery` приймає підказки доставки, як-от `{ "pin": true }`; `--pin` — скорочення для закріпленої доставки, якщо канал це підтримує.
+  - Лише Telegram: `--force-document` (надсилати зображення й GIF як документи, щоб уникнути стиснення Telegram)
+  - Лише Telegram: `--thread-id` (ідентифікатор теми форуму)
+  - Лише Slack: `--thread-id` (часова мітка потоку; `--reply-to` використовує те саме поле)
  - Telegram + Discord: `--silent`
  - Лише WhatsApp: `--gif-playback`

 - `poll`
  - Канали: WhatsApp/Telegram/Discord/Matrix/Microsoft Teams
-  - Обов’язково: `--target`, `--poll-question`, `--poll-option` (повторюється)
+  - Обов’язково: `--target`, `--poll-question`, `--poll-option` (повторюваний)
  - Необов’язково: `--poll-multi`
  - Лише Discord: `--poll-duration-hours`, `--silent`, `--message`
  - Лише Telegram: `--poll-duration-seconds` (5-600), `--silent`, `--poll-anonymous` / `--poll-public`, `--thread-id`
@ -95,9 +96,9 @@ openclaw message <subcommand> [flags]
  - Канали: Discord/Google Chat/Slack/Telegram/WhatsApp/Signal/Matrix
  - Обов’язково: `--message-id`, `--target`
  - Необов’язково: `--emoji`, `--remove`, `--participant`, `--from-me`, `--target-author`, `--target-author-uuid`
-  - Примітка: `--remove` вимагає `--emoji` (не вказуйте `--emoji`, щоб очистити власні реакції там, де це підтримується; див. /tools/reactions)
+  - Примітка: `--remove` потребує `--emoji` (не вказуйте `--emoji`, щоб очистити власні реакції там, де це підтримується; див. /tools/reactions)
  - Лише WhatsApp: `--participant`, `--from-me`
-  - Реакції в групах Signal: обов’язково `--target-author` або `--target-author-uuid`
+  - Реакції в групах Signal: обов’язковий `--target-author` або `--target-author-uuid`

 - `reactions`
  - Канали: Discord/Google Chat/Slack/Matrix
@ -134,13 +135,13 @@ openclaw message <subcommand> [flags]
 - `search`
  - Канали: Discord
  - Обов’язково: `--guild-id`, `--query`
-  - Необов’язково: `--channel-id`, `--channel-ids` (повторюється), `--author-id`, `--author-ids` (повторюється), `--limit`
+  - Необов’язково: `--channel-id`, `--channel-ids` (повторюваний), `--author-id`, `--author-ids` (повторюваний), `--limit`

-### Гілки
+### Потоки

 - `thread create`
  - Канали: Discord
-  - Обов’язково: `--thread-name`, `--target` (id каналу)
+  - Обов’язково: `--thread-name`, `--target` (ідентифікатор каналу)
  - Необов’язково: `--message-id`, `--message`, `--auto-archive-min`

 - `thread list`
@ -150,7 +151,7 @@ openclaw message <subcommand> [flags]

 - `thread reply`
  - Канали: Discord
-  - Обов’язково: `--target` (id гілки), `--message`
+  - Обов’язково: `--target` (ідентифікатор потоку), `--message`
  - Необов’язково: `--media`, `--reply-to`

 ### Емодзі
@ -162,13 +163,13 @@ openclaw message <subcommand> [flags]
 - `emoji upload`
  - Канали: Discord
  - Обов’язково: `--guild-id`, `--emoji-name`, `--media`
-  - Необов’язково: `--role-ids` (повторюється)
+  - Необов’язково: `--role-ids` (повторюваний)

-### Стікери
+### Наліпки

 - `sticker send`
  - Канали: Discord
-  - Обов’язково: `--target`, `--sticker-id` (повторюється)
+  - Обов’язково: `--target`, `--sticker-id` (повторюваний)
  - Необов’язково: `--message`

 - `sticker upload`
@ -192,12 +193,12 @@ openclaw message <subcommand> [flags]

 ### Модерація (Discord)

- `timeout`: `--guild-id`, `--user-id` (необов’язково `--duration-min` або `--until`; не вказуйте обидва, щоб скасувати timeout)
+- `timeout`: `--guild-id`, `--user-id` (необов’язково `--duration-min` або `--until`; якщо обидва пропущено, тайм-аут буде скасовано)
 - `kick`: `--guild-id`, `--user-id` (+ `--reason`)
 - `ban`: `--guild-id`, `--user-id` (+ `--delete-days`, `--reason`)
  - `timeout` також підтримує `--reason`

-### Broadcast
+### Трансляція

 - `broadcast`
  - Канали: будь-який налаштований канал; використовуйте `--channel all`, щоб націлитися на всіх провайдерів
@ -221,9 +222,9 @@ openclaw message send --channel discord \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Approve","value":"approve","style":"success"},{"label":"Decline","value":"decline","style":"danger"}]}]}'
 ```

-Core рендерить той самий payload `presentation` у компоненти Discord, блоки Slack, вбудовані кнопки Telegram, props Mattermost або картки Teams/Feishu залежно від можливостей каналу. Див. [Message Presentation](/uk/plugins/message-presentation) для повного контракту та правил резервного відображення.
+Ядро рендерить той самий payload `presentation` у компоненти Discord, блоки Slack, inline-кнопки Telegram, props Mattermost або картки Teams/Feishu залежно від можливостей каналу. Див. [Message Presentation](/uk/plugins/message-presentation) для повного контракту та правил резервного відображення.

-Надіслати багатший payload presentation:
+Надіслати розширений payload presentation:

 ```bash
 openclaw message send --channel googlechat --target spaces/AAA... \
@ -241,7 +242,7 @@ openclaw message poll --channel discord \
  --poll-multi --poll-duration-hours 48
 ```

-Створити опитування в Telegram (автозакриття через 2 хвилини):
+Створити опитування в Telegram (автоматично закрити через 2 хвилини):

 ```
 openclaw message poll --channel telegram \
@ -267,7 +268,7 @@ openclaw message poll --channel msteams \
  --poll-option Pizza --poll-option Sushi
 ```

-Додати реакцію у Slack:
+Додати реакцію в Slack:

 ```
 openclaw message react --channel slack \
@ -282,14 +283,14 @@ openclaw message react --channel signal \
  --emoji "✅" --target-author-uuid 123e4567-e89b-12d3-a456-426614174000
 ```

-Надіслати вбудовані кнопки Telegram через загальний presentation:
+Надіслати inline-кнопки Telegram через узагальнений presentation:

 ```
 openclaw message send --channel telegram --target @mychat --message "Choose:" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Yes","value":"cmd:yes"},{"label":"No","value":"cmd:no"}]}]}'
 ```

-Надіслати картку Teams через загальний presentation:
+Надіслати картку Teams через узагальнений presentation:

 ```bash
 openclaw message send --channel msteams \
@ -297,7 +298,7 @@ openclaw message send --channel msteams \
  --presentation '{"title":"Status update","blocks":[{"type":"text","text":"Build completed"}]}'
 ```

-Надіслати зображення Telegram як документ, щоб уникнути стиснення:
+Надіслати зображення в Telegram як документ, щоб уникнути стиснення:

 ```bash
 openclaw message send --channel telegram --target @mychat \
@ -306,5 +307,5 @@ openclaw message send --channel telegram --target @mychat \

 ## Пов’язане

- [Довідка CLI](/uk/cli)
+- [Довідник CLI](/uk/cli)
 - [Надсилання агента](/uk/tools/agent-send)
--- a/docs/uk/cli/models.md
+++ b/docs/uk/cli/models.md
@ -1,27 +1,27 @@
 ---
 read_when:
-    - Ви хочете змінити моделі за замовчуванням або переглянути статус auth провайдера
-    - Ви хочете просканувати доступні моделі/провайдери та налагодити профілі auth
-summary: Довідник CLI для `openclaw models` (status/list/set/scan, псевдоніми, fallback, auth)
+    - Ви хочете змінити моделі за замовчуванням або переглянути стан автентифікації постачальника
+    - Ви хочете просканувати доступні моделі/постачальників і налагодити профілі автентифікації
+summary: Довідка CLI для `openclaw models` (status/list/set/scan, псевдоніми, резервні варіанти, автентифікація)
 title: Моделі
 x-i18n:
-    generated_at: "2026-04-27T06:24:03Z"
+    generated_at: "2026-04-27T20:08:44Z"
    model: gpt-5.4
    provider: openai
-    source_hash: ffafec22fb05909fd06ffc8987f8da87597ef6aa85a69bcadbcfcc1d19f7d7dc
+    source_hash: 1ff1d5d6b7e2d72ad0ff7480313ca67f7a49ec77ab198b688e7abf2b9de42757
    source_path: cli/models.md
    workflow: 15
 ---

 # `openclaw models`

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

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

- Провайдери + моделі: [Моделі](/uk/providers/models)
- Концепції вибору моделі + slash-команда `/models`: [Концепція моделей](/uk/concepts/models)
- Налаштування auth провайдера: [Початок роботи](/uk/start/getting-started)
+- Постачальники + моделі: [Моделі](/uk/providers/models)
+- Концепції вибору моделей + слеш-команда `/models`: [Концепція моделей](/uk/concepts/models)
+- Налаштування автентифікації постачальника: [Початок роботи](/uk/start/getting-started)

 ## Поширені команди

@ -32,67 +32,67 @@ openclaw models set <model-or-alias>
 openclaw models scan
 ```

-`openclaw models status` показує визначені модель за замовчуванням/fallback, а також огляд auth.
-Коли доступні знімки використання провайдера, розділ стану OAuth/API key містить
-вікна використання провайдера та знімки квот.
-Поточні провайдери з вікнами використання: Anthropic, GitHub Copilot, Gemini CLI, OpenAI
-Codex, MiniMax, Xiaomi і z.ai. Usage auth надходить зі специфічних для провайдера hooks,
-коли вони доступні; інакше OpenClaw повертається до зіставлення облікових даних
-OAuth/API key з профілів auth, env або конфігурації.
-У виводі `--json` `auth.providers` — це огляд провайдерів з урахуванням env/config/store,
-тоді як `auth.oauth` — лише стан профілів сховища auth.
-Додайте `--probe`, щоб виконати live-перевірки auth для кожного налаштованого профілю провайдера.
-Перевірки — це реальні запити (можуть витрачати токени та спричиняти обмеження швидкості).
-Використовуйте `--agent <id>`, щоб переглянути стан моделі/auth для налаштованого агента. Якщо його не вказано,
-команда використовує `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR`, якщо задано, інакше —
+`openclaw models status` показує визначені модель за замовчуванням/резервні варіанти, а також огляд автентифікації.
+Коли доступні знімки використання постачальника, розділ стану OAuth/API-ключа включає
+вікна використання постачальника та знімки квот.
+Поточні постачальники з вікнами використання: Anthropic, GitHub Copilot, Gemini CLI, OpenAI
+Codex, MiniMax, Xiaomi і z.ai. Автентифікація використання надходить із хуків, специфічних для постачальника,
+коли вони доступні; інакше OpenClaw використовує резервний варіант і підбирає облікові дані
+OAuth/API-ключа з профілів автентифікації, env або config.
+У виводі `--json` `auth.providers` — це огляд постачальників з урахуванням env/config/store,
+тоді як `auth.oauth` — це лише стан профілів у сховищі автентифікації.
+Додайте `--probe`, щоб виконати живі перевірки автентифікації для кожного налаштованого профілю постачальника.
+Перевірки — це реальні запити (можуть витрачати токени та спричиняти обмеження частоти).
+Використовуйте `--agent <id>`, щоб переглянути стан моделі/автентифікації налаштованого агента. Якщо параметр не вказано,
+команда використовує `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR`, якщо вони задані, інакше —
 налаштованого агента за замовчуванням.
-Рядки перевірок можуть походити з профілів auth, облікових даних env або `models.json`.
+Рядки перевірок можуть надходити з профілів автентифікації, облікових даних env або `models.json`.

 Примітки:

 - `models set <model-or-alias>` приймає `provider/model` або псевдонім.
- `models list` працює лише на читання: вона читає конфігурацію, профілі auth, наявний стан каталогу
-  та рядки каталогу, що належать провайдеру, але не переписує
+- `models list` — лише для читання: команда читає config, профілі автентифікації, наявний стан каталогу
+  та рядки каталогу, що належать постачальнику, але не переписує
  `models.json`.
- `models list --all --provider <id>` може включати статичні рядки каталогу, що належать провайдеру,
-  з маніфестів plugin або метаданих вбудованого каталогу провайдера, навіть якщо ви
-  ще не автентифікувалися в цього провайдера. Такі рядки все одно показуються як
-  недоступні, доки не буде налаштовано відповідний auth.
- `models list` зберігає розділення між власними метаданими моделі та runtime-обмеженнями. У табличному
-  виводі `Ctx` показує `contextTokens/contextWindow`, коли ефективне runtime-обмеження
-  відрізняється від власного контекстного вікна; рядки JSON містять `contextTokens`,
-  якщо провайдер відкриває це обмеження.
- `models list --provider <id>` фільтрує за id провайдера, наприклад `moonshot` або
-  `openai-codex`. Він не приймає мітки відображення з інтерактивних
-  засобів вибору провайдера, як-от `Moonshot AI`.
- Посилання на моделі розбираються поділом за **першим** `/`. Якщо ID моделі містить `/` (у стилі OpenRouter), додайте префікс провайдера (приклад: `openrouter/moonshotai/kimi-k2`).
- Якщо ви пропускаєте провайдера, OpenClaw спочатку визначає введення як псевдонім, потім —
-  як унікальний збіг точного id моделі серед налаштованих провайдерів, і лише після цього
-  повертається до налаштованого провайдера за замовчуванням із попередженням про застарілість.
-  Якщо цей провайдер більше не надає налаштовану модель за замовчуванням, OpenClaw
-  повертається до першого налаштованого провайдера/моделі замість того, щоб показувати
-  застаріле типове значення видаленого провайдера.
- `models status` може показувати `marker(<value>)` у виводі auth для несекретних заповнювачів (наприклад `OPENAI_API_KEY`, `secretref-managed`, `minimax-oauth`, `oauth:chutes`, `ollama-local`) замість маскування їх як секретів.
+- `models list --all --provider <id>` може включати статичні рядки каталогу, що належать постачальнику,
+  із маніфестів Plugin або вбудованих метаданих каталогу постачальника, навіть якщо ви
+  ще не пройшли автентифікацію в цього постачальника. Такі рядки все одно відображаються як
+  недоступні, доки не буде налаштовано відповідну автентифікацію.
+- `models list` зберігає нативні метадані моделі та ефективні обмеження runtime окремо. У табличному
+  виводі `Ctx` показує `contextTokens/contextWindow`, коли ефективне обмеження runtime
+  відрізняється від нативного вікна контексту; рядки JSON включають `contextTokens`,
+  коли постачальник надає це обмеження.
+- `models list --provider <id>` фільтрує за id постачальника, наприклад `moonshot` або
+  `openai-codex`. Він не приймає мітки відображення з інтерактивних засобів вибору постачальника,
+  наприклад `Moonshot AI`.
+- Посилання на моделі розбираються шляхом поділу за **першим** `/`. Якщо ID моделі містить `/` (у стилі OpenRouter), додайте префікс постачальника (приклад: `openrouter/moonshotai/kimi-k2`).
+- Якщо ви не вказали постачальника, OpenClaw спочатку визначає введення як псевдонім, потім —
+  як унікальний збіг exact model id серед налаштованих постачальників, і лише після цього
+  використовує резервний варіант із налаштованим постачальником за замовчуванням із попередженням про застарілість.
+  Якщо цей постачальник більше не надає налаштовану модель за замовчуванням, OpenClaw
+  використовує резервний варіант із першою налаштованою парою постачальник/модель замість того, щоб показувати
+  застаріле значення за замовчуванням від видаленого постачальника.
+- `models status` може показувати `marker(<value>)` у виводі автентифікації для незахищених заповнювачів (наприклад `OPENAI_API_KEY`, `secretref-managed`, `minimax-oauth`, `oauth:chutes`, `ollama-local`) замість маскування їх як секретів.

 ### Сканування моделей

-`models scan` читає публічний каталог `:free` OpenRouter і ранжує кандидатів для
-використання як fallback. Сам каталог є публічним, тому для сканувань лише метаданих
-ключ OpenRouter не потрібен.
+`models scan` читає публічний каталог OpenRouter `:free` і ранжує кандидатів для
+використання як резервних варіантів. Сам каталог є публічним, тому сканування лише метаданих не потребує
+ключа OpenRouter.

-За замовчуванням OpenClaw намагається перевірити підтримку інструментів і зображень за допомогою live-викликів моделей.
-Якщо ключ OpenRouter не налаштовано, команда повертається до виводу лише метаданих і пояснює,
-що моделі `:free` все одно потребують `OPENROUTER_API_KEY` для
-перевірок і інференсу.
+За замовчуванням OpenClaw намагається перевірити підтримку інструментів і зображень за допомогою живих викликів моделі.
+Якщо ключ OpenRouter не налаштовано, команда використовує резервний варіант із виводом лише метаданих
+і пояснює, що моделі `:free` усе одно потребують `OPENROUTER_API_KEY` для
+перевірок і висновку.

 Параметри:

- `--no-probe` (лише метадані; без пошуку конфігурації/секретів)
+- `--no-probe` (лише метадані; без пошуку config/секретів)
 - `--min-params <b>`
 - `--max-age-days <days>`
 - `--provider <name>`
 - `--max-candidates <n>`
- `--timeout <ms>` (тайм-аут запиту каталогу та тайм-аут кожної перевірки)
+- `--timeout <ms>` (тайм-аут запиту каталогу та кожної перевірки)
 - `--concurrency <n>`
 - `--yes`
 - `--no-input`
@ -100,8 +100,8 @@ OAuth/API key з профілів auth, env або конфігурації.
 - `--set-image`
 - `--json`

-`--set-default` і `--set-image` вимагають live-перевірок; результати сканування
-лише метаданих мають інформаційний характер і не застосовуються до конфігурації.
+`--set-default` і `--set-image` потребують живих перевірок; результати сканування лише метаданих
+є інформаційними та не застосовуються до config.

 ### Стан моделей

@ -109,15 +109,19 @@ OAuth/API key з профілів auth, env або конфігурації.

 - `--json`
 - `--plain`
- `--check` (код виходу 1=прострочено/відсутнє, 2=скоро спливає)
- `--probe` (live-перевірка налаштованих профілів auth)
- `--probe-provider <name>` (перевірити одного провайдера)
- `--probe-profile <id>` (повторювані або профілі через кому)
+- `--check` (код виходу 1=прострочено/відсутнє, 2=строк дії спливає)
+- `--probe` (жива перевірка налаштованих профілів автентифікації)
+- `--probe-provider <name>` (перевірити одного постачальника)
+- `--probe-profile <id>` (повторювані або розділені комами id профілів)
 - `--probe-timeout <ms>`
 - `--probe-concurrency <n>`
 - `--probe-max-tokens <n>`
 - `--agent <id>` (id налаштованого агента; перевизначає `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR`)

+`--json` зберігає stdout виключно для корисного навантаження JSON. Діагностика профілів автентифікації, постачальників
+і запуску спрямовується в stderr, щоб скрипти могли напряму передавати stdout
+в інструменти на кшталт `jq`.
+
 Категорії стану перевірок:

 - `ok`
@ -129,24 +133,24 @@ OAuth/API key з профілів auth, env або конфігурації.
 - `unknown`
 - `no_model`

-Випадки detail/reason-code перевірок, яких слід очікувати:
+Варіанти деталей/кодів причин перевірок, на які слід очікувати:

 - `excluded_by_auth_order`: збережений профіль існує, але явний
-  `auth.order.<provider>` його пропустив, тож перевірка повідомляє про це виключення замість
-  спроби використати профіль.
+  `auth.order.<provider>` його пропустив, тому перевірка повідомляє про виключення замість
+  спроби використати його.
 - `missing_credential`, `invalid_expires`, `expired`, `unresolved_ref`:
  профіль присутній, але не придатний/не може бути визначений.
- `no_model`: auth провайдера існує, але OpenClaw не зміг визначити придатного
-  кандидата моделі для перевірки для цього провайдера.
+- `no_model`: автентифікація постачальника існує, але OpenClaw не зміг визначити
+  кандидата моделі для перевірки для цього постачальника.

-## Псевдоніми + fallback
+## Псевдоніми + резервні варіанти

 ```bash
 openclaw models aliases list
 openclaw models fallbacks list
 ```

-## Профілі auth
+## Профілі автентифікації

 ```bash
 openclaw models auth add
@ -155,14 +159,14 @@ openclaw models auth setup-token --provider <id>
 openclaw models auth paste-token
 ```

-`models auth add` — це інтерактивний помічник auth. Він може запустити потік auth провайдера
+`models auth add` — це інтерактивний помічник автентифікації. Він може запустити потік автентифікації постачальника
 (OAuth/API key) або провести вас через ручне вставлення токена, залежно від
-вибраного провайдера.
+вибраного постачальника.

-`models auth login` запускає потік auth plugin провайдера (OAuth/API key). Використовуйте
-`openclaw plugins list`, щоб побачити, які провайдери встановлено.
-Використовуйте `openclaw models auth --agent <id> <subcommand>`, щоб записати результати auth у
-сховище конкретного налаштованого агента. Батьківський прапорець `--agent` враховується для
+`models auth login` запускає потік автентифікації Plugin постачальника (OAuth/API key). Використовуйте
+`openclaw plugins list`, щоб побачити, які постачальники встановлено.
+Використовуйте `openclaw models auth --agent <id> <subcommand>`, щоб записати результати автентифікації до
+сховища конкретного налаштованого агента. Батьківський прапорець `--agent` підтримується в
 `add`, `login`, `setup-token`, `paste-token` і `login-github-copilot`.

 Приклади:
@ -173,21 +177,21 @@ openclaw models auth login --provider openai-codex --set-default

 Примітки:

- `setup-token` і `paste-token` залишаються універсальними командами токенів для провайдерів,
-  які надають методи auth через токен.
- `setup-token` вимагає інтерактивного TTY і запускає метод token-auth провайдера
-  (за замовчуванням використовуючи метод `setup-token` цього провайдера, якщо він його надає).
- `paste-token` приймає рядок токена, згенерований деінде або автоматизацією.
- `paste-token` вимагає `--provider`, запитує значення токена і записує
-  його до типового id профілю `<provider>:manual`, якщо ви не передасте
+- `setup-token` і `paste-token` залишаються універсальними командами токенів для постачальників,
+  які надають методи автентифікації за токеном.
+- `setup-token` потребує інтерактивного TTY і запускає метод токен-автентифікації постачальника
+  (типово — метод `setup-token` цього постачальника, якщо він його надає).
+- `paste-token` приймає рядок токена, згенерований в іншому місці або автоматизацією.
+- `paste-token` потребує `--provider`, запитує значення токена та записує
+  його до id профілю за замовчуванням `<provider>:manual`, якщо ви не передасте
  `--profile-id`.
- `paste-token --expires-in <duration>` зберігає абсолютний час завершення дії токена на основі
+- `paste-token --expires-in <duration>` зберігає абсолютний строк дії токена на основі
  відносної тривалості, наприклад `365d` або `12h`.
- Примітка щодо Anthropic: співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволено, тому OpenClaw вважає повторне використання Claude CLI та `claude -p` санкціонованими для цієї інтеграції, якщо Anthropic не опублікує нову політику.
- `setup-token` / `paste-token` для Anthropic залишаються підтримуваним шляхом токенів OpenClaw, але тепер OpenClaw надає перевагу повторному використанню Claude CLI і `claude -p`, коли це доступно.
+- Примітка щодо Anthropic: співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволене, тому OpenClaw вважає повторне використання Claude CLI і використання `claude -p` санкціонованими для цієї інтеграції, якщо Anthropic не опублікує нову політику.
+- `setup-token` / `paste-token` для Anthropic залишаються доступними як підтримуваний шлях токена OpenClaw, але тепер OpenClaw надає перевагу повторному використанню Claude CLI і `claude -p`, коли це доступно.

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

- [Довідник CLI](/uk/cli)
+- [Довідка CLI](/uk/cli)
 - [Вибір моделі](/uk/concepts/model-providers)
- [Перемикання моделі при відмові](/uk/concepts/model-failover)
+- [Перемикання між моделями при збоях](/uk/concepts/model-failover)
--- a/docs/uk/cli/sessions.md
+++ b/docs/uk/cli/sessions.md
@ -1,20 +1,20 @@
 ---
 read_when:
-    - Ви хочете переглянути список збережених сесій і побачити нещодавню активність
-summary: Довідник CLI для `openclaw sessions` (перелік збережених сесій і використання)
-title: Сесії
+    - Ви хочете переглянути список збережених сеансів і недавню активність
+summary: Довідка CLI для `openclaw sessions` (перелік збережених сеансів + використання)
+title: Сеанси
 x-i18n:
-    generated_at: "2026-04-24T03:43:26Z"
+    generated_at: "2026-04-27T20:08:42Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 8d9fdc5d4cc968784e6e937a1000e43650345c27765208d46611e1fe85ee9293
+    source_hash: 77bf1cdc5cb1688889ec5155241ed98a2c62204c56e727a1174c593a79c78ca8
    source_path: cli/sessions.md
    workflow: 15
 ---

 # `openclaw sessions`

-Перегляд списку збережених сесій розмов.
+Перелічує збережені сеанси розмов.

 ```bash
 openclaw sessions
@ -27,17 +27,18 @@ openclaw sessions --json

 Вибір області:

- типово: сховище типового налаштованого агента
+- за замовчуванням: сховище агента, налаштоване за замовчуванням
 - `--verbose`: докладне журналювання
- `--agent <id>`: сховище одного налаштованого агента
- `--all-agents`: агрегувати всі сховища налаштованих агентів
+- `--agent <id>`: одне налаштоване сховище агента
+- `--all-agents`: агрегує всі налаштовані сховища агентів
 - `--store <path>`: явний шлях до сховища (не можна поєднувати з `--agent` або `--all-agents`)

-`openclaw sessions --all-agents` читає сховища налаштованих агентів. Gateway і ACP
-мають ширше виявлення сесій: вони також включають сховища, знайдені лише на диску
-в типовому корені `agents/` або в шаблонізованому корені `session.store`. Такі
-виявлені сховища мають визначатися як звичайні файли `sessions.json` усередині
-кореня агента; символьні посилання та шляхи поза коренем пропускаються.
+`openclaw sessions --all-agents` читає налаштовані сховища агентів. Виявлення
+сеансів Gateway і ACP має ширше охоплення: воно також включає сховища, знайдені
+лише на диску, у стандартному корені `agents/` або в корені `session.store`,
+заданому шаблоном. Ці виявлені сховища мають відповідати звичайним файлам
+`sessions.json` усередині кореня агента; символічні посилання та шляхи поза
+коренем пропускаються.

 Приклади JSON:

@ -73,19 +74,19 @@ openclaw sessions cleanup --enforce --active-key "agent:main:telegram:direct:123
 openclaw sessions cleanup --json
 ```

-`openclaw sessions cleanup` використовує параметри `session.maintenance` із конфігурації:
+`openclaw sessions cleanup` використовує налаштування `session.maintenance` з конфігурації:

- Примітка щодо області: `openclaw sessions cleanup` обслуговує лише сховища сесій/транскрипти. Воно не очищає журнали запусків Cron (`cron/runs/<jobId>.jsonl`), якими керують `cron.runLog.maxBytes` і `cron.runLog.keepLines` у [конфігурації Cron](/uk/automation/cron-jobs#configuration) і які пояснено в [обслуговуванні Cron](/uk/automation/cron-jobs#maintenance).
+- Примітка щодо області дії: `openclaw sessions cleanup` обслуговує сховища сеансів, стенограми та побічні файли траєкторій. Воно не обрізає журнали запусків Cron (`cron/runs/<jobId>.jsonl`), якими керують `cron.runLog.maxBytes` і `cron.runLog.keepLines` у [конфігурації Cron](/uk/automation/cron-jobs#configuration), а також які описані в [обслуговуванні Cron](/uk/automation/cron-jobs#maintenance).

- `--dry-run`: попередній перегляд того, скільки записів буде видалено/обмежено без запису.
-  - У текстовому режимі dry-run друкує таблицю дій для кожної сесії (`Action`, `Key`, `Age`, `Model`, `Flags`), щоб ви могли побачити, що буде збережено, а що видалено.
- `--enforce`: застосувати обслуговування, навіть якщо `session.maintenance.mode` має значення `warn`.
- `--fix-missing`: видалити записи, для яких відсутні файли транскриптів, навіть якщо зазвичай вони ще не підпадали б під обмеження за віком/кількістю.
- `--active-key <key>`: захистити конкретний активний ключ від витіснення через дисковий бюджет.
- `--agent <id>`: запустити очищення для одного сховища налаштованого агента.
- `--all-agents`: запустити очищення для всіх сховищ налаштованих агентів.
- `--store <path>`: запустити для конкретного файлу `sessions.json`.
- `--json`: вивести підсумок у JSON. З `--all-agents` вивід містить по одному підсумку для кожного сховища.
+- `--dry-run`: попередньо показує, скільки записів буде вилучено/обмежено без запису.
+  - У текстовому режимі dry-run виводить таблицю дій по сеансах (`Action`, `Key`, `Age`, `Model`, `Flags`), щоб ви могли побачити, що буде збережено, а що видалено.
+- `--enforce`: застосовує обслуговування, навіть коли `session.maintenance.mode` має значення `warn`.
+- `--fix-missing`: видаляє записи, у яких відсутні файли стенограм, навіть якщо вони зазвичай ще не підлягали б видаленню за віком/кількістю.
+- `--active-key <key>`: захищає конкретний активний ключ від витіснення через обмеження дискового бюджету.
+- `--agent <id>`: запускає очищення для одного налаштованого сховища агента.
+- `--all-agents`: запускає очищення для всіх налаштованих сховищ агентів.
+- `--store <path>`: запускає очищення для конкретного файла `sessions.json`.
+- `--json`: виводить підсумок у форматі JSON. Із `--all-agents` вивід містить по одному підсумку для кожного сховища.

 `openclaw sessions cleanup --all-agents --dry-run --json`:

@ -117,9 +118,9 @@ openclaw sessions cleanup --json

 Пов’язане:

- Конфігурація сесій: [Довідник конфігурації](/uk/gateway/config-agents#session)
+- Конфігурація сеансів: [Довідник із конфігурації](/uk/gateway/config-agents#session)

 ## Пов’язане

- [Довідник CLI](/uk/cli)
- [Керування сесіями](/uk/concepts/session)
+- [Довідка CLI](/uk/cli)
+- [Керування сеансами](/uk/concepts/session)
--- a/docs/uk/plugins/architecture-internals.md
+++ b/docs/uk/plugins/architecture-internals.md
--- a/docs/uk/plugins/sdk-migration.md
+++ b/docs/uk/plugins/sdk-migration.md
--- a/docs/uk/plugins/sdk-subpaths.md
+++ b/docs/uk/plugins/sdk-subpaths.md
@ -1,36 +1,36 @@
 ---
 read_when:
-    - Вибір правильного підшляху plugin-sdk для імпорту в плагіні
+    - Вибір правильного підшляху plugin-sdk для імпорту Plugin
    - Аудит підшляхів bundled-plugin і допоміжних поверхонь
 summary: 'Каталог підшляхів Plugin SDK: які імпорти де розміщені, згруповано за областями'
-title: підшляхи Plugin SDK
+title: Підшляхи Plugin SDK
 x-i18n:
-    generated_at: "2026-04-27T14:20:22Z"
+    generated_at: "2026-04-27T20:08:43Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 8d71e64f699d40419c682d7401a341241ffb9204fb94b9831e204d9ba1d50489
+    source_hash: b55ce02a25cfe9fe1bea2263bad31b50cc72c06affa451cc9cecac4404e70d79
    source_path: plugins/sdk-subpaths.md
    workflow: 15
 ---

-  Plugin SDK доступний як набір вузьких підшляхів у `openclaw/plugin-sdk/`.
-  На цій сторінці каталогізовано найуживаніші підшляхи, згруповані за призначенням. Згенерований
-  повний список із понад 200 підшляхів міститься в `scripts/lib/plugin-sdk-entrypoints.json`;
-  зарезервовані допоміжні підшляхи bundled-plugin також там присутні, але є деталлю реалізації,
-  якщо тільки якась сторінка документації явно не просуває їх.
+  Plugin SDK надається як набір вузьких підшляхів у `openclaw/plugin-sdk/`.
+  На цій сторінці наведено каталог найуживаніших підшляхів, згрупованих за призначенням. Згенерований
+  повний список із понад 200 підшляхів розміщено в `scripts/lib/plugin-sdk-entrypoints.json`;
+  зарезервовані допоміжні підшляхи bundled-plugin також наведені там, але вони є
+  деталлю реалізації, якщо лише якась сторінка документації не просуває їх явно.

-  Посібник з авторства плагінів дивіться в [Огляд Plugin SDK](/uk/plugins/sdk-overview).
+  Щоб ознайомитися з посібником з розробки Plugin, див. [Огляд Plugin SDK](/uk/plugins/sdk-overview).

-  ## Вхід плагіна
+  ## Точка входу Plugin

-  | Підшлях                       | Ключові експорти                                                                                                                                          |
-  | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
-  | `plugin-sdk/plugin-entry`     | `definePluginEntry`                                                                                                                                       |
-  | `plugin-sdk/core`             | `defineChannelPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`, `defineSetupPluginEntry`, `buildChannelConfigSchema`                  |
-  | `plugin-sdk/config-schema`    | `OpenClawSchema`                                                                                                                                          |
-  | `plugin-sdk/provider-entry`   | `defineSingleProviderPluginEntry`                                                                                                                         |
+  | Підшлях                       | Ключові експорти                                                                                                                                       |
+  | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
+  | `plugin-sdk/plugin-entry`     | `definePluginEntry`                                                                                                                                    |
+  | `plugin-sdk/core`             | `defineChannelPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`, `defineSetupPluginEntry`, `buildChannelConfigSchema`                |
+  | `plugin-sdk/config-schema`    | `OpenClawSchema`                                                                                                                                       |
+  | `plugin-sdk/provider-entry`   | `defineSingleProviderPluginEntry`                                                                                                                      |
  | `plugin-sdk/migration`        | Допоміжні елементи провайдера міграції, як-от `createMigrationItem`, константи причин, маркери статусу елементів, допоміжні засоби редагування та `summarizeMigrationItems` |
-  | `plugin-sdk/migration-runtime` | Допоміжні засоби міграції під час виконання, як-от `copyMigrationFileItem` і `writeMigrationReport`                                                    |
+  | `plugin-sdk/migration-runtime` | Допоміжні засоби міграції під час виконання, як-от `copyMigrationFileItem` і `writeMigrationReport`                                                  |

  <AccordionGroup>
  <Accordion title="Підшляхи каналів">
@ -39,55 +39,55 @@ x-i18n:
    | `plugin-sdk/channel-core` | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
    | `plugin-sdk/config-schema` | Експорт кореневої Zod-схеми `openclaw.json` (`OpenClawSchema`) |
    | `plugin-sdk/channel-setup` | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, а також `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` |
-    | `plugin-sdk/setup` | Спільні допоміжні засоби майстра налаштування, підказки allowlist, побудовники статусу налаштування |
+    | `plugin-sdk/setup` | Спільні допоміжні засоби майстра налаштування, запити allowlist, побудовники статусу налаштування |
    | `plugin-sdk/setup-runtime` | `createPatchedAccountSetupAdapter`, `createEnvPatchedAccountSetupAdapter`, `createSetupInputPresenceValidator`, `noteChannelLookupFailure`, `noteChannelLookupSummary`, `promptResolvedAllowFrom`, `splitSetupEntries`, `createAllowlistSetupWizardProxy`, `createDelegatedSetupWizardProxy` |
    | `plugin-sdk/setup-adapter-runtime` | `createEnvPatchedAccountSetupAdapter` |
    | `plugin-sdk/setup-tools` | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` |
-    | `plugin-sdk/account-core` | Допоміжні засоби для конфігурації/обмеження дій багатьох облікових записів, допоміжні засоби fallback для облікового запису за замовчуванням |
-    | `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, допоміжні засоби нормалізації account-id |
-    | `plugin-sdk/account-resolution` | Допоміжні засоби пошуку облікового запису + fallback за замовчуванням |
+    | `plugin-sdk/account-core` | Допоміжні засоби конфігурації та action gate для кількох облікових записів, допоміжні засоби резервного використання облікового запису за замовчуванням |
+    | `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, допоміжні засоби нормалізації id облікового запису |
+    | `plugin-sdk/account-resolution` | Допоміжні засоби пошуку облікового запису + резервного використання облікового запису за замовчуванням |
    | `plugin-sdk/account-helpers` | Вузькі допоміжні засоби для списку облікових записів/дій з обліковими записами |
    | `plugin-sdk/channel-pairing` | `createChannelPairingController` |
    | `plugin-sdk/channel-reply-pipeline` | `createChannelReplyPipeline` |
    | `plugin-sdk/channel-config-helpers` | `createHybridChannelConfigAdapter` |
    | `plugin-sdk/channel-config-schema` | Спільні примітиви схеми конфігурації каналу та універсальний побудовник |
-    | `plugin-sdk/channel-config-schema-legacy` | Застарілі схеми конфігурації bundled-channel лише для сумісності bundled |
-    | `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації/перевірки Telegram custom-command з fallback для bundled-contract |
-    | `plugin-sdk/command-gating` | Вузькі допоміжні засоби для обмеження авторизації команд |
+    | `plugin-sdk/channel-config-schema-legacy` | Застарілі схеми конфігурації bundled-channel лише для сумісності з bundled |
+    | `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації/валідації користувацьких команд Telegram із резервною сумісністю контракту bundled |
+    | `plugin-sdk/command-gating` | Вузькі допоміжні засоби gate авторизації команд |
    | `plugin-sdk/channel-policy` | `resolveChannelGroupRequireMention` |
-    | `plugin-sdk/channel-lifecycle` | `createAccountStatusSink`, допоміжні засоби життєвого циклу/завершення draft stream |
-    | `plugin-sdk/inbound-envelope` | Спільні допоміжні засоби для inbound route + побудови envelope |
-    | `plugin-sdk/inbound-reply-dispatch` | Спільні допоміжні засоби для запису й dispatch вхідних відповідей |
+    | `plugin-sdk/channel-lifecycle` | `createAccountStatusSink`, допоміжні засоби життєвого циклу/завершення потоку чернеток |
+    | `plugin-sdk/inbound-envelope` | Спільні допоміжні засоби для вхідної маршрутизації та побудови envelope |
+    | `plugin-sdk/inbound-reply-dispatch` | Спільні допоміжні засоби для запису та диспетчеризації вхідних відповідей |
    | `plugin-sdk/messaging-targets` | Допоміжні засоби розбору/зіставлення цілей |
-    | `plugin-sdk/outbound-media` | Спільні допоміжні засоби завантаження outbound media |
-    | `plugin-sdk/outbound-send-deps` | Полегшений пошук залежностей outbound send для адаптерів каналів |
-    | `plugin-sdk/outbound-runtime` | Допоміжні засоби outbound delivery, identity, send delegate, session, formatting і планування payload |
-    | `plugin-sdk/poll-runtime` | Вузькі допоміжні засоби нормалізації poll |
-    | `plugin-sdk/thread-bindings-runtime` | Допоміжні засоби життєвого циклу thread-binding та адаптерів |
-    | `plugin-sdk/agent-media-payload` | Застарілий побудовник agent media payload |
-    | `plugin-sdk/conversation-runtime` | Допоміжні засоби conversation/thread binding, pairing і configured-binding |
-    | `plugin-sdk/runtime-config-snapshot` | Допоміжний засіб snapshot для runtime config |
-    | `plugin-sdk/runtime-group-policy` | Допоміжні засоби визначення policy груп під час виконання |
-    | `plugin-sdk/channel-status` | Спільні допоміжні засоби snapshot/summary стану каналу |
+    | `plugin-sdk/outbound-media` | Спільні допоміжні засоби завантаження вихідних медіа |
+    | `plugin-sdk/outbound-send-deps` | Полегшений пошук залежностей вихідного надсилання для адаптерів каналів |
+    | `plugin-sdk/outbound-runtime` | Допоміжні засоби вихідної доставки, ідентичності, делегата надсилання, сесій, форматування та планування payload |
+    | `plugin-sdk/poll-runtime` | Вузькі допоміжні засоби нормалізації опитувань |
+    | `plugin-sdk/thread-bindings-runtime` | Допоміжні засоби життєвого циклу прив’язок потоків і адаптерів |
+    | `plugin-sdk/agent-media-payload` | Застарілий побудовник media payload агента |
+    | `plugin-sdk/conversation-runtime` | Допоміжні засоби прив’язки розмов/потоків, спарювання та налаштованих прив’язок |
+    | `plugin-sdk/runtime-config-snapshot` | Допоміжний засіб знімка конфігурації під час виконання |
+    | `plugin-sdk/runtime-group-policy` | Допоміжні засоби визначення групової політики під час виконання |
+    | `plugin-sdk/channel-status` | Спільні допоміжні засоби знімка/підсумку статусу каналу |
    | `plugin-sdk/channel-config-primitives` | Вузькі примітиви схеми конфігурації каналу |
    | `plugin-sdk/channel-config-writes` | Допоміжні засоби авторизації запису конфігурації каналу |
-    | `plugin-sdk/channel-plugin-common` | Спільні prelude-експорти plugin каналу |
+    | `plugin-sdk/channel-plugin-common` | Спільні prelude-експорти Plugin каналу |
    | `plugin-sdk/allowlist-config-edit` | Допоміжні засоби редагування/читання конфігурації allowlist |
-    | `plugin-sdk/group-access` | Спільні допоміжні засоби для рішень group-access |
-    | `plugin-sdk/direct-dm` | Спільні допоміжні засоби auth/guard для direct-DM |
-    | `plugin-sdk/interactive-runtime` | Допоміжні засоби семантичного представлення повідомлень, доставки та застарілих інтерактивних відповідей. Див. [Представлення повідомлень](/uk/plugins/message-presentation) |
-    | `plugin-sdk/channel-inbound` | Compatibility barrel для inbound debounce, зіставлення mention, допоміжних засобів mention-policy і допоміжних засобів envelope |
-    | `plugin-sdk/channel-inbound-debounce` | Вузькі допоміжні засоби inbound debounce |
-    | `plugin-sdk/channel-mention-gating` | Вузькі допоміжні засоби mention-policy і тексту mention без ширшої поверхні inbound runtime |
-    | `plugin-sdk/channel-envelope` | Вузькі допоміжні засоби форматування inbound envelope |
-    | `plugin-sdk/channel-location` | Допоміжні засоби контексту й форматування розташування каналу |
-    | `plugin-sdk/channel-logging` | Допоміжні засоби логування каналу для відкинутих inbound і збоїв typing/ack |
-    | `plugin-sdk/channel-send-result` | Типи результату відповіді |
-    | `plugin-sdk/channel-actions` | Допоміжні засоби дій над повідомленнями каналу, а також застарілі допоміжні засоби native schema, збережені для сумісності плагінів |
+    | `plugin-sdk/group-access` | Спільні допоміжні засоби ухвалення рішень щодо доступу груп |
+    | `plugin-sdk/direct-dm` | Спільні допоміжні засоби auth/guard для прямих DM |
+    | `plugin-sdk/interactive-runtime` | Семантичне представлення повідомлень, доставка та застарілі допоміжні засоби інтерактивних відповідей. Див. [Представлення повідомлень](/uk/plugins/message-presentation) |
+    | `plugin-sdk/channel-inbound` | Сумісний barrel для debounce вхідних повідомлень, зіставлення згадок, допоміжних засобів політики згадок і допоміжних засобів envelope |
+    | `plugin-sdk/channel-inbound-debounce` | Вузькі допоміжні засоби debounce вхідних повідомлень |
+    | `plugin-sdk/channel-mention-gating` | Вузькі допоміжні засоби політики згадок і тексту згадок без ширшої поверхні вхідного runtime |
+    | `plugin-sdk/channel-envelope` | Вузькі допоміжні засоби форматування вхідного envelope |
+    | `plugin-sdk/channel-location` | Допоміжні засоби контексту та форматування розташування каналу |
+    | `plugin-sdk/channel-logging` | Допоміжні засоби логування каналу для відкинутих вхідних повідомлень і збоїв typing/ack |
+    | `plugin-sdk/channel-send-result` | Типи результатів відповіді |
+    | `plugin-sdk/channel-actions` | Допоміжні засоби дій із повідомленнями каналу, а також застарілі допоміжні засоби native schema, збережені для сумісності Plugin |
    | `plugin-sdk/channel-targets` | Допоміжні засоби розбору/зіставлення цілей |
-    | `plugin-sdk/channel-contract` | Типи контрактів каналів |
+    | `plugin-sdk/channel-contract` | Типи контракту каналу |
    | `plugin-sdk/channel-feedback` | Підключення feedback/reaction |
-    | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби secret-contract, як-от `collectSimpleChannelFieldAssignments`, `getChannelSurface`, `pushAssignment`, і типи secret target |
+    | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби контрактів секретів, як-от `collectSimpleChannelFieldAssignments`, `getChannelSurface`, `pushAssignment`, і типи цілей секретів |
  </Accordion>

  <Accordion title="Підшляхи провайдерів">
@ -95,29 +95,29 @@ x-i18n:
    | --- | --- |
    | `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
    | `plugin-sdk/lmstudio` | Підтримуваний фасад провайдера LM Studio для налаштування, виявлення каталогу та підготовки моделей під час виконання |
-    | `plugin-sdk/lmstudio-runtime` | Підтримуваний фасад runtime LM Studio для локальних стандартних налаштувань сервера, виявлення моделей, заголовків запитів і допоміжних засобів для завантажених моделей |
+    | `plugin-sdk/lmstudio-runtime` | Підтримуваний фасад runtime LM Studio для локальних типових значень сервера, виявлення моделей, заголовків запитів і допоміжних засобів завантажених моделей |
    | `plugin-sdk/provider-setup` | Кураторські допоміжні засоби налаштування локальних/self-hosted провайдерів |
    | `plugin-sdk/self-hosted-provider-setup` | Сфокусовані допоміжні засоби налаштування self-hosted провайдерів, сумісних з OpenAI |
-    | `plugin-sdk/cli-backend` | Стандартні значення backend CLI + константи watchdog |
-    | `plugin-sdk/provider-auth-runtime` | Допоміжні засоби визначення API-key під час виконання для provider plugins |
-    | `plugin-sdk/provider-auth-api-key` | Допоміжні засоби онбордингу/запису профілю API-key, як-от `upsertApiKeyProfile` |
-    | `plugin-sdk/provider-auth-result` | Стандартний побудовник результату OAuth auth |
-    | `plugin-sdk/provider-auth-login` | Спільні інтерактивні допоміжні засоби входу для provider plugins |
+    | `plugin-sdk/cli-backend` | Типові значення backend CLI + константи watchdog |
+    | `plugin-sdk/provider-auth-runtime` | Допоміжні засоби визначення API key під час виконання для Plugin провайдерів |
+    | `plugin-sdk/provider-auth-api-key` | Допоміжні засоби онбордингу API key/запису профілю, як-от `upsertApiKeyProfile` |
+    | `plugin-sdk/provider-auth-result` | Стандартний побудовник результату auth OAuth |
+    | `plugin-sdk/provider-auth-login` | Спільні допоміжні засоби інтерактивного входу для Plugin провайдерів |
    | `plugin-sdk/provider-env-vars` | Допоміжні засоби пошуку auth env var для провайдерів |
    | `plugin-sdk/provider-auth` | `createProviderApiKeyAuthMethod`, `ensureApiKeyFromOptionEnvOrPrompt`, `upsertAuthProfile`, `upsertApiKeyProfile`, `writeOAuthCredentials` |
-    | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні побудовники replay-policy, допоміжні засоби endpoint провайдерів і допоміжні засоби нормалізації model-id, як-от `normalizeNativeXaiModelId` |
+    | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні побудовники політик replay, допоміжні засоби endpoint провайдерів і допоміжні засоби нормалізації id моделей, як-от `normalizeNativeXaiModelId` |
    | `plugin-sdk/provider-catalog-shared` | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
-    | `plugin-sdk/provider-http` | Загальні допоміжні засоби HTTP/можливостей endpoint для провайдерів, помилки HTTP провайдерів і допоміжні засоби multipart form для транскрипції аудіо |
-    | `plugin-sdk/provider-web-fetch-contract` | Вузькі допоміжні засоби контракту config/selection для web-fetch, як-от `enablePluginInConfig` і `WebFetchProviderPlugin` |
-    | `plugin-sdk/provider-web-fetch` | Допоміжні засоби реєстрації/кешування web-fetch провайдерів |
-    | `plugin-sdk/provider-web-search-config-contract` | Вузькі допоміжні засоби config/credential для web-search для провайдерів, яким не потрібне підключення ввімкнення plugin |
-    | `plugin-sdk/provider-web-search-contract` | Вузькі допоміжні засоби контракту config/credential для web-search, як-от `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` і scoped setter/getter-и credential |
-    | `plugin-sdk/provider-web-search` | Допоміжні засоби реєстрації/кешування/runtime для web-search провайдерів |
-    | `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схеми Gemini + діагностика, а також допоміжні засоби сумісності xAI, як-от `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
+    | `plugin-sdk/provider-http` | Універсальні допоміжні засоби HTTP/можливостей endpoint провайдера, HTTP-помилки провайдера та допоміжні засоби multipart form для аудіотранскрипції |
+    | `plugin-sdk/provider-web-fetch-contract` | Вузькі допоміжні засоби контрактів конфігурації/вибору web-fetch, як-от `enablePluginInConfig` і `WebFetchProviderPlugin` |
+    | `plugin-sdk/provider-web-fetch` | Допоміжні засоби реєстрації/кешу провайдера web-fetch |
+    | `plugin-sdk/provider-web-search-config-contract` | Вузькі допоміжні засоби конфігурації/облікових даних web-search для провайдерів, яким не потрібне підключення enable Plugin |
+    | `plugin-sdk/provider-web-search-contract` | Вузькі допоміжні засоби контрактів конфігурації/облікових даних web-search, як-от `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` і scope-овані setter/getter облікових даних |
+    | `plugin-sdk/provider-web-search` | Допоміжні засоби реєстрації/кешу/runtime провайдера web-search |
+    | `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схеми Gemini + діагностика та допоміжні засоби сумісності xAI, як-от `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
    | `plugin-sdk/provider-usage` | `fetchClaudeUsage` та подібні |
-    | `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи stream wrapper-ів і спільні допоміжні wrapper-и для Anthropic/Bedrock/DeepSeek V4/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
-    | `plugin-sdk/provider-transport-runtime` | Допоміжні засоби native transport для провайдерів, як-от guarded fetch, перетворення transport message і writable transport event streams |
-    | `plugin-sdk/provider-onboard` | Допоміжні засоби patch конфігурації онбордингу |
+    | `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи обгорток потоків і спільні допоміжні засоби обгорток Anthropic/Bedrock/DeepSeek V4/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
+    | `plugin-sdk/provider-transport-runtime` | Допоміжні засоби native transport провайдерів, як-от guarded fetch, трансформації транспортних повідомлень і потоки подій writable transport |
+    | `plugin-sdk/provider-onboard` | Допоміжні засоби патчів конфігурації онбордингу |
    | `plugin-sdk/global-singleton` | Допоміжні засоби process-local singleton/map/cache |
    | `plugin-sdk/group-activation` | Вузькі допоміжні засоби режиму активації груп і розбору команд |
  </Accordion>
@ -127,170 +127,181 @@ x-i18n:
    | --- | --- |
    | `plugin-sdk/command-auth` | `resolveControlCommandGate`, допоміжні засоби реєстру команд, включно з форматуванням меню динамічних аргументів, допоміжні засоби авторизації відправника |
    | `plugin-sdk/command-status` | Побудовники повідомлень команд/довідки, як-от `buildCommandsMessagePaginated` і `buildHelpMessage` |
-    | `plugin-sdk/approval-auth-runtime` | Допоміжні засоби визначення approver і action-auth у межах того самого чату |
-    | `plugin-sdk/approval-client-runtime` | Допоміжні засоби профілю/фільтра native exec approval |
-    | `plugin-sdk/approval-delivery-runtime` | Native адаптери можливостей/доставки approval |
-    | `plugin-sdk/approval-gateway-runtime` | Спільний допоміжний засіб визначення approval gateway |
-    | `plugin-sdk/approval-handler-adapter-runtime` | Полегшені допоміжні засоби завантаження native approval adapter для гарячих channel entrypoint |
-    | `plugin-sdk/approval-handler-runtime` | Ширші допоміжні засоби runtime для approval handler; надавайте перевагу вужчим швам adapter/gateway, коли їх достатньо |
-    | `plugin-sdk/approval-native-runtime` | Допоміжні засоби native approval target + account-binding |
-    | `plugin-sdk/approval-reply-runtime` | Допоміжні засоби payload відповіді для exec/plugin approval |
-    | `plugin-sdk/approval-runtime` | Допоміжні засоби payload для exec/plugin approval, допоміжні засоби native approval routing/runtime і допоміжні засоби структурованого відображення approval, як-от `formatApprovalDisplayPath` |
-    | `plugin-sdk/reply-dedupe` | Вузькі допоміжні засоби скидання dedupe для вхідних відповідей |
-    | `plugin-sdk/channel-contract-testing` | Вузькі допоміжні засоби тестування channel contract без широкого testing barrel |
-    | `plugin-sdk/command-auth-native` | Native command auth, форматування меню динамічних аргументів і допоміжні засоби native session-target |
+    | `plugin-sdk/approval-auth-runtime` | Допоміжні засоби визначення затверджувача та auth дій у межах того самого чату |
+    | `plugin-sdk/approval-client-runtime` | Native допоміжні засоби профілю/фільтра затвердження exec |
+    | `plugin-sdk/approval-delivery-runtime` | Native адаптери можливостей/доставки затверджень |
+    | `plugin-sdk/approval-gateway-runtime` | Спільний допоміжний засіб визначення gateway затверджень |
+    | `plugin-sdk/approval-handler-adapter-runtime` | Полегшені native допоміжні засоби завантаження адаптера затверджень для гарячих точок входу каналів |
+    | `plugin-sdk/approval-handler-runtime` | Ширші допоміжні засоби runtime обробника затверджень; віддавайте перевагу вужчим адаптерним/gateway швам, якщо їх достатньо |
+    | `plugin-sdk/approval-native-runtime` | Native допоміжні засоби цілей затвердження + прив’язки облікового запису |
+    | `plugin-sdk/approval-reply-runtime` | Допоміжні засоби payload відповіді на затвердження exec/plugin |
+    | `plugin-sdk/approval-runtime` | Допоміжні засоби payload затвердження exec/plugin, native допоміжні засоби маршрутизації/runtime затверджень і допоміжні засоби структурованого відображення затверджень, як-от `formatApprovalDisplayPath` |
+    | `plugin-sdk/reply-dedupe` | Вузькі допоміжні засоби скидання дедуплікації вхідних відповідей |
+    | `plugin-sdk/channel-contract-testing` | Вузькі допоміжні засоби тестування контракту каналу без широкого testing barrel |
+    | `plugin-sdk/command-auth-native` | Native auth команд, форматування меню динамічних аргументів і native допоміжні засоби цільових сесій |
    | `plugin-sdk/command-detection` | Спільні допоміжні засоби виявлення команд |
    | `plugin-sdk/command-primitives-runtime` | Полегшені предикати тексту команд для гарячих шляхів каналів |
-    | `plugin-sdk/command-surface` | Нормалізація command-body і допоміжні засоби command-surface |
+    | `plugin-sdk/command-surface` | Нормалізація тіла команд і допоміжні засоби command surface |
    | `plugin-sdk/allow-from` | `formatAllowFromLowercase` |
-    | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби збирання secret-contract для поверхонь secret каналів/плагінів |
-    | `plugin-sdk/secret-ref-runtime` | Вузькі допоміжні засоби `coerceSecretRef` і типізації SecretRef для розбору secret-contract/config |
-    | `plugin-sdk/security-runtime` | Спільні допоміжні засоби довіри, обмеження DM, зовнішнього вмісту, редагування чутливого тексту, порівняння секретів за сталий час і збирання секретів |
-    | `plugin-sdk/ssrf-policy` | Допоміжні засоби policy allowlist хостів і SSRF для приватної мережі |
-    | `plugin-sdk/ssrf-dispatcher` | Вузькі допоміжні засоби pinned-dispatcher без широкої поверхні infra runtime |
-    | `plugin-sdk/ssrf-runtime` | Допоміжні засоби pinned-dispatcher, SSRF-guarded fetch, SSRF error і SSRF policy |
-    | `plugin-sdk/secret-input` | Допоміжні засоби розбору secret input |
-    | `plugin-sdk/webhook-ingress` | Допоміжні засоби Webhook request/target і приведення raw websocket/body |
-    | `plugin-sdk/webhook-request-guards` | Допоміжні засоби для розміру body/timeout запиту |
+    | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби збирання контрактів секретів для поверхонь секретів channel/plugin |
+    | `plugin-sdk/secret-ref-runtime` | Вузькі допоміжні засоби `coerceSecretRef` і типізації SecretRef для парсингу контрактів секретів/конфігурації |
+    | `plugin-sdk/security-runtime` | Спільні допоміжні засоби довіри, gate для DM, зовнішнього вмісту, редагування чутливого тексту, порівняння секретів за сталий час і збирання секретів |
+    | `plugin-sdk/ssrf-policy` | Допоміжні засоби політики SSRF для allowlist хостів і приватних мереж |
+    | `plugin-sdk/ssrf-dispatcher` | Вузькі допоміжні засоби pinned dispatcher без широкої infra runtime surface |
+    | `plugin-sdk/ssrf-runtime` | Допоміжні засоби pinned dispatcher, fetch із захистом від SSRF, помилка SSRF і допоміжні засоби політики SSRF |
+    | `plugin-sdk/secret-input` | Допоміжні засоби парсингу введення секретів |
+    | `plugin-sdk/webhook-ingress` | Допоміжні засоби запитів/цілей Webhook і приведення необроблених websocket/body |
+    | `plugin-sdk/webhook-request-guards` | Допоміжні засоби розміру body/тайм-ауту запиту |
  </Accordion>

-  <Accordion title="Підшляхи runtime і зберігання">
+  <Accordion title="Підшляхи runtime і сховища">
    | Підшлях | Ключові експорти |
    | --- | --- |
-    | `plugin-sdk/runtime` | Широкі допоміжні засоби runtime/logging/backup/plugin-install |
-    | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби runtime env, logger, timeout, retry і backoff |
-    | `plugin-sdk/browser-config` | Підтримуваний фасад browser config для нормалізованого профілю/стандартних значень, розбору CDP URL і допоміжних засобів auth для browser-control |
-    | `plugin-sdk/channel-runtime-context` | Загальні допоміжні засоби реєстрації та пошуку channel runtime-context |
+    | `plugin-sdk/runtime` | Широкі допоміжні засоби runtime/логування/резервного копіювання/встановлення Plugin |
+    | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби env runtime, логера, тайм-аутів, повторних спроб і backoff |
+    | `plugin-sdk/browser-config` | Підтримуваний фасад конфігурації браузера для нормалізованих профілів/типових значень, парсингу CDP URL і допоміжних засобів auth browser-control |
+    | `plugin-sdk/channel-runtime-context` | Універсальні допоміжні засоби реєстрації та пошуку channel runtime-context |
    | `plugin-sdk/runtime-store` | `createPluginRuntimeStore` |
-    | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби plugin command/hook/http/interactive |
-    | `plugin-sdk/hook-runtime` | Спільні допоміжні засоби pipeline для Webhook/internal hook |
-    | `plugin-sdk/lazy-runtime` | Допоміжні засоби lazy runtime import/binding, як-от `createLazyRuntimeModule`, `createLazyRuntimeMethod` і `createLazyRuntimeSurface` |
+    | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби команд/хуків/http/інтерактивності Plugin |
+    | `plugin-sdk/hook-runtime` | Спільні допоміжні засоби конвеєра Webhook/внутрішніх хуків |
+    | `plugin-sdk/lazy-runtime` | Допоміжні засоби лінивого імпорту/прив’язки runtime, як-от `createLazyRuntimeModule`, `createLazyRuntimeMethod` і `createLazyRuntimeSurface` |
    | `plugin-sdk/process-runtime` | Допоміжні засоби exec процесів |
-    | `plugin-sdk/cli-runtime` | Допоміжні засоби форматування CLI, wait, version, argument-invocation і lazy command-group |
-    | `plugin-sdk/gateway-runtime` | Допоміжні засоби Gateway client, Gateway CLI RPC, помилки протоколу Gateway і patch стану каналу |
-    | `plugin-sdk/config-types` | Поверхня конфігурації лише для типів для форм конфігурації плагінів, як-от `OpenClawConfig` і типи конфігурації каналів/провайдерів |
-    | `plugin-sdk/plugin-config-runtime` | Допоміжні засоби пошуку plugin-config під час виконання, як-от `requireRuntimeConfig`, `resolvePluginConfigObject` і `resolveLivePluginConfigObject` |
-    | `plugin-sdk/config-mutation` | Допоміжні засоби транзакційної зміни конфігурації, як-от `mutateConfigFile`, `replaceConfigFile` і `logConfigUpdated` |
-    | `plugin-sdk/runtime-config-snapshot` | Допоміжні засоби snapshot конфігурації поточного процесу, як-от `getRuntimeConfig`, `getRuntimeConfigSnapshot`, і setter-и test snapshot |
-    | `plugin-sdk/telegram-command-config` | Нормалізація назви/опису команд Telegram і перевірки дублікатів/конфліктів, навіть коли поверхня bundled Telegram contract недоступна |
-    | `plugin-sdk/text-autolink-runtime` | Виявлення autolink для посилань на файли без широкого barrel `text-runtime` |
-    | `plugin-sdk/approval-runtime` | Допоміжні засоби exec/plugin approval, побудовники approval-capability, допоміжні засоби auth/profile, native routing/runtime і форматування шляху структурованого відображення approval |
-    | `plugin-sdk/reply-runtime` | Спільні допоміжні засоби inbound/reply runtime, chunking, dispatch, Heartbeat, планувальник reply |
-    | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби dispatch/finalize відповіді та conversation-label |
-    | `plugin-sdk/reply-history` | Спільні допоміжні засоби short-window reply-history, як-от `buildHistoryContext`, `recordPendingHistoryEntry` і `clearHistoryEntriesIfEnabled` |
+    | `plugin-sdk/cli-runtime` | Допоміжні засоби форматування CLI, очікування, версій, виклику аргументів і лінивих груп команд |
+    | `plugin-sdk/gateway-runtime` | Допоміжні засоби клієнта Gateway, CLI RPC Gateway, помилок протоколу Gateway і патчів статусу каналу |
+    | `plugin-sdk/config-types` | Поверхня конфігурації лише для типів для форм конфігурації Plugin, як-от `OpenClawConfig` і типів конфігурації каналів/провайдерів |
+    | `plugin-sdk/plugin-config-runtime` | Допоміжні засоби пошуку конфігурації Plugin під час виконання, як-от `requireRuntimeConfig`, `resolvePluginConfigObject` і `resolveLivePluginConfigObject` |
+    | `plugin-sdk/config-mutation` | Допоміжні засоби транзакційної мутації конфігурації, як-от `mutateConfigFile`, `replaceConfigFile` і `logConfigUpdated` |
+    | `plugin-sdk/runtime-config-snapshot` | Допоміжні засоби знімка конфігурації поточного процесу, як-от `getRuntimeConfig`, `getRuntimeConfigSnapshot` і setter-и тестових знімків |
+    | `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації назв/описів команд Telegram і перевірки дублікатів/конфліктів, навіть коли bundled поверхня контракту Telegram недоступна |
+    | `plugin-sdk/text-autolink-runtime` | Виявлення автопосилань на файли без широкого barrel `text-runtime` |
+    | `plugin-sdk/approval-runtime` | Допоміжні засоби затвердження exec/plugin, побудовники можливостей затвердження, допоміжні засоби auth/профілів, native допоміжні засоби маршрутизації/runtime і форматування шляху структурованого відображення затверджень |
+    | `plugin-sdk/reply-runtime` | Спільні допоміжні засоби runtime вхідних повідомлень/відповідей, chunking, dispatch, Heartbeat, планувальник відповідей |
+    | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби dispatch/finalize відповідей і міток розмов |
+    | `plugin-sdk/reply-history` | Спільні допоміжні засоби коротковіконної історії відповідей, як-от `buildHistoryContext`, `recordPendingHistoryEntry` і `clearHistoryEntriesIfEnabled` |
    | `plugin-sdk/reply-reference` | `createReplyReferencePlanner` |
-    | `plugin-sdk/reply-chunking` | Вузькі допоміжні засоби chunking для text/markdown |
-    | `plugin-sdk/session-store-runtime` | Допоміжні засоби для шляху session store, session-key, updated-at і зміни store |
-    | `plugin-sdk/cron-store-runtime` | Допоміжні засоби для шляху/load/save Cron store |
+    | `plugin-sdk/reply-chunking` | Вузькі допоміжні засоби chunking тексту/Markdown |
+    | `plugin-sdk/session-store-runtime` | Допоміжні засоби шляху сховища сесій, ключів сесій, updated-at і мутації сховища |
+    | `plugin-sdk/cron-store-runtime` | Допоміжні засоби шляху/завантаження/збереження сховища Cron |
    | `plugin-sdk/state-paths` | Допоміжні засоби шляхів до каталогів state/OAuth |
-    | `plugin-sdk/routing` | Допоміжні засоби route/session-key/account binding, як-от `resolveAgentRoute`, `buildAgentSessionKey` і `resolveDefaultAgentBoundAccountId` |
-    | `plugin-sdk/status-helpers` | Спільні допоміжні засоби summary стану каналу/облікового запису, стандартні значення runtime-state і допоміжні засоби метаданих issue |
-    | `plugin-sdk/target-resolver-runtime` | Спільні допоміжні засоби target resolver |
+    | `plugin-sdk/routing` | Допоміжні засоби прив’язки маршрутів/ключів сесій/облікових записів, як-от `resolveAgentRoute`, `buildAgentSessionKey` і `resolveDefaultAgentBoundAccountId` |
+    | `plugin-sdk/status-helpers` | Спільні допоміжні засоби підсумку статусу каналу/облікового запису, типових значень runtime state і метаданих проблем |
+    | `plugin-sdk/target-resolver-runtime` | Спільні допоміжні засоби визначення цілей |
    | `plugin-sdk/string-normalization-runtime` | Допоміжні засоби нормалізації slug/рядків |
-    | `plugin-sdk/request-url` | Витягування URL-рядків з input типу fetch/request |
-    | `plugin-sdk/run-command` | Виконавець команд із тайм-аутом і нормалізованими результатами stdout/stderr |
-    | `plugin-sdk/param-readers` | Поширені зчитувачі параметрів tool/CLI |
+    | `plugin-sdk/request-url` | Витягування рядкових URL із fetch/request-подібних входів |
+    | `plugin-sdk/run-command` | Виконавець команд із таймером і нормалізованими результатами stdout/stderr |
+    | `plugin-sdk/param-readers` | Поширені засоби читання параметрів tool/CLI |
    | `plugin-sdk/tool-payload` | Витягування нормалізованих payload з об’єктів результатів tool |
-    | `plugin-sdk/tool-send` | Витягування канонічних полів send target з аргументів tool |
-    | `plugin-sdk/temp-path` | Спільні допоміжні засоби шляхів для тимчасових завантажень |
-    | `plugin-sdk/logging-core` | Допоміжні засоби subsystem logger і редагування |
+    | `plugin-sdk/tool-send` | Витягування канонічних полів цілей надсилання з аргументів tool |
+    | `plugin-sdk/temp-path` | Спільні допоміжні засоби шляхів тимчасових завантажень |
+    | `plugin-sdk/logging-core` | Допоміжні засоби логера підсистеми та редагування |
    | `plugin-sdk/markdown-table-runtime` | Допоміжні засоби режиму й перетворення таблиць Markdown |
-    | `plugin-sdk/model-session-runtime` | Допоміжні засоби override моделі/сесії, як-от `applyModelOverrideToSessionEntry` і `resolveAgentMaxConcurrent` |
-    | `plugin-sdk/talk-config-runtime` | Допоміжні засоби визначення конфігурації talk provider |
+    | `plugin-sdk/model-session-runtime` | Допоміжні засоби перевизначення моделі/сесії, як-от `applyModelOverrideToSessionEntry` і `resolveAgentMaxConcurrent` |
+    | `plugin-sdk/talk-config-runtime` | Допоміжні засоби визначення конфігурації talk-провайдера |
    | `plugin-sdk/json-store` | Невеликі допоміжні засоби читання/запису стану JSON |
-    | `plugin-sdk/file-lock` | Допоміжні засоби повторно вхідного file-lock |
-    | `plugin-sdk/persistent-dedupe` | Допоміжні засоби dedupe cache на диску |
-    | `plugin-sdk/acp-runtime` | Допоміжні засоби ACP runtime/session і reply-dispatch |
-    | `plugin-sdk/acp-binding-resolve-runtime` | Визначення ACP binding лише для читання без import життєвого циклу запуску |
-    | `plugin-sdk/agent-config-primitives` | Вузькі примітиви config-schema для agent runtime |
-    | `plugin-sdk/boolean-param` | Нестрогий зчитувач boolean-параметрів |
+    | `plugin-sdk/file-lock` | Допоміжні засоби повторно вхідного file lock |
+    | `plugin-sdk/persistent-dedupe` | Допоміжні засоби кешу дедуплікації з дисковим зберіганням |
+    | `plugin-sdk/acp-runtime` | Допоміжні засоби runtime/сесій ACP і dispatch відповідей |
+    | `plugin-sdk/acp-binding-resolve-runtime` | Визначення прив’язок ACP лише для читання без імпортів запуску життєвого циклу |
+    | `plugin-sdk/agent-config-primitives` | Вузькі примітиви схеми конфігурації runtime агента |
+    | `plugin-sdk/boolean-param` | Засіб читання нечіткого булевого параметра |
    | `plugin-sdk/dangerous-name-runtime` | Допоміжні засоби визначення збігів небезпечних назв |
-    | `plugin-sdk/device-bootstrap` | Допоміжні засоби початкового налаштування пристрою та токенів pairing |
-    | `plugin-sdk/extension-shared` | Спільні примітиви допоміжних засобів passive-channel, status і ambient proxy |
-    | `plugin-sdk/models-provider-runtime` | Допоміжні засоби відповіді `/models` command/provider |
-    | `plugin-sdk/skill-commands-runtime` | Допоміжні засоби списку команд Skills |
-    | `plugin-sdk/native-command-registry` | Допоміжні засоби реєстрації/build/serialize native command |
-    | `plugin-sdk/agent-harness` | Експериментальна поверхня trusted-plugin для низькорівневих agent harness: типи harness, допоміжні засоби steer/abort для active-run, допоміжні засоби мосту OpenClaw tool, допоміжні засоби policy інструментів runtime-plan, класифікація terminal outcome, допоміжні засоби форматування/деталізації прогресу інструментів і утиліти результатів спроб |
+    | `plugin-sdk/device-bootstrap` | Допоміжні засоби початкового налаштування пристрою та токенів спарювання |
+    | `plugin-sdk/extension-shared` | Спільні примітиви допоміжних засобів passive-channel, статусу та ambient proxy |
+    | `plugin-sdk/models-provider-runtime` | Допоміжні засоби відповідей команди `/models`/провайдера |
+    | `plugin-sdk/skill-commands-runtime` | Допоміжні засоби виведення списку команд Skills |
+    | `plugin-sdk/native-command-registry` | Допоміжні засоби реєстру/build/serialize native команд |
+    | `plugin-sdk/agent-harness` | Експериментальна surface довіреного Plugin для низькорівневих harness агента: типи harness, допоміжні засоби steer/abort активного запуску, допоміжні засоби мосту tool OpenClaw, допоміжні засоби політики tool плану runtime, класифікація результатів terminal, допоміжні засоби форматування/деталізації прогресу tool і утиліти результатів спроб |
    | `plugin-sdk/provider-zai-endpoint` | Допоміжні засоби виявлення endpoint Z.AI |
-    | `plugin-sdk/infra-runtime` | Допоміжні засоби system event/Heartbeat |
-    | `plugin-sdk/collection-runtime` | Невеликі допоміжні засоби обмеженого cache |
-    | `plugin-sdk/diagnostic-runtime` | Допоміжні засоби для diagnostic flag, event і trace-context |
-    | `plugin-sdk/error-runtime` | Граф помилок, форматування, спільні допоміжні засоби класифікації помилок, `isApprovalNotFoundError` |
-    | `plugin-sdk/fetch-runtime` | Допоміжні засоби wrapped fetch, proxy і pinned lookup |
-    | `plugin-sdk/runtime-fetch` | Runtime fetch з урахуванням dispatcher без import proxy/guarded-fetch |
-    | `plugin-sdk/response-limit-runtime` | Обмежений зчитувач body відповіді без широкої поверхні media runtime |
-    | `plugin-sdk/session-binding-runtime` | Поточний стан binding conversation без configured binding routing або pairing store |
-    | `plugin-sdk/session-store-runtime` | Допоміжні засоби session-store без широких import запису/обслуговування config |
-    | `plugin-sdk/context-visibility-runtime` | Визначення видимості контексту і фільтрація додаткового контексту без широких import config/security |
-    | `plugin-sdk/string-coerce-runtime` | Вузькі допоміжні засоби приведення й нормалізації primitive record/string без import markdown/logging |
+    | `plugin-sdk/async-lock-runtime` | Допоміжний засіб process-local async lock для невеликих файлів стану runtime |
+    | `plugin-sdk/channel-activity-runtime` | Допоміжний засіб телеметрії активності каналу |
+    | `plugin-sdk/concurrency-runtime` | Допоміжний засіб обмеженої конкурентності асинхронних завдань |
+    | `plugin-sdk/dedupe-runtime` | Допоміжні засоби кешу дедуплікації в пам’яті |
+    | `plugin-sdk/delivery-queue-runtime` | Допоміжний засіб осушення черги очікуваної вихідної доставки |
+    | `plugin-sdk/file-access-runtime` | Допоміжні засоби безпечних шляхів локальних файлів і джерел медіа |
+    | `plugin-sdk/heartbeat-runtime` | Допоміжні засоби подій і видимості Heartbeat |
+    | `plugin-sdk/number-runtime` | Допоміжний засіб приведення числових значень |
+    | `plugin-sdk/secure-random-runtime` | Допоміжні засоби безпечних токенів/UUID |
+    | `plugin-sdk/system-event-runtime` | Допоміжні засоби черги системних подій |
+    | `plugin-sdk/transport-ready-runtime` | Допоміжний засіб очікування готовності транспорту |
+    | `plugin-sdk/infra-runtime` | Застарілий shim сумісності; використовуйте наведені вище сфокусовані підшляхи runtime |
+    | `plugin-sdk/collection-runtime` | Невеликі допоміжні засоби обмеженого кешу |
+    | `plugin-sdk/diagnostic-runtime` | Допоміжні засоби діагностичних прапорців, подій і trace context |
+    | `plugin-sdk/error-runtime` | Допоміжні засоби графа помилок, форматування, спільної класифікації помилок, `isApprovalNotFoundError` |
+    | `plugin-sdk/fetch-runtime` | Допоміжні засоби обгорнутого fetch, proxy і pinned lookup |
+    | `plugin-sdk/runtime-fetch` | Runtime fetch з урахуванням dispatcher без імпортів proxy/guarded-fetch |
+    | `plugin-sdk/response-limit-runtime` | Засіб читання body відповіді з обмеженням без широкої media runtime surface |
+    | `plugin-sdk/session-binding-runtime` | Поточний стан прив’язки розмови без маршрутизації налаштованих прив’язок або сховищ спарювання |
+    | `plugin-sdk/session-store-runtime` | Допоміжні засоби сховища сесій без широких імпортів запису/обслуговування конфігурації |
+    | `plugin-sdk/context-visibility-runtime` | Допоміжні засоби визначення видимості контексту та фільтрації додаткового контексту без широких імпортів конфігурації/безпеки |
+    | `plugin-sdk/string-coerce-runtime` | Вузькі допоміжні засоби приведення та нормалізації примітивних записів/рядків без імпортів markdown/логування |
    | `plugin-sdk/host-runtime` | Допоміжні засоби нормалізації hostname і SCP host |
-    | `plugin-sdk/retry-runtime` | Допоміжні засоби конфігурації retry і запуску retry |
-    | `plugin-sdk/agent-runtime` | Допоміжні засоби для каталогу/ідентичності/workspace агента |
-    | `plugin-sdk/directory-runtime` | Запит/усунення дублікатів каталогів на основі config |
+    | `plugin-sdk/retry-runtime` | Допоміжні засоби конфігурації повторних спроб і виконавця повторних спроб |
+    | `plugin-sdk/agent-runtime` | Допоміжні засоби каталогів/ідентичності/робочого простору агента |
+    | `plugin-sdk/directory-runtime` | Запит/дедуплікація каталогів на основі конфігурації |
    | `plugin-sdk/keyed-async-queue` | `KeyedAsyncQueue` |
  </Accordion>

  <Accordion title="Підшляхи можливостей і тестування">
    | Підшлях | Ключові експорти |
    | --- | --- |
-    | `plugin-sdk/media-runtime` | Спільні допоміжні засоби fetch/transform/store для media, а також побудовники media payload |
+    | `plugin-sdk/media-runtime` | Спільні допоміжні засоби fetch/transform/store для медіа, а також побудовники media payload |
    | `plugin-sdk/media-store` | Вузькі допоміжні засоби media store, як-от `saveMediaBuffer` |
-    | `plugin-sdk/media-generation-runtime` | Спільні допоміжні засоби failover для генерації media, вибір кандидатів і повідомлення про відсутню модель |
-    | `plugin-sdk/media-understanding` | Типи провайдерів розуміння media, а також орієнтовані на провайдерів експорти допоміжних засобів для image/audio |
-    | `plugin-sdk/text-runtime` | Спільні допоміжні засоби text/markdown/logging, як-от видалення тексту, видимого асистенту, допоміжні засоби render/chunking/table для markdown, допоміжні засоби редагування, допоміжні засоби directive-tag і утиліти safe-text |
-    | `plugin-sdk/text-chunking` | Допоміжний засіб chunking для outbound text |
-    | `plugin-sdk/speech` | Типи провайдерів speech, а також орієнтовані на провайдерів експорти directive, registry, validation і допоміжних засобів speech |
-    | `plugin-sdk/speech-core` | Спільні типи провайдерів speech, registry, directive, normalization і експорти допоміжних засобів speech |
-    | `plugin-sdk/realtime-transcription` | Типи провайдерів realtime transcription, допоміжні засоби registry і спільний допоміжний засіб сесії WebSocket |
-    | `plugin-sdk/realtime-voice` | Типи провайдерів realtime voice і допоміжні засоби registry |
+    | `plugin-sdk/media-generation-runtime` | Спільні допоміжні засоби failover для генерації медіа, вибір кандидатів і повідомлення про відсутні моделі |
+    | `plugin-sdk/media-understanding` | Типи провайдерів для розуміння медіа, а також провайдер-орієнтовані експорти допоміжних засобів для зображень/аудіо |
+    | `plugin-sdk/text-runtime` | Спільні допоміжні засоби тексту/Markdown/логування, як-от видалення тексту, видимого асистенту, допоміжні засоби рендерингу/chunking/таблиць Markdown, допоміжні засоби редагування, допоміжні засоби directive tag і утиліти безпечного тексту |
+    | `plugin-sdk/text-chunking` | Допоміжний засіб chunking вихідного тексту |
+    | `plugin-sdk/speech` | Типи провайдерів мовлення, а також провайдер-орієнтовані експорти директив, реєстру, валідації та допоміжних засобів мовлення |
+    | `plugin-sdk/speech-core` | Спільні типи провайдерів мовлення, експорти реєстру, директив, нормалізації та допоміжних засобів мовлення |
+    | `plugin-sdk/realtime-transcription` | Типи провайдерів транскрипції в реальному часі, допоміжні засоби реєстру та спільний допоміжний засіб сесій WebSocket |
+    | `plugin-sdk/realtime-voice` | Типи провайдерів голосу в реальному часі та допоміжні засоби реєстру |
    | `plugin-sdk/image-generation` | Типи провайдерів генерації зображень |
-    | `plugin-sdk/image-generation-core` | Спільні типи генерації зображень, допоміжні засоби failover, auth і registry |
-    | `plugin-sdk/music-generation` | Типи провайдера/запиту/результату генерації музики |
-    | `plugin-sdk/music-generation-core` | Спільні типи генерації музики, допоміжні засоби failover, пошук провайдерів і розбір model-ref |
-    | `plugin-sdk/video-generation` | Типи провайдера/запиту/результату генерації відео |
-    | `plugin-sdk/video-generation-core` | Спільні типи генерації відео, допоміжні засоби failover, пошук провайдерів і розбір model-ref |
-    | `plugin-sdk/webhook-targets` | Допоміжні засоби registry цілей Webhook і встановлення маршрутів |
-    | `plugin-sdk/webhook-path` | Допоміжні засоби нормалізації шляху Webhook |
-    | `plugin-sdk/web-media` | Спільні допоміжні засоби завантаження віддалених/локальних media |
-    | `plugin-sdk/zod` | Повторно експортований `zod` для споживачів Plugin SDK |
-    | `plugin-sdk/testing` | `installCommonResolveTargetErrorCases`, `shouldAckReaction` |
+    | `plugin-sdk/image-generation-core` | Спільні типи генерації зображень, допоміжні засоби failover, auth і реєстру |
+    | `plugin-sdk/music-generation` | Типи провайдерів/запитів/результатів генерації музики |
+    | `plugin-sdk/music-generation-core` | Спільні типи генерації музики, допоміжні засоби failover, пошук провайдера та парсинг model ref |
+    | `plugin-sdk/video-generation` | Типи провайдерів/запитів/результатів генерації відео |
+    | `plugin-sdk/video-generation-core` | Спільні типи генерації відео, допоміжні засоби failover, пошук провайдера та парсинг model ref |
+    | `plugin-sdk/webhook-targets` | Допоміжні засоби реєстру цілей Webhook і встановлення маршрутів |
+    | `plugin-sdk/webhook-path` | Допоміжні засоби нормалізації шляхів Webhook |
+    | `plugin-sdk/web-media` | Спільні допоміжні засоби завантаження віддалених/локальних медіа |
+    | `plugin-sdk/zod` | Повторно експортований `zod` для користувачів Plugin SDK |
+    | `plugin-sdk/testing` | Публічні допоміжні засоби тестування extensions, зокрема `installCommonResolveTargetErrorCases`, `shouldAckReaction`, `writeSkill`, `createTestRegistry` і завантаження env для live generation |
  </Accordion>

  <Accordion title="Підшляхи пам’яті">
    | Підшлях | Ключові експорти |
    | --- | --- |
-    | `plugin-sdk/memory-core` | Поверхня допоміжних засобів bundled memory-core для manager/config/file/CLI helper-ів |
-    | `plugin-sdk/memory-core-engine-runtime` | Runtime-фасад індексування/пошуку пам’яті |
+    | `plugin-sdk/memory-core` | Поверхня допоміжних засобів bundled memory-core для менеджера/конфігурації/файлів/допоміжних засобів CLI |
+    | `plugin-sdk/memory-core-engine-runtime` | Фасад runtime індексації/пошуку пам’яті |
    | `plugin-sdk/memory-core-host-engine-foundation` | Експорти foundation engine хоста пам’яті |
-    | `plugin-sdk/memory-core-host-engine-embeddings` | Контракти embeddings хоста пам’яті, доступ до registry, локальний провайдер і загальні допоміжні засоби batch/remote |
+    | `plugin-sdk/memory-core-host-engine-embeddings` | Контракти embedding хоста пам’яті, доступ до реєстру, локальний провайдер і універсальні пакетні/віддалені допоміжні засоби |
    | `plugin-sdk/memory-core-host-engine-qmd` | Експорти QMD engine хоста пам’яті |
    | `plugin-sdk/memory-core-host-engine-storage` | Експорти storage engine хоста пам’яті |
    | `plugin-sdk/memory-core-host-multimodal` | Мультимодальні допоміжні засоби хоста пам’яті |
    | `plugin-sdk/memory-core-host-query` | Допоміжні засоби запитів хоста пам’яті |
-    | `plugin-sdk/memory-core-host-secret` | Допоміжні засоби secret хоста пам’яті |
+    | `plugin-sdk/memory-core-host-secret` | Допоміжні засоби секретів хоста пам’яті |
    | `plugin-sdk/memory-core-host-events` | Допоміжні засоби журналу подій хоста пам’яті |
-    | `plugin-sdk/memory-core-host-status` | Допоміжні засоби стану хоста пам’яті |
+    | `plugin-sdk/memory-core-host-status` | Допоміжні засоби статусу хоста пам’яті |
    | `plugin-sdk/memory-core-host-runtime-cli` | Допоміжні засоби runtime CLI хоста пам’яті |
-    | `plugin-sdk/memory-core-host-runtime-core` | Допоміжні засоби основного runtime хоста пам’яті |
+    | `plugin-sdk/memory-core-host-runtime-core` | Допоміжні засоби core runtime хоста пам’яті |
    | `plugin-sdk/memory-core-host-runtime-files` | Допоміжні засоби файлів/runtime хоста пам’яті |
-    | `plugin-sdk/memory-host-core` | Нейтральний до постачальника псевдонім для допоміжних засобів основного runtime хоста пам’яті |
-    | `plugin-sdk/memory-host-events` | Нейтральний до постачальника псевдонім для допоміжних засобів журналу подій хоста пам’яті |
-    | `plugin-sdk/memory-host-files` | Нейтральний до постачальника псевдонім для допоміжних засобів файлів/runtime хоста пам’яті |
-    | `plugin-sdk/memory-host-markdown` | Спільні допоміжні засоби керованого markdown для плагінів, суміжних із пам’яттю |
-    | `plugin-sdk/memory-host-search` | Runtime-фасад Active Memory для доступу до search-manager |
-    | `plugin-sdk/memory-host-status` | Нейтральний до постачальника псевдонім для допоміжних засобів стану хоста пам’яті |
+    | `plugin-sdk/memory-host-core` | Незалежний від постачальника псевдонім для допоміжних засобів core runtime хоста пам’яті |
+    | `plugin-sdk/memory-host-events` | Незалежний від постачальника псевдонім для допоміжних засобів журналу подій хоста пам’яті |
+    | `plugin-sdk/memory-host-files` | Незалежний від постачальника псевдонім для допоміжних засобів файлів/runtime хоста пам’яті |
+    | `plugin-sdk/memory-host-markdown` | Спільні допоміжні засоби керованого Markdown для Plugin, суміжних із пам’яттю |
+    | `plugin-sdk/memory-host-search` | Фасад runtime Active Memory для доступу до менеджера пошуку |
+    | `plugin-sdk/memory-host-status` | Незалежний від постачальника псевдонім для допоміжних засобів статусу хоста пам’яті |
    | `plugin-sdk/memory-lancedb` | Поверхня допоміжних засобів bundled memory-lancedb |
  </Accordion>

  <Accordion title="Зарезервовані підшляхи bundled-helper">
    | Сімейство | Поточні підшляхи | Призначення |
    | --- | --- | --- |
-    | Browser | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Допоміжні засоби підтримки bundled browser plugin. `browser-profiles` експортує `resolveBrowserConfig`, `resolveProfile`, `ResolvedBrowserConfig`, `ResolvedBrowserProfile` і `ResolvedBrowserTabCleanupConfig` для нормалізованої форми `browser.tabCleanup`. `browser-support` залишається compatibility barrel. |
-    | Matrix | `plugin-sdk/matrix`, `plugin-sdk/matrix-helper`, `plugin-sdk/matrix-runtime-heavy`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/matrix-runtime-surface`, `plugin-sdk/matrix-surface`, `plugin-sdk/matrix-thread-bindings` | Поверхня helper/runtime для bundled Matrix |
-    | Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Поверхня helper/runtime для bundled LINE |
-    | IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Поверхня helper для bundled IRC |
-    | Допоміжні засоби, специфічні для каналів | `plugin-sdk/googlechat`, `plugin-sdk/googlechat-runtime-shared`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu`, `plugin-sdk/feishu-conversation`, `plugin-sdk/feishu-setup`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/telegram-command-ui`, `plugin-sdk/tlon`, `plugin-sdk/twitch`, `plugin-sdk/zalo`, `plugin-sdk/zalo-setup` | Застарілі шви сумісності/helper для bundled channel. Нові плагіни повинні імпортувати загальні підшляхи SDK або локальні barrel-експорти плагіна. |
-    | Допоміжні засоби auth/специфічні для плагінів | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diagnostics-prometheus`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/memory-core`, `plugin-sdk/memory-lancedb`, `plugin-sdk/opencode`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Шви helper для bundled feature/plugin; `plugin-sdk/github-copilot-token` наразі експортує `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` і `resolveCopilotApiToken` |
+    | Browser | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Допоміжні засоби підтримки bundled browser Plugin. `browser-profiles` експортує `resolveBrowserConfig`, `resolveProfile`, `ResolvedBrowserConfig`, `ResolvedBrowserProfile` і `ResolvedBrowserTabCleanupConfig` для нормалізованої форми `browser.tabCleanup`. `browser-support` залишається compatibility barrel. |
+    | Matrix | `plugin-sdk/matrix`, `plugin-sdk/matrix-helper`, `plugin-sdk/matrix-runtime-heavy`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/matrix-runtime-surface`, `plugin-sdk/matrix-surface`, `plugin-sdk/matrix-thread-bindings` | Поверхня допоміжних засобів/runtime bundled Matrix |
+    | Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Поверхня допоміжних засобів/runtime bundled LINE |
+    | IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Поверхня допоміжних засобів bundled IRC |
+    | Допоміжні засоби, специфічні для каналу | `plugin-sdk/googlechat`, `plugin-sdk/googlechat-runtime-shared`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu`, `plugin-sdk/feishu-conversation`, `plugin-sdk/feishu-setup`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/telegram-command-ui`, `plugin-sdk/tlon`, `plugin-sdk/twitch`, `plugin-sdk/zalo`, `plugin-sdk/zalo-setup` | Застарілі шви сумісності/допоміжних засобів bundled channel. Нові Plugin мають імпортувати універсальні підшляхи SDK або локальні barrel Plugin. |
+    | Допоміжні засоби auth/специфічні для Plugin | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diagnostics-prometheus`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/memory-core`, `plugin-sdk/memory-lancedb`, `plugin-sdk/opencode`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Шви допоміжних засобів bundled features/Plugin; `plugin-sdk/github-copilot-token` наразі експортує `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` і `resolveCopilotApiToken` |
  </Accordion>
 </AccordionGroup>

@ -298,4 +309,4 @@ x-i18n:

 - [Огляд Plugin SDK](/uk/plugins/sdk-overview)
 - [Налаштування Plugin SDK](/uk/plugins/sdk-setup)
- [Створення плагінів](/uk/plugins/building-plugins)
+- [Створення Plugin](/uk/plugins/building-plugins)
--- a/docs/uk/providers/index.md
+++ b/docs/uk/providers/index.md
@ -1,24 +1,23 @@
 ---
 read_when:
    - Ви хочете вибрати провайдера моделі
-    - Вам потрібен короткий огляд підтримуваних бекендів LLM
+    - Вам потрібен швидкий огляд підтримуваних LЛM-бекендів
 summary: Провайдери моделей (LLM), які підтримує OpenClaw
 title: Каталог провайдерів
 x-i18n:
-    generated_at: "2026-04-27T09:30:51Z"
+    generated_at: "2026-04-27T20:08:42Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 5a20e0fd3464755880656da60e95d72e214dd13fc99d9aa4f3b7daaa212d12ec
+    source_hash: 61143200b2e7a74392cf8871bfcd210fe35dbd5118e2e8bc7b15265192fd2bde
    source_path: providers/index.md
    workflow: 15
 ---

 # Провайдери моделей

-OpenClaw може використовувати багато провайдерів LLM. Виберіть провайдера, пройдіть автентифікацію, а потім установіть
-модель за замовчуванням у форматі `provider/model`.
+OpenClaw може використовувати багато провайдерів LLM. Виберіть провайдера, пройдіть автентифікацію, а потім задайте модель за замовчуванням у форматі `provider/model`.

-Шукаєте документацію про chat-канали (WhatsApp/Telegram/Discord/Slack/Mattermost (plugin)/тощо)? Див. [Channels](/uk/channels).
+Шукаєте документацію для чат-каналів (WhatsApp/Telegram/Discord/Slack/Mattermost (plugin)/тощо)? Див. [Канали](/uk/channels).

 ## Швидкий старт

@ -49,14 +48,14 @@ OpenClaw може використовувати багато провайдер
 - [fal](/uk/providers/fal)
 - [Fireworks](/uk/providers/fireworks)
 - [GitHub Copilot](/uk/providers/github-copilot)
- [Gradium](/uk/providers/gradium)
 - [Моделі GLM](/uk/providers/glm)
 - [Google (Gemini)](/uk/providers/google)
+- [Gradium](/uk/providers/gradium)
 - [Groq (LPU-інференс)](/uk/providers/groq)
- [Hugging Face (Inference)](/uk/providers/huggingface)
+- [Hugging Face (інференс)](/uk/providers/huggingface)
 - [inferrs (локальні моделі)](/uk/providers/inferrs)
 - [Kilocode](/uk/providers/kilocode)
- [LiteLLM (уніфікований gateway)](/uk/providers/litellm)
+- [LiteLLM (уніфікований Gateway)](/uk/providers/litellm)
 - [LM Studio (локальні моделі)](/uk/providers/lmstudio)
 - [MiniMax](/uk/providers/minimax)
 - [Mistral](/uk/providers/mistral)
@ -77,7 +76,7 @@ OpenClaw може використовувати багато провайдер
 - [Synthetic](/uk/providers/synthetic)
 - [Tencent Cloud (TokenHub)](/uk/providers/tencent)
 - [Together AI](/uk/providers/together)
- [Venice (Venice AI, зосереджений на конфіденційності)](/uk/providers/venice)
+- [Venice (Venice AI, з акцентом на приватність)](/uk/providers/venice)
 - [Vercel AI Gateway](/uk/providers/vercel-ai-gateway)
 - [vLLM (локальні моделі)](/uk/providers/vllm)
 - [Volcengine (Doubao)](/uk/providers/volcengine)
@ -89,9 +88,9 @@ OpenClaw може використовувати багато провайдер
 ## Спільні оглядові сторінки

 - [Додаткові вбудовані варіанти](/uk/providers/models#additional-bundled-provider-variants) - Anthropic Vertex, Copilot Proxy і Gemini CLI OAuth
- [Генерація зображень](/uk/tools/image-generation) - спільний інструмент `image_generate`, вибір провайдера та failover
- [Генерація музики](/uk/tools/music-generation) - спільний інструмент `music_generate`, вибір провайдера та failover
- [Генерація відео](/uk/tools/video-generation) - спільний інструмент `video_generate`, вибір провайдера та failover
+- [Генерація зображень](/uk/tools/image-generation) - Спільний інструмент `image_generate`, вибір провайдера та failover
+- [Генерація музики](/uk/tools/music-generation) - Спільний інструмент `music_generate`, вибір провайдера та failover
+- [Генерація відео](/uk/tools/video-generation) - Спільний інструмент `video_generate`, вибір провайдера та failover

 ## Провайдери транскрибування

@ -104,7 +103,6 @@ OpenClaw може використовувати багато провайдер

 ## Інструменти спільноти

- [Claude Max API Proxy](/uk/providers/claude-max-api-proxy) - проксі від спільноти для облікових даних підписки Claude (перед використанням перевірте політику/умови Anthropic)
+- [Claude Max API Proxy](/uk/providers/claude-max-api-proxy) - Проксі від спільноти для облікових даних підписки Claude (перед використанням перевірте політику/умови Anthropic)

-Повний каталог провайдерів (xAI, Groq, Mistral тощо) та розширену конфігурацію
-див. у [Model providers](/uk/concepts/model-providers).
+Повний каталог провайдерів (xAI, Groq, Mistral тощо) і розширену конфігурацію див. у розділі [Провайдери моделей](/uk/concepts/model-providers).
--- a/docs/uk/reference/session-management-compaction.md
+++ b/docs/uk/reference/session-management-compaction.md
@ -1,75 +1,75 @@
 ---
 read_when:
-    - Вам потрібно налагодити ідентифікатори сеансів, JSONL транскриптів або поля sessions.json
-    - Ви змінюєте поведінку авто-Compaction або додаєте підготовче обслуговування перед Compaction
+    - Вам потрібно налагодити ідентифікатори сесій, JSONL транскриптів або поля в sessions.json
+    - Ви змінюєте поведінку авто-Compaction або додаєте прибирання перед Compaction
    - Ви хочете реалізувати скидання пам’яті або тихі системні ходи
-summary: 'Поглиблений розбір: сховище сеансів і транскрипти, життєвий цикл та внутрішня логіка (авто)Compaction'
-title: Поглиблений розбір керування сеансами
+summary: 'Глибокий огляд: сховище сесій і транскрипти, життєвий цикл та внутрішні механізми (авто)Compaction'
+title: Глибокий огляд керування сесіями
 x-i18n:
-    generated_at: "2026-04-27T14:21:20Z"
+    generated_at: "2026-04-27T20:08:48Z"
    model: gpt-5.4
    provider: openai
-    source_hash: ccbfd09d01a12d38ab71510fbb81416283fc6c6459ff66ee82e36868e008d118
+    source_hash: aeb8a0569bc6ae1f1512107a4d0aef2b7caa43fac8ef6d0f1c0cc1a101451430
    source_path: reference/session-management-compaction.md
    workflow: 15
 ---

-OpenClaw керує сеансами наскрізно в таких напрямах:
+OpenClaw керує сесіями наскрізно в таких ділянках:

- **Маршрутизація сеансів** (як вхідні повідомлення зіставляються з `sessionKey`)
- **Сховище сеансів** (`sessions.json`) і те, що воно відстежує
- **Збереження транскриптів** (`*.jsonl`) і їхня структура
- **Гігієна транскриптів** (виправлення, специфічні для провайдера, перед запусками)
+- **Маршрутизація сесій** (як вхідні повідомлення зіставляються з `sessionKey`)
+- **Сховище сесій** (`sessions.json`) і що саме воно відстежує
+- **Збереження транскриптів** (`*.jsonl`) та їхню структуру
+- **Гігієна транскриптів** (специфічні для провайдера виправлення перед запуском)
 - **Обмеження контексту** (вікно контексту проти відстежуваних токенів)
 - **Compaction** (ручний і автоматичний Compaction) та де підключати роботу перед Compaction
 - **Тихе службове обслуговування** (записи пам’яті, які не повинні створювати видимий для користувача вивід)

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

- [Керування сеансами](/uk/concepts/session)
+- [Керування сесіями](/uk/concepts/session)
 - [Compaction](/uk/concepts/compaction)
 - [Огляд пам’яті](/uk/concepts/memory)
 - [Пошук у пам’яті](/uk/concepts/memory-search)
- [Очищення сеансів](/uk/concepts/session-pruning)
+- [Обрізання сесій](/uk/concepts/session-pruning)
 - [Гігієна транскриптів](/uk/reference/transcript-hygiene)

 ---

 ## Джерело істини: Gateway

-OpenClaw спроєктовано навколо єдиного **процесу Gateway**, який володіє станом сеансу.
+OpenClaw спроєктовано навколо єдиного **процесу Gateway**, який володіє станом сесій.

- UI (macOS app, веб Control UI, TUI) мають звертатися до Gateway за списками сеансів і кількістю токенів.
- У віддаленому режимі файли сеансів розміщені на віддаленому хості; «перевірка локальних файлів на вашому Mac» не покаже того, що фактично використовує Gateway.
+- Інтерфейси (застосунок macOS, вебінтерфейс Control UI, TUI) повинні запитувати в Gateway списки сесій і кількість токенів.
+- У віддаленому режимі файли сесій розміщуються на віддаленому хості; «перевірка локальних файлів на Mac» не відображатиме те, що використовує Gateway.

 ---

 ## Два шари збереження

-OpenClaw зберігає сеанси у двох шарах:
+OpenClaw зберігає сесії у двох шарах:

-1. **Сховище сеансів (`sessions.json`)**
+1. **Сховище сесій (`sessions.json`)**
   - Мапа ключ/значення: `sessionKey -> SessionEntry`
-   - Маленьке, змінюване, безпечно редагується (або можна видаляти записи)
-   - Відстежує метадані сеансу (поточний ідентифікатор сеансу, останню активність, перемикачі, лічильники токенів тощо)
+   - Невелике, змінюване, безпечне для редагування (або видалення записів)
+   - Відстежує метадані сесії (поточний ідентифікатор сесії, останню активність, перемикачі, лічильники токенів тощо)

 2. **Транскрипт (`<sessionId>.jsonl`)**
   - Транскрипт лише з додаванням із деревоподібною структурою (записи мають `id` + `parentId`)
-   - Зберігає фактичну розмову + виклики інструментів + підсумки Compaction
+   - Зберігає фактичну розмову + виклики інструментів + зведення Compaction
   - Використовується для відновлення контексту моделі для майбутніх ходів
   - Великі контрольні точки налагодження до Compaction пропускаються, щойно активний
-     транскрипт перевищує обмеження розміру контрольної точки, що дозволяє уникнути другої гігантської
+     транскрипт перевищує ліміт розміру контрольної точки, що дозволяє уникнути другої гігантської
     копії `.checkpoint.*.jsonl`.

 ---

 ## Розташування на диску

-Для кожного агента, на хості Gateway:
+Для кожного агента на хості Gateway:

 - Сховище: `~/.openclaw/agents/<agentId>/sessions/sessions.json`
 - Транскрипти: `~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl`
-  - Сеанси тем Telegram: `.../<sessionId>-topic-<threadId>.jsonl`
+  - Сесії тем Telegram: `.../<sessionId>-topic-<threadId>.jsonl`

 OpenClaw визначає ці шляхи через `src/config/sessions.ts`.

@ -77,27 +77,27 @@ OpenClaw визначає ці шляхи через `src/config/sessions.ts`.

 ## Обслуговування сховища та контроль диска

-Збереження сеансів має автоматичні засоби обслуговування (`session.maintenance`) для `sessions.json` і артефактів транскриптів:
+Збереження сесій має автоматичні засоби обслуговування (`session.maintenance`) для `sessions.json`, артефактів транскриптів і супровідних файлів траєкторій:

- `mode`: `warn` (за замовчуванням) або `enforce`
- `pruneAfter`: поріг віку застарілих записів (за замовчуванням `30d`)
- `maxEntries`: обмеження кількості записів у `sessions.json` (за замовчуванням `500`)
- `rotateBytes`: ротація `sessions.json`, коли файл стає завеликим (за замовчуванням `10mb`)
- `resetArchiveRetention`: термін зберігання архівів транскриптів `*.reset.<timestamp>` (за замовчуванням: такий самий, як `pruneAfter`; `false` вимикає очищення)
- `maxDiskBytes`: необов’язковий бюджет каталогу сеансів
- `highWaterBytes`: необов’язкове цільове значення після очищення (за замовчуванням `80%` від `maxDiskBytes`)
+- `mode`: `warn` (типово) або `enforce`
+- `pruneAfter`: поріг віку застарілих записів для очищення (типово `30d`)
+- `maxEntries`: обмеження кількості записів у `sessions.json` (типово `500`)
+- `rotateBytes`: ротація `sessions.json`, коли файл перевищує розмір (типово `10mb`)
+- `resetArchiveRetention`: строк зберігання архівів транскриптів `*.reset.<timestamp>` (типово: такий самий, як `pruneAfter`; `false` вимикає очищення)
+- `maxDiskBytes`: необов’язковий бюджет каталогу сесій на диску
+- `highWaterBytes`: необов’язкова ціль після очищення (типово `80%` від `maxDiskBytes`)

-Звичайні записи Gateway пакетно очищають `maxEntries` для обмежень виробничого масштабу, тому сховище може тимчасово перевищувати налаштоване обмеження до наступного очищення за верхнім порогом, яке знову зменшить його до заданого рівня. `openclaw sessions cleanup --enforce` усе ще негайно застосовує налаштоване обмеження.
+Звичайні записи Gateway пакетно очищають `maxEntries` для лімітів виробничого масштабу, тож сховище може тимчасово перевищити налаштоване обмеження до наступного очищення за верхньою межею, яке знову зменшить його. `openclaw sessions cleanup --enforce` однак застосовує налаштований ліміт негайно.

-Порядок примусового очищення для бюджету диска (`mode: "enforce"`):
+Порядок примусового очищення бюджету диска (`mode: "enforce"`):

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

-У `mode: "warn"` OpenClaw повідомляє про потенційні витіснення, але не змінює сховище/файли.
+У режимі `mode: "warn"` OpenClaw повідомляє про можливі витіснення, але не змінює сховище/файли.

-Запуск обслуговування на вимогу:
+Запускайте обслуговування за потреби:

 ```bash
 openclaw sessions cleanup --dry-run
@ -106,85 +106,85 @@ openclaw sessions cleanup --enforce

 ---

-## Cron-сеанси та журнали запусків
+## Cron-сесії та журнали запусків

-Ізольовані запуски cron також створюють записи/транскрипти сеансів, і для них є окремі механізми зберігання:
+Ізольовані запуски Cron теж створюють записи сесій/транскрипти й мають окремі параметри зберігання:

- `cron.sessionRetention` (за замовчуванням `24h`) очищає старі ізольовані сеанси запусків cron зі сховища сеансів (`false` вимикає це).
- `cron.runLog.maxBytes` + `cron.runLog.keepLines` очищають файли `~/.openclaw/cron/runs/<jobId>.jsonl` (за замовчуванням: `2_000_000` байтів і `2000` рядків).
+- `cron.sessionRetention` (типово `24h`) очищає старі ізольовані сесії запусків Cron зі сховища сесій (`false` вимикає це).
+- `cron.runLog.maxBytes` + `cron.runLog.keepLines` очищають файли `~/.openclaw/cron/runs/<jobId>.jsonl` (типові значення: `2_000_000` байтів і `2000` рядків).

-Коли cron примусово створює новий ізольований сеанс запуску, він санітизує попередній
-запис сеансу `cron:<jobId>` перед записом нового рядка. Він переносить безпечні
-налаштування, як-от параметри thinking/fast/verbose, мітки та явні
-перевизначення моделі/auth, вибрані користувачем. Він відкидає навколишній контекст розмови,
-такий як маршрутизація channel/group, політика надсилання чи черги, підвищення привілеїв, походження та прив’язка runtime ACP,
-щоб новий ізольований запуск не міг успадкувати застарілу доставку або
-повноваження runtime від старішого запуску.
+Коли Cron примусово створює нову ізольовану сесію запуску, він санітизує попередній
+запис сесії `cron:<jobId>` перед записом нового рядка. Він переносить безпечні
+налаштування, такі як параметри thinking/fast/verbose, мітки та явні
+вибрані користувачем перевизначення моделі/автентифікації. Він відкидає фоновий
+контекст розмови, такий як маршрутизація каналу/групи, політика надсилання або черги,
+підвищення привілеїв, походження та прив’язка середовища виконання ACP, щоб новий
+ізольований запуск не міг успадкувати застарілу доставку або повноваження
+середовища виконання від старішого запуску.

 ---

-## Ключі сеансів (`sessionKey`)
+## Ключі сесій (`sessionKey`)

 `sessionKey` визначає, _у якому кошику розмови_ ви перебуваєте (маршрутизація + ізоляція).

-Типові шаблони:
+Поширені шаблони:

- Основний/прямий чат (для агента): `agent:<agentId>:<mainKey>` (за замовчуванням `main`)
+- Основний/прямий чат (для кожного агента): `agent:<agentId>:<mainKey>` (типово `main`)
 - Група: `agent:<agentId>:<channel>:group:<id>`
 - Кімната/канал (Discord/Slack): `agent:<agentId>:<channel>:channel:<id>` або `...:room:<id>`
 - Cron: `cron:<job.id>`
 - Webhook: `hook:<uuid>` (якщо не перевизначено)

-Канонічні правила описано в [/concepts/session](/uk/concepts/session).
+Канонічні правила задокументовано тут: [/concepts/session](/uk/concepts/session).

 ---

-## Ідентифікатори сеансів (`sessionId`)
+## Ідентифікатори сесій (`sessionId`)

 Кожен `sessionKey` вказує на поточний `sessionId` (файл транскрипту, що продовжує розмову).

-Основні правила:
+Практичні правила:

 - **Скидання** (`/new`, `/reset`) створює новий `sessionId` для цього `sessionKey`.
- **Щоденне скидання** (за замовчуванням о 4:00 за місцевим часом хоста gateway) створює новий `sessionId` під час наступного повідомлення після межі скидання.
- **Завершення через бездіяльність** (`session.reset.idleMinutes` або застарілий `session.idleMinutes`) створює новий `sessionId`, коли повідомлення надходить після вікна бездіяльності. Коли налаштовано і щоденне скидання, і завершення через бездіяльність, спрацьовує те, що завершується раніше.
- **Системні події** (Heartbeat, cron wakeups, сповіщення exec, службовий облік gateway) можуть змінювати рядок сеансу, але не подовжують свіжість щоденного скидання/скидання через бездіяльність. Під час переходу на новий сеанс через скидання queued-сповіщення системних подій для попереднього сеансу відкидаються до побудови нового запиту.
- **Захист від fork батьківського потоку** (`session.parentForkMaxTokens`, за замовчуванням `100000`) пропускає fork батьківського транскрипту, якщо батьківський сеанс уже надто великий; новий потік починається з нуля. Установіть `0`, щоб вимкнути.
+- **Щоденне скидання** (типово о 4:00 ранку за локальним часом хоста gateway) створює новий `sessionId` при наступному повідомленні після межі скидання.
+- **Завершення через неактивність** (`session.reset.idleMinutes` або застарілий `session.idleMinutes`) створює новий `sessionId`, коли повідомлення надходить після вікна неактивності. Якщо налаштовані і щоденне скидання, і неактивність, спрацьовує те, що настане раніше.
+- **Системні події** (Heartbeat, пробудження Cron, сповіщення exec, службове обслуговування gateway) можуть змінювати рядок сесії, але не подовжують актуальність щоденного скидання/скидання через неактивність. Під час переходу через скидання відкладені сповіщення системних подій для попередньої сесії відкидаються до побудови нового запиту.
+- **Захист від відгалуження батьківського ланцюжка** (`session.parentForkMaxTokens`, типово `100000`) пропускає відгалуження батьківського транскрипту, якщо батьківська сесія вже надто велика; новий потік починається заново. Установіть `0`, щоб вимкнути.

-Деталь реалізації: рішення приймається в `initSessionState()` у `src/auto-reply/reply/session.ts`.
+Деталь реалізації: рішення ухвалюється в `initSessionState()` у `src/auto-reply/reply/session.ts`.

 ---

-## Схема сховища сеансів (`sessions.json`)
+## Схема сховища сесій (`sessions.json`)

 Тип значення сховища — `SessionEntry` у `src/config/sessions.ts`.

-Ключові поля (неповний перелік):
+Ключові поля (не вичерпно):

 - `sessionId`: поточний ідентифікатор транскрипту (ім’я файлу виводиться з нього, якщо не задано `sessionFile`)
- `sessionStartedAt`: час початку поточного `sessionId`; саме він визначає
-  свіжість щоденного скидання. Для застарілих рядків може виводитися із заголовка сеансу JSONL.
- `lastInteractionAt`: час останньої реальної взаємодії користувача/каналу; саме він визначає
-  свіжість скидання через бездіяльність, тому Heartbeat, cron і події exec не підтримують сеанси
-  активними. Для застарілих рядків без цього поля як свіжість для бездіяльності використовується
-  відновлений час початку сеансу.
- `updatedAt`: час останньої зміни рядка сховища, використовується для списків, очищення та
-  службового обліку. Це не авторитетне поле для свіжості щоденного скидання/скидання через бездіяльність.
- `sessionFile`: необов’язкове явне перевизначення шляху транскрипту
- `chatType`: `direct | group | room` (допомагає UI та політиці надсилання)
- `provider`, `subject`, `room`, `space`, `displayName`: метадані для міток груп/каналів
+- `sessionStartedAt`: позначка часу початку для поточного `sessionId`; саме її використовує актуальність щоденного скидання.
+  У застарілих рядках вона може виводитися із заголовка сесії в JSONL.
+- `lastInteractionAt`: позначка часу останньої реальної взаємодії користувача/каналу; саме її використовує актуальність
+  скидання через неактивність, тому події heartbeat, cron і exec не підтримують життя сесії.
+  Для застарілих рядків без цього поля використовується відновлений час початку сесії.
+- `updatedAt`: позначка часу останньої зміни рядка сховища, яка використовується для виведення списків, очищення та
+  службового обліку. Це не авторитетне поле для актуальності щоденного скидання/скидання через неактивність.
+- `sessionFile`: необов’язкове явне перевизначення шляху до транскрипту
+- `chatType`: `direct | group | room` (допомагає інтерфейсам і політиці надсилання)
+- `provider`, `subject`, `room`, `space`, `displayName`: метадані для позначення груп/каналів
 - Перемикачі:
  - `thinkingLevel`, `verboseLevel`, `reasoningLevel`, `elevatedLevel`
-  - `sendPolicy` (перевизначення для конкретного сеансу)
+  - `sendPolicy` (перевизначення для конкретної сесії)
 - Вибір моделі:
  - `providerOverride`, `modelOverride`, `authProfileOverride`
 - Лічильники токенів (best-effort / залежать від провайдера):
  - `inputTokens`, `outputTokens`, `totalTokens`, `contextTokens`
- `compactionCount`: скільки разів авто-Compaction завершувався для цього ключа сеансу
- `memoryFlushAt`: час останнього скидання пам’яті перед Compaction
- `memoryFlushCompactionCount`: кількість Compaction на момент останнього скидання
+- `compactionCount`: скільки разів авто-Compaction завершувався для цього ключа сесії
+- `memoryFlushAt`: позначка часу останнього скидання пам’яті перед Compaction
+- `memoryFlushCompactionCount`: лічильник Compaction на момент останнього скидання

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

 ---

@ -194,16 +194,16 @@ openclaw sessions cleanup --enforce

 Файл має формат JSONL:

- Перший рядок: заголовок сеансу (`type: "session"`, містить `id`, `cwd`, `timestamp`, необов’язково `parentSession`)
- Далі: записи сеансу з `id` + `parentId` (дерево)
+- Перший рядок: заголовок сесії (`type: "session"`, містить `id`, `cwd`, `timestamp`, необов’язковий `parentSession`)
+- Далі: записи сесії з `id` + `parentId` (дерево)

 Помітні типи записів:

 - `message`: повідомлення user/assistant/toolResult
- `custom_message`: повідомлення, інжектовані розширенням, які _входять_ в контекст моделі (можуть бути приховані від UI)
- `custom`: стан розширення, який _не_ входить в контекст моделі
- `compaction`: збережений підсумок Compaction із `firstKeptEntryId` і `tokensBefore`
- `branch_summary`: збережений підсумок під час навігації гілкою дерева
+- `custom_message`: повідомлення, вставлені розширенням, які _потрапляють_ у контекст моделі (можуть бути приховані від інтерфейсу)
+- `custom`: стан розширення, який _не потрапляє_ у контекст моделі
+- `compaction`: збережене зведення Compaction з `firstKeptEntryId` і `tokensBefore`
+- `branch_summary`: збережене зведення під час навігації гілкою дерева

 OpenClaw навмисно **не** «виправляє» транскрипти; Gateway використовує `SessionManager` для їх читання/запису.

@ -211,45 +211,46 @@ OpenClaw навмисно **не** «виправляє» транскрипти

 ## Вікна контексту проти відстежуваних токенів

-Важливі два різні поняття:
+Важливі дві різні концепції:

-1. **Вікно контексту моделі**: жорстке обмеження для кожної моделі (токени, видимі моделі)
-2. **Лічильники сховища сеансів**: ковзні статистики, записані в `sessions.json` (використовуються для /status і панелей керування)
+1. **Вікно контексту моделі**: жорстке обмеження для моделі (токени, видимі моделі)
+2. **Лічильники сховища сесій**: ковзна статистика, записувана в `sessions.json` (використовується для /status і панелей)

-Якщо ви налаштовуєте обмеження:
+Якщо ви налаштовуєте ліміти:

 - Вікно контексту береться з каталогу моделей (і може бути перевизначене через конфігурацію).
- `contextTokens` у сховищі — це оцінка/значення звітності під час runtime; не вважайте його суворою гарантією.
+- `contextTokens` у сховищі — це оцінка/звітне значення під час виконання; не сприймайте його як сувору гарантію.

-Докладніше: [/token-use](/uk/reference/token-use).
+Докладніше див. [/token-use](/uk/reference/token-use).

 ---

 ## Compaction: що це таке

-Compaction підсумовує старішу частину розмови в збережений запис `compaction` у транскрипті та зберігає недавні повідомлення без змін.
+Compaction підсумовує старішу частину розмови у збережений запис `compaction` у транскрипті та залишає недоторканими недавні повідомлення.

 Після Compaction майбутні ходи бачать:

- Підсумок Compaction
+- Зведення Compaction
 - Повідомлення після `firstKeptEntryId`

-Compaction є **постійним** (на відміну від очищення сеансу). Див. [/concepts/session-pruning](/uk/concepts/session-pruning).
+Compaction є **постійним** (на відміну від обрізання сесій). Див. [/concepts/session-pruning](/uk/concepts/session-pruning).

-## Межі фрагментів Compaction і парування інструментів
+## Межі блоків Compaction і парування інструментів

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

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

 ---

-## Коли відбувається авто-Compaction (Pi runtime)
+## Коли відбувається авто-Compaction (середовище виконання Pi)

 У вбудованому агенті Pi авто-Compaction спрацьовує у двох випадках:

@ -257,7 +258,7 @@ Compaction є **постійним** (на відміну від очищенн
   (`request_too_large`, `context length exceeded`, `input exceeds the maximum
 number of tokens`, `input token count exceeds the maximum number of input
 tokens`, `input is too long for the model`, `ollama error: context length
-exceeded` та схожі варіанти, сформовані провайдером) → виконати Compaction → повторити спробу.
+exceeded` та подібні варіанти, сформовані провайдером) → compact → повторити спробу.
 2. **Порогове обслуговування**: після успішного ходу, коли:

 `contextTokens > contextWindow - reserveTokens`
@ -265,22 +266,22 @@ exceeded` та схожі варіанти, сформовані провайд
 Де:

 - `contextWindow` — це вікно контексту моделі
- `reserveTokens` — це запас, зарезервований для запитів + наступного виводу моделі
+- `reserveTokens` — це запас токенів, зарезервований для запитів + наступного виводу моделі

-Це семантика runtime Pi (OpenClaw споживає події, але рішення про Compaction приймає Pi).
+Це семантика середовища виконання Pi (OpenClaw споживає події, але рішення про Compaction приймає Pi).

 OpenClaw також може запускати локальний попередній Compaction перед відкриттям наступного
-запуску, коли встановлено `agents.defaults.compaction.maxActiveTranscriptBytes` і
-активний файл транскрипту досягає цього розміру. Це захист за розміром файлу для локальної
-вартості повторного відкриття, а не сире архівування: OpenClaw усе одно виконує звичайний семантичний Compaction,
-і для цього потрібен `truncateAfterCompaction`, щоб стиснений підсумок міг стати
-новим наступним транскриптом.
+запуску, якщо задано `agents.defaults.compaction.maxActiveTranscriptBytes` і
+активний файл транскрипту досягає цього розміру. Це запобіжник розміру файлу для локальної
+вартості повторного відкриття, а не просто архівування: OpenClaw усе одно виконує звичайний
+семантичний Compaction, і для цього потрібен `truncateAfterCompaction`, щоб зведення після Compaction
+могло стати новим транскриптом-наступником.

 ---

 ## Налаштування Compaction (`reserveTokens`, `keepRecentTokens`)

-Налаштування Compaction у Pi знаходяться в налаштуваннях Pi:
+Налаштування Pi для Compaction розташовані в параметрах Pi:

 ```json5
 {
@ -295,24 +296,24 @@ OpenClaw також може запускати локальний попере
 OpenClaw також застосовує мінімальний безпечний поріг для вбудованих запусків:

 - Якщо `compaction.reserveTokens < reserveTokensFloor`, OpenClaw підвищує це значення.
- Мінімальний поріг за замовчуванням — `20000` токенів.
+- Типовий мінімальний поріг — `20000` токенів.
 - Установіть `agents.defaults.compaction.reserveTokensFloor: 0`, щоб вимкнути цей поріг.
- Якщо значення вже вище, OpenClaw не змінює його.
- Ручний `/compact` враховує явне `agents.defaults.compaction.keepRecentTokens`
-  і зберігає точку відсікання недавнього хвоста Pi. Без явного бюджету збереження
-  ручний Compaction залишається жорсткою контрольною точкою, а відновлений контекст починається
-  з нового підсумку.
- Установіть `agents.defaults.compaction.maxActiveTranscriptBytes` у байтове значення або
-  рядок на кшталт `"20mb"`, щоб виконувати локальний Compaction перед ходом, коли активний
-  транскрипт стає великим. Цей захист активний лише тоді, коли
-  також увімкнено `truncateAfterCompaction`. Залиште значення не заданим або встановіть `0`,
-  щоб вимкнути.
+- Якщо значення вже вище, OpenClaw залишає його без змін.
+- Ручний `/compact` враховує явний `agents.defaults.compaction.keepRecentTokens`
+  і зберігає точку відсікання недавнього хвоста Pi. Без явного бюджету на збереження
+  ручний Compaction лишається жорсткою контрольною точкою, а відновлений контекст починається
+  з нового зведення.
+- Установіть `agents.defaults.compaction.maxActiveTranscriptBytes` у значення байтів або
+  рядок на кшталт `"20mb"`, щоб запускати локальний Compaction перед ходом, коли активний
+  транскрипт стає великим. Цей запобіжник активний лише тоді, коли
+  також увімкнено `truncateAfterCompaction`. Залиште значення не заданим або встановіть `0`, щоб
+  вимкнути.
 - Коли увімкнено `agents.defaults.compaction.truncateAfterCompaction`,
-  OpenClaw після Compaction переносить активний транскрипт до стисненого successor JSONL.
-  Старий повний транскрипт залишається в архіві й зв’язується з контрольної точки
-  Compaction замість переписування на місці.
+  OpenClaw після Compaction ротуватиме активний транскрипт у компактний JSONL-наступник.
+  Старий повний транскрипт залишиться заархівованим і буде зв’язаний із
+  контрольною точкою Compaction замість перезапису на місці.

-Чому: залишити достатній запас для багатокрокового «службового обслуговування» (наприклад, записів пам’яті) до того, як Compaction стане неминучим.
+Чому: щоб залишити достатній запас для багатокрокового «службового обслуговування» (наприклад, записів у пам’ять) до того, як Compaction стане неминучим.

 Реалізація: `ensurePiCompactionReserveTokens()` у `src/agents/pi-settings.ts`
 (викликається з `src/agents/pi-embedded-runner.ts`).
@ -321,101 +322,101 @@ OpenClaw також застосовує мінімальний безпечни

 ## Підключувані провайдери Compaction

-Plugin можуть реєструвати провайдера Compaction через `registerCompactionProvider()` в API plugin. Коли `agents.defaults.compaction.provider` встановлено в id зареєстрованого провайдера, захисне розширення делегує підсумовування цьому провайдеру замість вбудованого конвеєра `summarizeInStages`.
+Plugin можуть реєструвати провайдера Compaction через `registerCompactionProvider()` у API Plugin. Коли `agents.defaults.compaction.provider` встановлено в ідентифікатор зареєстрованого провайдера, розширення safeguard делегує підсумовування цьому провайдеру замість вбудованого конвеєра `summarizeInStages`.

- `provider`: id зареєстрованого plugin-провайдера Compaction. Залиште порожнім для типового підсумовування LLM.
- Установлення `provider` примусово вмикає `mode: "safeguard"`.
+- `provider`: ідентифікатор зареєстрованого Plugin-провайдера Compaction. Залиште не заданим для типового підсумовування LLM.
+- Встановлення `provider` примусово задає `mode: "safeguard"`.
 - Провайдери отримують ті самі інструкції Compaction і політику збереження ідентифікаторів, що й вбудований шлях.
- Захисний режим і далі зберігає контекст суфікса недавніх ходів і розділених ходів після виводу провайдера.
- Вбудоване підсумовування safeguard повторно дистилює попередні підсумки разом із новими повідомленнями
-  замість того, щоб дослівно зберігати весь попередній підсумок.
- Режим safeguard за замовчуванням вмикає аудити якості підсумків; установіть
-  `qualityGuard.enabled: false`, щоб пропустити поведінку повторної спроби за некоректного виводу.
- Якщо провайдер зазнає збою або повертає порожній результат, OpenClaw автоматично повертається до вбудованого підсумовування LLM.
- Сигнали abort/timeout повторно викидаються (не приглушуються), щоб поважати скасування викликальника.
+- Safeguard усе одно зберігає контекст суфікса недавніх ходів і розділених ходів після виводу провайдера.
+- Вбудоване підсумовування safeguard повторно дистилює попередні зведення разом із новими повідомленнями,
+  замість того щоб зберігати повне попереднє зведення дослівно.
+- Режим safeguard типово вмикає аудити якості зведення; установіть
+  `qualityGuard.enabled: false`, щоб пропустити логіку повторної спроби за неправильно сформованого виводу.
+- Якщо провайдер зазнає невдачі або повертає порожній результат, OpenClaw автоматично повертається до вбудованого підсумовування LLM.
+- Сигнали abort/timeout повторно викидаються як є (не поглинаються), щоб поважати скасування з боку викликача.

 Джерело: `src/plugins/compaction-provider.ts`, `src/agents/pi-hooks/compaction-safeguard.ts`.

 ---

-## Поверхні, видимі користувачеві
+## Видимі для користувача поверхні

-Спостерігати за Compaction і станом сеансу можна через:
+Ви можете спостерігати за Compaction і станом сесії через:

- `/status` (у будь-якому чат-сеансі)
+- `/status` (у будь-якій чат-сесії)
 - `openclaw status` (CLI)
 - `openclaw sessions` / `sessions --json`
- Докладний режим: `🧹 Auto-compaction complete` + лічильник Compaction
+- Докладний режим: `🧹 Auto-compaction complete` + кількість Compaction

 ---

 ## Тихе службове обслуговування (`NO_REPLY`)

-OpenClaw підтримує «тихі» ходи для фонових завдань, коли користувач не повинен бачити проміжний вивід.
+OpenClaw підтримує «тихі» ходи для фонових завдань, де користувач не повинен бачити проміжний вивід.

-Узгодження:
+Домовленість:

- Assistant починає свій вивід із точного тихого токена `NO_REPLY` /
-  `no_reply`, щоб позначити «не надсилати відповідь користувачеві».
- OpenClaw прибирає/приглушує це на рівні доставки.
- Приглушення точного тихого токена нечутливе до регістру, тому `NO_REPLY` і
-  `no_reply` зараховуються, коли все навантаження складається лише з тихого токена.
- Це лише для справжніх фонових ходів без доставки; це не скорочення для
+- Assistant починає свій вивід з точного тихого токена `NO_REPLY` /
+  `no_reply`, щоб позначити «не доставляти відповідь користувачу».
+- OpenClaw прибирає/пригнічує це на рівні доставки.
+- Пригнічення точного тихого токена є нечутливим до регістру, тож `NO_REPLY` і
+  `no_reply` обидва зараховуються, коли весь вміст складається лише з тихого токена.
+- Це призначено тільки для справжніх фонових ходів / ходів без доставки; це не скорочення для
  звичайних дієвих запитів користувача.

-Починаючи з `2026.1.10`, OpenClaw також приглушує **draft/typing streaming**, коли
-частковий фрагмент починається з `NO_REPLY`, щоб тихі операції не розкривали
-частковий вивід посеред ходу.
+Починаючи з `2026.1.10`, OpenClaw також пригнічує **потокове чернеткове введення/набирання**, коли
+частковий блок починається з `NO_REPLY`, щоб тихі операції не розкривали частковий
+вивід посеред ходу.

 ---

 ## «Скидання пам’яті» перед Compaction (реалізовано)

-Мета: до того, як відбудеться авто-Compaction, виконати тихий агентний хід, який запише сталий
+Мета: перед тим, як станеться авто-Compaction, виконати тихий агентний хід, який записує тривалий
 стан на диск (наприклад, `memory/YYYY-MM-DD.md` у робочому просторі агента), щоб Compaction не міг
 стерти критичний контекст.

-OpenClaw використовує підхід **скидання перед порогом**:
+OpenClaw використовує підхід **скидання до досягнення порога**:

-1. Відстежувати використання контексту сеансу.
-2. Коли воно перетинає «м’який поріг» (нижче за поріг Compaction у Pi), запустити тиху
-   директиву «запиши пам’ять зараз» для агента.
+1. Відстежувати використання контексту сесії.
+2. Коли воно перетинає «м’який поріг» (нижче за поріг Compaction у Pi), запускати тиху
+   інструкцію «запиши пам’ять зараз» для агента.
 3. Використовувати точний тихий токен `NO_REPLY` / `no_reply`, щоб користувач нічого
   не бачив.

 Конфігурація (`agents.defaults.compaction.memoryFlush`):

- `enabled` (за замовчуванням: `true`)
- `softThresholdTokens` (за замовчуванням: `4000`)
+- `enabled` (типово: `true`)
+- `softThresholdTokens` (типово: `4000`)
 - `prompt` (повідомлення користувача для ходу скидання)
 - `systemPrompt` (додатковий системний запит, доданий для ходу скидання)

 Примітки:

- Prompt/system prompt за замовчуванням містять підказку `NO_REPLY` для приглушення
+- Типовий prompt/systemPrompt містить підказку `NO_REPLY` для пригнічення
  доставки.
 - Скидання виконується один раз за цикл Compaction (відстежується в `sessions.json`).
- Скидання виконується лише для вбудованих сеансів Pi (backend CLI його пропускають).
- Скидання пропускається, коли робочий простір сеансу доступний лише для читання (`workspaceAccess: "ro"` або `"none"`).
- Опис розмітки файлів робочого простору та шаблонів запису див. у [Пам’ять](/uk/concepts/memory).
+- Скидання виконується лише для вбудованих Pi-сесій (бекенди CLI його пропускають).
+- Скидання пропускається, коли робочий простір сесії доступний лише для читання (`workspaceAccess: "ro"` або `"none"`).
+- Див. [Пам’ять](/uk/concepts/memory), щоб ознайомитися зі структурою файлів робочого простору та шаблонами запису.

-Pi також надає hook `session_before_compact` в API розширення, але логіка
-скидання в OpenClaw сьогодні розміщена на боці Gateway.
+Pi також надає хук `session_before_compact` в API розширень, але логіка
+скидання OpenClaw сьогодні розміщена на боці Gateway.

 ---

-## Контрольний список усунення неполадок
+## Контрольний список усунення несправностей

- Неправильний ключ сеансу? Почніть із [/concepts/session](/uk/concepts/session) і підтвердьте `sessionKey` у `/status`.
+- Неправильний ключ сесії? Почніть із [/concepts/session](/uk/concepts/session) і підтвердьте `sessionKey` у `/status`.
 - Невідповідність між сховищем і транскриптом? Підтвердьте хост Gateway і шлях до сховища з `openclaw status`.
 - Надто частий Compaction? Перевірте:
  - вікно контексту моделі (занадто мале)
-  - налаштування Compaction (`reserveTokens` занадто велике для вікна моделі може викликати раніший Compaction)
-  - роздування `toolResult`: увімкніть/налаштуйте очищення сеансу
- Витік тихих ходів? Переконайтеся, що відповідь починається з `NO_REPLY` (точний токен без урахування регістру) і що ви використовуєте збірку, яка містить виправлення приглушення streaming.
+  - налаштування Compaction (`reserveTokens`, завелике для вікна моделі, може спричиняти раніший Compaction)
+  - роздуття `toolResult`: увімкніть/налаштуйте обрізання сесій
+- Тихі ходи просочуються? Переконайтеся, що відповідь починається з `NO_REPLY` (точний токен без урахування регістру) і що ви використовуєте збірку, яка містить виправлення пригнічення потокового виводу.

 ## Пов’язане

- [Керування сеансами](/uk/concepts/session)
- [Очищення сеансів](/uk/concepts/session-pruning)
+- [Керування сесіями](/uk/concepts/session)
+- [Обрізання сесій](/uk/concepts/session-pruning)
 - [Рушій контексту](/uk/concepts/context-engine)
--- a/docs/uk/tools/trajectory.md
+++ b/docs/uk/tools/trajectory.md
@ -1,35 +1,33 @@
 ---
 read_when:
-    - Налагодження того, чому агент відповів, завершився помилкою або викликав інструменти певним чином
-    - Експортування support-бандла для сесії OpenClaw
-    - Дослідження контексту prompt-ів, викликів інструментів, помилок runtime або метаданих використання
-    - Вимкнення або перенесення запису trajectory
-summary: Експорт скорочених trajectory-бандлів для налагодження сесії агента OpenClaw
-title: Trajectory-бандли
+    - Налагодження причин, чому агент відповів, зазнав збою або викликав інструменти певним чином
+    - Експорт пакета підтримки для сеансу OpenClaw
+    - Розслідування контексту підказки, викликів інструментів, помилок середовища виконання або метаданих використання
+    - Вимкнення або перенесення захоплення траєкторій
+summary: Експортуйте відредаговані пакети траєкторій для налагодження сеансу агента OpenClaw
+title: Пакети траєкторій
 x-i18n:
-    generated_at: "2026-04-23T23:09:01Z"
+    generated_at: "2026-04-27T20:09:05Z"
    model: gpt-5.4
    provider: openai
-    source_hash: be799691e0c3375efd24e3bec9ce8f9ab22f01a0f8a9ce4288b7e6e952c29da4
+    source_hash: bca4fa444ad84b59c7508767ec1b950fdde073c0b83771c9d63e3e71c239840d
    source_path: tools/trajectory.md
    workflow: 15
 ---

-Запис trajectory — це вбудований у OpenClaw “чорний ящик” для кожної сесії. Він записує
-структуровану часову шкалу для кожного запуску агента, а потім `/export-trajectory` пакує
-поточну сесію в скорочений support-бандл.
+Захоплення траєкторій — це помодульний бортовий самописець OpenClaw для кожного сеансу. Воно записує структуровану часову шкалу для кожного запуску агента, а потім `/export-trajectory` пакує поточний сеанс у відредагований пакет підтримки.

-Використовуйте це, коли вам потрібно відповісти на запитання на кшталт:
+Використовуйте це, коли потрібно відповісти на такі запитання:

- Які prompt, system prompt та інструменти були надіслані моделі?
- Які повідомлення транскрипту й виклики інструментів привели до цієї відповіді?
- Чи запуск завершився timeout, abort, Compaction або помилкою провайдера?
- Які модель, Plugin-и, Skills і налаштування runtime були активними?
- Які метадані usage і prompt-cache повернув провайдер?
+- Які prompt, системний prompt та інструменти були надіслані моделі?
+- Які повідомлення транскрипту та виклики інструментів привели до цієї відповіді?
+- Чи завершився запуск через тайм-аут, переривання, Compaction або помилку провайдера?
+- Які модель, plugins, Skills і налаштування середовища виконання були активні?
+- Які метадані використання та кешу prompt повернув провайдер?

 ## Швидкий старт

-Надішліть це в активній сесії:
+Надішліть це в активному сеансі:

 ```text
 /export-trajectory
@ -41,7 +39,7 @@ x-i18n:
 /trajectory
 ```

-OpenClaw записує бандл у робочий простір:
+OpenClaw записує пакет у робочу область:

 ```text
 .openclaw/trajectory-exports/openclaw-trajectory-<session>-<timestamp>/
@ -53,19 +51,17 @@ OpenClaw записує бандл у робочий простір:
 /export-trajectory bug-1234
 ```

-Користувацький шлях визначається всередині `.openclaw/trajectory-exports/`. Абсолютні
-шляхи й шляхи з `~` відхиляються.
+Користувацький шлях буде визначено всередині `.openclaw/trajectory-exports/`. Абсолютні шляхи та шляхи з `~` відхиляються.

 ## Доступ

-Експорт trajectory — це команда власника. Відправник має пройти звичайні перевірки
-авторизації команд і перевірки власника для каналу.
+Експорт траєкторії — це команда власника. Відправник має пройти звичайні перевірки авторизації команд і перевірки власника для каналу.

 ## Що записується

-Запис trajectory типово увімкнений для запусків агента OpenClaw.
+Захоплення траєкторій увімкнене за замовчуванням для запусків агентів OpenClaw.

-Події runtime включають:
+Події середовища виконання включають:

 - `session.started`
 - `trace.metadata`
@ -75,17 +71,17 @@ OpenClaw записує бандл у робочий простір:
 - `trace.artifacts`
 - `session.ended`

-Події транскрипту також відновлюються з активної гілки сесії:
+Події транскрипту також відтворюються з активної гілки сеансу:

 - повідомлення користувача
 - повідомлення помічника
 - виклики інструментів
 - результати інструментів
- Compaction
+- compactions
 - зміни моделі
- мітки й користувацькі записи сесії
+- мітки та користувацькі записи сеансу

-Події записуються як JSON Lines з таким маркером schema:
+Події записуються у форматі JSON Lines з таким маркером схеми:

 ```json
 {
@ -94,101 +90,96 @@ OpenClaw записує бандл у робочий простір:
 }
 ```

-## Файли бандла
+## Файли пакета

-Експортований бандл може містити:
+Експортований пакет може містити:

 | Файл                  | Вміст                                                                                           |
-| --------------------- | ----------------------------------------------------------------------------------------------- |
-| `manifest.json`       | Схема бандла, вихідні файли, кількість подій і список згенерованих файлів                       |
-| `events.jsonl`        | Упорядкована часова шкала runtime і транскрипту                                                 |
-| `session-branch.json` | Скорочена активна гілка транскрипту і заголовок сесії                                           |
-| `metadata.json`       | Версія OpenClaw, OS/runtime, модель, знімок config, Plugin-и, Skills і метадані prompt-ів       |
-| `artifacts.json`      | Фінальний статус, помилки, usage, prompt cache, кількість Compaction, текст помічника і метадані інструментів |
-| `prompts.json`        | Надіслані prompt-и й вибрані подробиці побудови prompt-ів                                       |
-| `system-prompt.txt`   | Останній скомпільований system prompt, якщо його було записано                                  |
-| `tools.json`          | Визначення інструментів, надісланих моделі, якщо їх було записано                               |
+| --------------------- | ------------------------------------------------------------------------------------------------ |
+| `manifest.json`       | Схема пакета, вихідні файли, кількість подій і список згенерованих файлів                        |
+| `events.jsonl`        | Упорядкована часова шкала середовища виконання і транскрипту                                     |
+| `session-branch.json` | Відредагована активна гілка транскрипту та заголовок сеансу                                      |
+| `metadata.json`       | Версія OpenClaw, ОС/середовище виконання, модель, знімок конфігурації, plugins, Skills і метадані prompt |
+| `artifacts.json`      | Підсумковий статус, помилки, використання, кеш prompt, кількість Compaction, текст помічника та метадані інструментів |
+| `prompts.json`        | Надіслані prompts і вибрані деталі побудови prompt                                               |
+| `system-prompt.txt`   | Останній скомпільований системний prompt, якщо його було захоплено                               |
+| `tools.json`          | Визначення інструментів, надіслані моделі, якщо їх було захоплено                                |

-`manifest.json` перелічує файли, наявні в цьому бандлі. Деякі файли пропускаються,
-якщо сесія не записала відповідні runtime-дані.
+`manifest.json` перелічує файли, наявні в цьому пакеті. Деякі файли пропускаються, якщо сеанс не захопив відповідні дані середовища виконання.

-## Місце запису
+## Розташування захоплення

-Типово runtime-події trajectory записуються поруч із файлом сесії:
+За замовчуванням події траєкторії середовища виконання записуються поруч із файлом сеансу:

 ```text
 <session>.trajectory.jsonl
 ```

-OpenClaw також записує файл-вказівник best-effort поруч із сесією:
+OpenClaw також записує файл-вказівник за принципом best-effort поруч із сеансом:

 ```text
 <session>.trajectory-path.json
 ```

-Задайте `OPENCLAW_TRAJECTORY_DIR`, щоб зберігати runtime-sidecar-и trajectory в
-окремому каталозі:
+Установіть `OPENCLAW_TRAJECTORY_DIR`, щоб зберігати побічні файли траєкторії середовища виконання в окремому каталозі:

 ```bash
 export OPENCLAW_TRAJECTORY_DIR=/var/lib/openclaw/trajectories
 ```

-Коли цю змінну задано, OpenClaw записує в цей каталог один JSONL-файл на id сесії.
+Коли цю змінну встановлено, OpenClaw записує в цьому каталозі один JSONL-файл на кожен id сеансу.

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

-Задайте `OPENCLAW_TRAJECTORY=0` перед запуском OpenClaw:
+## Вимкнення захоплення
+
+Установіть `OPENCLAW_TRAJECTORY=0` перед запуском OpenClaw:

 ```bash
 export OPENCLAW_TRAJECTORY=0
 ```

-Це вимикає запис trajectory runtime. `/export-trajectory` все ще може експортувати
-гілку транскрипту, але файли лише runtime, як-от скомпільований контекст,
-артефакти провайдера й метадані prompt-ів, можуть бути відсутні.
+Це вимикає захоплення траєкторій середовища виконання. `/export-trajectory` усе ще може експортувати гілку транскрипту, але файли лише середовища виконання, як-от скомпільований контекст, артефакти провайдера та метадані prompt, можуть бути відсутні.

 ## Конфіденційність і обмеження

-Trajectory-бандли призначені для підтримки й налагодження, а не для публічного розміщення.
-OpenClaw скорочує чутливі значення перед записом файлів експорту:
+Пакети траєкторій призначені для підтримки та налагодження, а не для публічного розміщення. OpenClaw редагує чутливі значення перед записом файлів експорту:

- облікові дані та відомі поля payload, схожі на секрети
+- облікові дані та відомі поля корисного навантаження, схожі на секрети
 - дані зображень
- шляхи локального стану
- шляхи робочого простору, замінені на `$WORKSPACE_DIR`
- шляхи домашнього каталогу, де їх виявлено
+- шляхи до локального стану
+- шляхи робочої області, замінені на `$WORKSPACE_DIR`
+- шляхи до домашнього каталогу, де їх виявлено

 Експортер також обмежує розмір вхідних даних:

- runtime-sidecar файли: 50 MiB
- файли сесій: 50 MiB
- runtime-події: 200,000
+- побічні файли середовища виконання: 50 MiB
+- файли сеансів: 50 MiB
+- події середовища виконання: 200,000
 - загальна кількість експортованих подій: 250,000
- окремі рядки runtime-подій обрізаються при перевищенні 256 KiB
+- окремі рядки подій середовища виконання обрізаються понад 256 KiB

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

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

-Якщо в експорті немає runtime-подій:
+Якщо в експорті немає подій середовища виконання:

 - переконайтеся, що OpenClaw було запущено без `OPENCLAW_TRAJECTORY=0`
- перевірте, чи вказує `OPENCLAW_TRAJECTORY_DIR` на каталог, доступний для запису
- надішліть ще одне повідомлення в сесії, а потім експортуйте ще раз
- перегляньте `manifest.json` на предмет `runtimeEventCount`
+- перевірте, чи `OPENCLAW_TRAJECTORY_DIR` вказує на каталог, доступний для запису
+- надішліть ще одне повідомлення в сеансі, а потім експортуйте знову
+- перевірте `manifest.json` на наявність `runtimeEventCount`

-Якщо команда відхиляє шлях виводу:
+Якщо команда відхиляє вихідний шлях:

- використовуйте відносну назву, як-от `bug-1234`
+- використовуйте відносну назву на кшталт `bug-1234`
 - не передавайте `/tmp/...` або `~/...`
 - зберігайте експорт усередині `.openclaw/trajectory-exports/`

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

 ## Пов’язане

- [Diff-и](/uk/tools/diffs)
- [Керування сесіями](/uk/concepts/session)
+- [Diffs](/uk/tools/diffs)
+- [Керування сеансами](/uk/concepts/session)
 - [Інструмент Exec](/uk/tools/exec)