chore(i18n): refresh uk translations

2026-04-25 01:03:10 +00:00 · 2026-04-25 01:03:10 +00:00 · 5726aeac2a
commit 5726aeac2a
parent 34bbf355c8
2 changed files with 48 additions and 46 deletions
--- a/docs/uk/cli/doctor.md
+++ b/docs/uk/cli/doctor.md
@ -1,23 +1,23 @@
 ---
 read_when:
-    - У вас є проблеми з підключенням/автентифікацією, і ви хочете покрокові виправлення
-    - Ви оновилися й хочете базову перевірку справності
-summary: Довідка CLI для `openclaw doctor` (перевірки стану + покрокові виправлення)
-title: Doctor
+    - У вас є проблеми з підключенням/автентифікацією, і ви хочете отримати покрокові виправлення
+    - Ви оновилися і хочете виконати базову перевірку працездатності
+summary: Довідка CLI для `openclaw doctor` (перевірки працездатності + покрокові виправлення)
+title: Лікар##
 x-i18n:
-    generated_at: "2026-04-24T04:12:27Z"
+    generated_at: "2026-04-25T01:02:43Z"
    model: gpt-5.4
    provider: openai
-    source_hash: c5ea3f4992effe3d417f20427b3bdb9e47712816106b03bc27a415571cf88a7c
+    source_hash: 18e185d17d91d1677d0b16152d022b633d012d22d484bd9961820b200d5c4ce5
    source_path: cli/doctor.md
    workflow: 15
 ---

 # `openclaw doctor`

-Перевірки стану + швидкі виправлення для gateway і каналів.
+Перевірки працездатності + швидкі виправлення для Gateway і каналів.

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

 - Усунення несправностей: [Усунення несправностей](/uk/gateway/troubleshooting)
 - Аудит безпеки: [Безпека](/uk/gateway/security)
@ -38,30 +38,30 @@ openclaw doctor --generate-gateway-token
 - `--yes`: приймати типові значення без запитів
 - `--repair`: застосувати рекомендовані виправлення без запитів
 - `--fix`: псевдонім для `--repair`
- `--force`: застосувати агресивні виправлення, зокрема перезаписати власну конфігурацію сервісу за потреби
+- `--force`: застосувати агресивні виправлення, зокрема перезаписати користувацьку конфігурацію сервісу за потреби
 - `--non-interactive`: запуск без запитів; лише безпечні міграції
- `--generate-gateway-token`: згенерувати й налаштувати токен gateway
- `--deep`: сканувати системні сервіси на наявність додаткових установок gateway
+- `--generate-gateway-token`: згенерувати й налаштувати токен Gateway
+- `--deep`: сканувати системні сервіси на наявність додаткових встановлень Gateway

 Примітки:

- Інтерактивні запити (як-от виправлення keychain/OAuth) виконуються лише тоді, коли stdin є TTY і **не** встановлено `--non-interactive`. У безголових запусках (Cron, Telegram, без термінала) запити буде пропущено.
- Продуктивність: неінтерактивні запуски `doctor` пропускають завчасне завантаження Plugin, щоб безголові перевірки стану залишалися швидкими. Інтерактивні сесії, як і раніше, повністю завантажують Plugin, коли перевірці потрібен їхній внесок.
- `--fix` (псевдонім для `--repair`) записує резервну копію в `~/.openclaw/openclaw.json.bak` і видаляє невідомі ключі конфігурації, перелічуючи кожне видалення.
- Перевірки цілісності стану тепер виявляють осиротілі файли транскриптів у каталозі сесій і можуть архівувати їх як `.deleted.<timestamp>`, щоб безпечно звільнити місце.
+- Інтерактивні запити (наприклад, виправлення keychain/OAuth) запускаються лише тоді, коли stdin є TTY і `--non-interactive` **не** встановлено. Безголові запуски (Cron, Telegram, без термінала) пропускатимуть запити.
+- Продуктивність: неінтерактивні запуски `doctor` пропускають завчасне завантаження Plugin, щоб безголові перевірки працездатності залишалися швидкими. Інтерактивні сеанси, як і раніше, повністю завантажують Plugin, коли перевірці потрібен їхній внесок.
+- `--fix` (псевдонім для `--repair`) записує резервну копію до `~/.openclaw/openclaw.json.bak` і видаляє невідомі ключі конфігурації, перелічуючи кожне видалення.
+- Перевірки цілісності стану тепер виявляють осиротілі файли транскриптів у каталозі сеансів і можуть архівувати їх як `.deleted.<timestamp>`, щоб безпечно звільнити місце.
 - Doctor також сканує `~/.openclaw/cron/jobs.json` (або `cron.store`) на наявність застарілих форм завдань Cron і може переписати їх на місці до того, як планувальнику доведеться автоматично нормалізувати їх під час виконання.
