From 1ef64ecc6c74bc6101e3d08df6a3a202df33cefb Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Mon, 4 May 2026 05:51:26 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/install/updating.md | 127 +++++++++++++++++++----------------- 1 file changed, 66 insertions(+), 61 deletions(-) diff --git a/docs/uk/install/updating.md b/docs/uk/install/updating.md index 119c5fd74..5d19a1fed 100644 --- a/docs/uk/install/updating.md +++ b/docs/uk/install/updating.md @@ -1,14 +1,14 @@ --- read_when: - Оновлення OpenClaw - - Щось перестало працювати після оновлення -summary: Безпечне оновлення OpenClaw (глобальне встановлення або з вихідного коду), а також стратегія відкату + - Щось ламається після оновлення +summary: Безпечне оновлення OpenClaw (глобальне встановлення або з вихідного коду) та стратегія відкату title: Оновлення x-i18n: - generated_at: "2026-05-03T20:26:19Z" + generated_at: "2026-05-04T05:50:51Z" model: gpt-5.5 provider: openai - source_hash: f9e26ea71748dfd1573cdca01126bf29ebc56be56eac604e2b6a009b463820d1 + source_hash: 3c9ff1d70d74f45efea3c148718e5cbc74001ce3d924b760edc4d68622d23714 source_path: install/updating.md workflow: 16 --- @@ -17,48 +17,48 @@ x-i18n: ## Рекомендовано: `openclaw update` -Найшвидший спосіб оновлення. Він визначає тип вашого встановлення (npm або git), отримує останню версію, запускає `openclaw doctor` і перезапускає Gateway. +Найшвидший спосіб оновлення. Він визначає тип вашої інсталяції (npm або git), отримує найновішу версію, запускає `openclaw doctor` і перезапускає Gateway. ```bash openclaw update ``` -Щоб перемкнути канали або вибрати конкретну версію: +Щоб перемикати канали або вибрати конкретну версію: ```bash openclaw update --channel beta openclaw update --channel dev openclaw update --tag main -openclaw update --dry-run # preview without applying +openclaw update --dry-run # попередній перегляд без застосування ``` `openclaw update` не приймає `--verbose`. Для діагностики оновлення використовуйте -`--dry-run`, щоб переглянути заплановані дії, `--json` для структурованих результатів або -`openclaw update status --json`, щоб перевірити канал і стан доступності. -Інсталятор має власний прапорець `--verbose`, але цей прапорець не є частиною +`--dry-run`, щоб попередньо переглянути заплановані дії, `--json` для структурованих результатів або +`openclaw update status --json`, щоб переглянути стан каналу й доступності. Інсталятор +має власний прапорець `--verbose`, але цей прапорець не є частиною `openclaw update`. -`--channel beta` віддає перевагу beta, але середовище виконання повертається до stable/latest, коли -тег beta відсутній або старіший за останній стабільний реліз. Використовуйте `--tag beta`, -якщо вам потрібен необроблений npm beta dist-tag для одноразового оновлення пакета. +`--channel beta` надає перевагу beta, але runtime повертається до stable/latest, коли +тег beta відсутній або старіший за найновіший стабільний випуск. Використовуйте `--tag beta`, +якщо потрібен сирий npm beta dist-tag для одноразового оновлення пакета. -Див. [Канали розробки](/uk/install/development-channels) для семантики каналів. +Див. [Канали розробки](/uk/install/development-channels), щоб дізнатися про семантику каналів. -## Перемикання між встановленнями npm і git +## Перемикання між інсталяціями npm і git -Використовуйте канали, коли потрібно змінити тип встановлення. Засіб оновлення зберігає ваші -стан, конфігурацію, облікові дані й робочий простір у `~/.openclaw`; він змінює лише те, -яке встановлення коду OpenClaw використовують CLI і Gateway. +Використовуйте канали, коли хочете змінити тип інсталяції. Засіб оновлення зберігає ваш +стан, конфігурацію, облікові дані та робочий простір у `~/.openclaw`; він змінює лише те, +яку інсталяцію коду OpenClaw використовують CLI і Gateway. ```bash -# npm package install -> editable git checkout +# інсталяція пакета npm -> редагований git checkout openclaw update --channel dev -# git checkout -> npm package install +# git checkout -> інсталяція пакета npm openclaw update --channel stable ``` -Спочатку запустіть із `--dry-run`, щоб переглянути точне перемикання режиму встановлення: +Спочатку запустіть із `--dry-run`, щоб попередньо переглянути точне перемикання режиму інсталяції: ```bash openclaw update --channel dev --dry-run @@ -66,29 +66,29 @@ openclaw update --channel stable --dry-run ``` Канал `dev` забезпечує git checkout, збирає його та встановлює глобальний CLI -з цього checkout. Канали `stable` і `beta` використовують встановлення пакетів. Якщо +з цього checkout. Канали `stable` і `beta` використовують інсталяції пакетів. Якщо Gateway уже встановлено, `openclaw update` оновлює метадані служби та перезапускає її, якщо ви не передали `--no-restart`. -## Альтернатива: повторно запустити інсталятор +## Альтернатива: повторний запуск інсталятора ```bash curl -fsSL https://openclaw.ai/install.sh | bash ``` -Додайте `--no-onboard`, щоб пропустити onboarding. Щоб примусово вибрати конкретний тип встановлення через +Додайте `--no-onboard`, щоб пропустити onboarding. Щоб примусово вибрати конкретний тип інсталяції через інсталятор, передайте `--install-method git --no-onboard` або `--install-method npm --no-onboard`. -Якщо `openclaw update` завершується помилкою після етапу встановлення пакета npm, повторно запустіть -інсталятор. Інсталятор не викликає старий засіб оновлення; він запускає глобальне -встановлення пакета напряму й може відновити частково оновлене встановлення npm. +Якщо `openclaw update` завершується помилкою після етапу інсталяції пакета npm, повторно запустіть +інсталятор. Інсталятор не викликає старий засіб оновлення; він запускає глобальну +інсталяцію пакета напряму й може відновити частково оновлену npm-інсталяцію. ```bash curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm ``` -Щоб закріпити відновлення на конкретній версії або dist-tag, додайте `--version`: +Щоб зафіксувати відновлення на конкретній версії або dist-tag, додайте `--version`: ```bash curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --version @@ -100,13 +100,18 @@ curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --ve npm i -g openclaw@latest ``` -Коли `openclaw update` керує глобальним встановленням npm, він спочатку встановлює цільову версію в -тимчасовий префікс npm, перевіряє інвентар упакованого `dist`, а потім замінює -чисте дерево пакета в реальному глобальному префіксі. Це запобігає накладанню npm -нового пакета поверх застарілих файлів зі старого пакета. Якщо команда встановлення завершується помилкою, -OpenClaw повторює спробу один раз із `--omit=optional`. Ця повторна спроба допомагає хостам, де нативні -необов’язкові залежності не можуть скомпілюватися, водночас зберігаючи видимою початкову помилку, -якщо резервний варіант також не спрацює. +Надавайте перевагу `openclaw update` для керованих інсталяцій, оскільки він може узгодити +заміну пакета із запущеною службою Gateway. Якщо ви оновлюєте вручну, коли працює +керований Gateway, перезапустіть Gateway одразу після завершення роботи менеджера пакетів, +щоб старий процес не продовжував обслуговувати з уже замінених файлів пакета. + +Коли `openclaw update` керує глобальною npm-інсталяцією, він спершу встановлює ціль +у тимчасовий npm-префікс, перевіряє інвентар упакованого `dist`, а потім замінює +чисте дерево пакета в реальному глобальному префіксі. Це не дає npm накладати +новий пакет поверх застарілих файлів зі старого пакета. Якщо команда інсталяції завершується помилкою, +OpenClaw повторює спробу один раз із `--omit=optional`. Така повторна спроба допомагає хостам, де нативні +необов’язкові залежності не можуть скомпілюватися, водночас залишаючи початкову помилку видимою, +якщо резервний варіант також завершується помилкою. ```bash pnpm add -g openclaw@latest @@ -116,17 +121,17 @@ pnpm add -g openclaw@latest bun add -g openclaw@latest ``` -### Розширені теми встановлення npm +### Розширені теми інсталяції npm - - OpenClaw розглядає упаковані глобальні встановлення як доступні лише для читання під час виконання, навіть коли глобальний каталог пакета доступний для запису поточному користувачу. Встановлення пакетів Plugin розміщуються в npm/git коренях, що належать OpenClaw, у каталозі користувацької конфігурації, а запуск Gateway не змінює дерево пакета OpenClaw. + + OpenClaw розглядає упаковані глобальні інсталяції як доступні лише для читання під час runtime, навіть коли глобальний каталог пакета доступний для запису поточному користувачу. Інсталяції пакетів Plugin розміщуються в npm/git-коренях, що належать OpenClaw, у каталозі конфігурації користувача, а запуск Gateway не змінює дерево пакета OpenClaw. - Деякі конфігурації npm у Linux встановлюють глобальні пакети в каталоги, що належать root, наприклад `/usr/lib/node_modules/openclaw`. OpenClaw підтримує таке компонування, оскільки команди встановлення й оновлення Plugin записують дані поза цим глобальним каталогом пакета. + Деякі конфігурації npm у Linux встановлюють глобальні пакети в каталоги, що належать root, наприклад `/usr/lib/node_modules/openclaw`. OpenClaw підтримує таку структуру, оскільки команди інсталяції/оновлення plugin записують дані поза цим глобальним каталогом пакета. - - Надайте OpenClaw доступ на запис до його коренів конфігурації/стану, щоб явні встановлення Plugin, оновлення Plugin і очищення doctor могли зберігати свої зміни: + + Надайте OpenClaw доступ на запис до його коренів конфігурації/стану, щоб явні інсталяції plugin, оновлення plugin і очищення doctor могли зберігати свої зміни: ```ini ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp @@ -134,13 +139,13 @@ bun add -g openclaw@latest - Перед оновленнями пакетів і явними встановленнями Plugin OpenClaw намагається виконати best-effort перевірку місця на диску для цільового тому. Нестача місця створює попередження з перевіреним шляхом, але не блокує оновлення, оскільки квоти файлової системи, snapshot і мережеві томи можуть змінитися після перевірки. Фактичне встановлення через менеджер пакетів і перевірка після встановлення залишаються авторитетними. + Перед оновленнями пакетів і явними інсталяціями plugin OpenClaw намагається виконати best-effort перевірку місця на диску для цільового тому. Нестача місця створює попередження з перевіреним шляхом, але не блокує оновлення, оскільки файлові квоти, знімки та мережеві томи можуть змінитися після перевірки. Фактична інсталяція через менеджер пакетів і післяінсталяційна перевірка залишаються авторитетними. -## Автооновлювач +## Автоматичне оновлення -Автооновлювач вимкнено за замовчуванням. Увімкніть його в `~/.openclaw/openclaw.json`: +Автоматичне оновлення за замовчуванням вимкнене. Увімкніть його в `~/.openclaw/openclaw.json`: ```json5 { @@ -158,18 +163,18 @@ bun add -g openclaw@latest | Канал | Поведінка | | -------- | ------------------------------------------------------------------------------------------------------------- | -| `stable` | Чекає `stableDelayHours`, а потім застосовує з детермінованим jitter у межах `stableJitterHours` (поетапне розгортання). | -| `beta` | Перевіряє кожні `betaCheckIntervalHours` (за замовчуванням: щогодини) і застосовує негайно. | +| `stable` | Очікує `stableDelayHours`, потім застосовує з детермінованим джитером у межах `stableJitterHours` (розподілене розгортання). | +| `beta` | Перевіряє кожні `betaCheckIntervalHours` (типово: щогодини) і застосовує негайно. | | `dev` | Без автоматичного застосування. Використовуйте `openclaw update` вручну. | -Gateway також записує підказку про оновлення під час запуску (вимикається через `update.checkOnStart: false`). -Для downgrade або відновлення після інциденту встановіть `OPENCLAW_NO_AUTO_UPDATE=1` у середовищі Gateway, щоб заблокувати автоматичні застосування навіть коли налаштовано `update.auto.enabled`. Підказки про оновлення під час запуску все ще можуть виконуватися, якщо `update.checkOnStart` також не вимкнено. +Gateway також записує підказку про оновлення під час запуску (вимкніть за допомогою `update.checkOnStart: false`). +Для downgrade або відновлення після інциденту встановіть `OPENCLAW_NO_AUTO_UPDATE=1` у середовищі Gateway, щоб заблокувати автоматичне застосування, навіть коли налаштовано `update.auto.enabled`. Підказки про оновлення під час запуску все ще можуть виконуватися, якщо також не вимкнено `update.checkOnStart`. -Оновлення менеджера пакетів, запитані через live обробник control-plane Gateway, -примусово виконують restart оновлення без відкладання й без cooldown після заміни пакета. Це -не дає старому процесу в пам’яті залишатися достатньо довго, щоб lazy-load фрагменти -з дерева пакета, яке вже було замінено. Shell `openclaw update` -залишається бажаним шляхом для керованих встановлень, оскільки він може зупинити й +Оновлення менеджера пакетів, запитані через живий обробник control-plane Gateway, +примусово виконують невідкладний, без cooldown, перезапуск оновлення після заміни пакета. Це +запобігає ситуації, коли старий процес у пам’яті залишається достатньо довго, щоб lazy-load chunks +із дерева пакета, яке вже замінено. Shell `openclaw update` +залишається рекомендованим шляхом для керованих інсталяцій, оскільки він може зупинити й перезапустити службу навколо оновлення. ## Після оновлення @@ -182,7 +187,7 @@ Gateway також записує підказку про оновлення п openclaw doctor ``` -Мігрує конфігурацію, аудитує політики DM і перевіряє справність Gateway. Докладніше: [Doctor](/uk/gateway/doctor) +Мігрує конфігурацію, перевіряє політики DM і стан Gateway. Докладніше: [Doctor](/uk/gateway/doctor) ### Перезапустіть Gateway @@ -200,7 +205,7 @@ openclaw health ## Відкат -### Закріпити версію (npm) +### Зафіксуйте версію (npm) ```bash npm i -g openclaw@ @@ -212,7 +217,7 @@ openclaw gateway restart `npm view openclaw version` показує поточну опубліковану версію. -### Закріпити commit (source) +### Зафіксуйте commit (джерельний код) ```bash git fetch origin @@ -221,17 +226,17 @@ pnpm install && pnpm build openclaw gateway restart ``` -Щоб повернутися до останньої версії: `git checkout main && git pull`. +Щоб повернутися до найновішої версії: `git checkout main && git pull`. ## Якщо ви застрягли - Запустіть `openclaw doctor` ще раз і уважно прочитайте вивід. -- Для `openclaw update --channel dev` на source checkouts засіб оновлення автоматично bootstraps `pnpm`, коли це потрібно. Якщо ви бачите помилку bootstrap pnpm/corepack, встановіть `pnpm` вручну (або повторно увімкніть `corepack`) і перезапустіть оновлення. +- Для `openclaw update --channel dev` у source checkouts засіб оновлення автоматично bootstrap-ить `pnpm`, коли це потрібно. Якщо ви бачите помилку bootstrap pnpm/corepack, встановіть `pnpm` вручну (або повторно увімкніть `corepack`) і повторіть оновлення. - Перевірте: [Усунення несправностей](/uk/gateway/troubleshooting) - Запитайте в Discord: [https://discord.gg/clawd](https://discord.gg/clawd) ## Пов’язане -- [Огляд встановлення](/uk/install): усі способи встановлення. -- [Doctor](/uk/gateway/doctor): перевірки справності після оновлень. -- [Міграція](/uk/install/migrating): посібники з міграції основних версій. +- [Огляд інсталяції](/uk/install): усі методи інсталяції. +- [Doctor](/uk/gateway/doctor): перевірки стану після оновлень. +- [Міграція](/uk/install/migrating): посібники з міграції між основними версіями.