- Doctor виправляє відсутні залежності часу виконання для вбудованих Plugin без потреби в доступі на запис до встановленого пакета OpenClaw. Для npm-установок, що належать root, або жорстко налаштованих модулів systemd встановіть `OPENCLAW_PLUGIN_STAGE_DIR` у каталог із доступом на запис, наприклад `/var/lib/openclaw/plugin-runtime-deps`.
- Doctor автоматично мігрує застарілу пласку конфігурацію Talk (`talk.voiceId`, `talk.modelId` та подібні) у `talk.provider` + `talk.providers.<provider>`.
- Повторні запуски `doctor --fix` більше не повідомляють/не застосовують нормалізацію Talk, якщо єдина відмінність — це порядок ключів об’єкта.
- Doctor містить перевірку готовності пошуку в пам’яті й може рекомендувати `openclaw configure --section model`, коли відсутні облікові дані embedding.
- Якщо режим sandbox увімкнено, але Docker недоступний, doctor повідомляє чітке попередження з виправленням (`install Docker` або `openclaw config set agents.defaults.sandbox.mode off`).
- Якщо `gateway.auth.token`/`gateway.auth.password` керуються через SecretRef і недоступні в поточному шляху команди, doctor повідомляє попередження лише для читання і не записує резервні відкриті облікові дані.
- Якщо перевірка SecretRef каналу завершується невдачею під час шляху виправлення, doctor продовжує роботу й повідомляє попередження замість передчасного завершення.
- Автоматичне визначення імен користувачів Telegram для `allowFrom` (`doctor --fix`) вимагає токена Telegram, який можна визначити в поточному шляху команди. Якщо перевірка токена недоступна, doctor повідомляє попередження і пропускає автоматичне визначення під час цього проходу.
+- Doctor відновлює відсутні runtime-залежності вбудованих Plugin, не записуючи їх у глобальні пакетні встановлення. Для npm-встановлень із root-власником або жорстко захищених модулів systemd встановіть `OPENCLAW_PLUGIN_STAGE_DIR` у каталог із правом запису, наприклад `/var/lib/openclaw/plugin-runtime-deps`.
+- Doctor автоматично мігрує застарілу пласку конфігурацію Talk (`talk.voiceId`, `talk.modelId` та подібні) до `talk.provider` + `talk.providers.<provider>`.
+- Повторні запуски `doctor --fix` більше не повідомляють і не застосовують нормалізацію Talk, якщо єдина відмінність — це порядок ключів об’єкта.
+- Doctor містить перевірку готовності пошуку в пам’яті й може рекомендувати `openclaw configure --section model`, якщо відсутні облікові дані для вбудовувань.
+- Якщо режим sandbox увімкнено, але Docker недоступний, doctor повідомляє виразне попередження з рекомендацією щодо усунення (`install Docker` або `openclaw config set agents.defaults.sandbox.mode off`).
+- Якщо `gateway.auth.token`/`gateway.auth.password` керуються через SecretRef і недоступні в поточному шляху виконання команди, doctor повідомляє попередження лише для читання й не записує відкриті резервні облікові дані.
+- Якщо перевірка SecretRef каналу завершується помилкою в шляху виправлення, doctor продовжує роботу й повідомляє попередження замість дострокового завершення.
+- Автоматичне визначення імен користувачів Telegram у `allowFrom` (`doctor --fix`) потребує токена Telegram, який можна визначити в поточному шляху виконання команди. Якщо перевірка токена недоступна, doctor повідомляє попередження і пропускає автоматичне визначення для цього запуску.

-## macOS: перевизначення середовища `launchctl`
+## macOS: перевизначення змінних середовища `launchctl`

-Якщо ви раніше виконували `launchctl setenv OPENCLAW_GATEWAY_TOKEN ...` (або `...PASSWORD`), це значення перевизначає ваш файл конфігурації та може спричиняти постійні помилки “unauthorized”.
+Якщо ви раніше виконували `launchctl setenv OPENCLAW_GATEWAY_TOKEN ...` (або `...PASSWORD`), це значення перевизначає ваш файл конфігурації та може спричиняти постійні помилки «неавторизовано».

 ```bash
 launchctl getenv OPENCLAW_GATEWAY_TOKEN
@ -71,7 +71,7 @@ launchctl unsetenv OPENCLAW_GATEWAY_TOKEN
 launchctl unsetenv OPENCLAW_GATEWAY_PASSWORD
 ```

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

 - [Довідка CLI](/uk/cli)
- [Doctor gateway](/uk/gateway/doctor)
+- [Doctor Gateway](/uk/gateway/doctor)
--- a/docs/uk/install/updating.md
+++ b/docs/uk/install/updating.md
@ -5,10 +5,10 @@ read_when:
 summary: Безпечне оновлення OpenClaw (глобальне встановлення або з вихідного коду), а також стратегія відкату
 title: Оновлення
 x-i18n:
-    generated_at: "2026-04-24T16:58:32Z"
+    generated_at: "2026-04-25T01:02:39Z"
    model: gpt-5.4
    provider: openai
-    source_hash: f57c5f4d4988eabb62a2c836c07f56e329149b1f9290baa0568ef1d86f66e0ad
+    source_hash: af88eaa285145dd5fc370b28c0f9d91069b815c75ec416df726cfce4271a6b54
    source_path: install/updating.md
    workflow: 15
 ---
@ -17,13 +17,13 @@ x-i18n:

 ## Рекомендовано: `openclaw update`

-Найшвидший спосіб оновлення. Він визначає ваш тип встановлення (npm або git), отримує останню версію, запускає `openclaw doctor` і перезапускає Gateway.
+Найшвидший спосіб оновлення. Команда визначає тип вашого встановлення (npm або git), отримує найновішу версію, запускає `openclaw doctor` і перезапускає Gateway.

 ```bash
 openclaw update
 ```

-Щоб перемкнути канали або вибрати конкретну версію:
+Щоб перемкнути канали або вказати конкретну версію:

 ```bash
 openclaw update --channel beta
@ -31,9 +31,9 @@ openclaw update --tag main
 openclaw update --dry-run   # попередній перегляд без застосування
 ```

-`--channel beta` надає перевагу beta, але середовище виконання повертається до stable/latest, якщо тег beta відсутній або старіший за останній стабільний реліз. Використовуйте `--tag beta`, якщо вам потрібен сирий npm dist-tag beta для разового оновлення пакета.
+`--channel beta` надає перевагу beta, але середовище виконання повертається до stable/latest, якщо тег beta відсутній або старіший за найновіший stable-реліз. Використовуйте `--tag beta`, якщо вам потрібен сирий npm dist-tag beta для одноразового оновлення пакета.

-Див. [Канали розробки](/uk/install/development-channels), щоб ознайомитися із семантикою каналів.
+Перегляньте [Канали розробки](/uk/install/development-channels), щоб дізнатися про семантику каналів.

 ## Альтернатива: повторно запустити інсталятор

@ -57,11 +57,13 @@ pnpm add -g openclaw@latest
 bun add -g openclaw@latest
 ```

-### Глобальні встановлення npm, що належать root
+### Глобальні встановлення npm і залежності середовища виконання

-У деяких конфігураціях npm на Linux глобальні пакети встановлюються в каталоги, що належать root, наприклад `/usr/lib/node_modules/openclaw`. OpenClaw підтримує таку схему: встановлений пакет розглядається як доступний лише для читання під час виконання, а залежності середовища виконання вбудованих Plugin розміщуються в доступному для запису каталозі середовища виконання замість зміни дерева пакета.
+OpenClaw розглядає упаковані глобальні встановлення як доступні лише для читання під час виконання, навіть якщо каталог глобального пакета доступний на запис для поточного користувача. Залежності середовища виконання для вбудованих Plugin розміщуються в каталозі середовища виконання з правом запису замість зміни дерева пакетів. Це запобігає конфлікту `openclaw update` із запущеним Gateway або локальним агентом, який відновлює залежності Plugin під час того самого встановлення.

-Для захищених systemd units задайте доступний для запису каталог staging, який включено до `ReadWritePaths`:
+У деяких конфігураціях Linux npm глобальні пакети встановлюються в каталоги, що належать root, наприклад `/usr/lib/node_modules/openclaw`. OpenClaw підтримує таку схему через той самий зовнішній шлях розміщення.
+
+Для захищених модулів systemd задайте каталог розміщення з правом запису, який включено до `ReadWritePaths`:

 ```ini
 Environment=OPENCLAW_PLUGIN_STAGE_DIR=/var/lib/openclaw/plugin-runtime-deps
@ -70,11 +72,11 @@ ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp

 Якщо `OPENCLAW_PLUGIN_STAGE_DIR` не задано, OpenClaw використовує `$STATE_DIRECTORY`, якщо його надає systemd, а потім повертається до `~/.openclaw/plugin-runtime-deps`.

-### Залежності середовища виконання вбудованих Plugin
+### Залежності середовища виконання для вбудованих Plugin

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

-Явне вимкнення має пріоритет. Для вимкненого Plugin або каналу залежності його середовища виконання не відновлюються лише через те, що він існує в пакеті. Зовнішні Plugin і користувацькі шляхи завантаження, як і раніше, використовують `openclaw plugins install` або `openclaw plugins update`.
+Явне вимкнення має пріоритет. Для вимкненого Plugin або каналу залежності середовища виконання не відновлюються лише тому, що він існує в пакеті. Зовнішні Plugin і користувацькі шляхи завантаження, як і раніше, використовують `openclaw plugins install` або `openclaw plugins update`.

 ## Автооновлювач

@ -96,7 +98,7 @@ ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp

 | Канал | Поведінка |
 | -------- | ------------------------------------------------------------------------------------------------------------- |
-| `stable` | Очікує `stableDelayHours`, потім застосовує з детермінованим джитером у межах `stableJitterHours` (поетапне розгортання). |
+| `stable` | Чекає `stableDelayHours`, а потім застосовує з детермінованим зміщенням у межах `stableJitterHours` (поступове розгортання). |
 | `beta`   | Перевіряє кожні `betaCheckIntervalHours` (типово: щогодини) і застосовує негайно. |
 | `dev`    | Автоматичне застосування відсутнє. Використовуйте `openclaw update` вручну. |

@ -112,7 +114,7 @@ Gateway також записує підказку про оновлення п
 openclaw doctor
 ```

-Мігрує конфігурацію, перевіряє політики DM і перевіряє стан Gateway. Подробиці: [Doctor](/uk/gateway/doctor)
+Мігрує конфігурацію, перевіряє політики DM і перевіряє стан Gateway. Докладніше: [Doctor](/uk/gateway/doctor)

 ### Перезапустіть Gateway

@ -149,13 +151,13 @@ pnpm install && pnpm build
 openclaw gateway restart
 ```

-Щоб повернутися до останньої версії: `git checkout main && git pull`.
+Щоб повернутися до latest: `git checkout main && git pull`.

-## Якщо ви зайшли в глухий кут
+## Якщо ви не можете просунутися далі

- Ще раз запустіть `openclaw doctor` і уважно прочитайте вивід.
- Для `openclaw update --channel dev` у checkout із вихідного коду оновлювач автоматично завантажує `pnpm`, якщо це потрібно. Якщо ви бачите помилку bootstrap `pnpm`/`corepack`, установіть `pnpm` вручну (або знову ввімкніть `corepack`) і повторно запустіть оновлення.
- Перевірте: [Усунення несправностей](/uk/gateway/troubleshooting)
+- Знову запустіть `openclaw doctor` і уважно прочитайте вивід.
+- Для `openclaw update --channel dev` у вихідних checkout-ах оновлювач автоматично завантажує `pnpm`, якщо потрібно. Якщо ви бачите помилку завантаження pnpm/corepack, установіть `pnpm` вручну (або знову увімкніть `corepack`) і повторно запустіть оновлення.
+- Перегляньте: [Усунення несправностей](/uk/gateway/troubleshooting)
 - Запитайте в Discord: [https://discord.gg/clawd](https://discord.gg/clawd)

 ## Пов’язане