openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(i18n): refresh uk translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-05-04 05:51:26 +00:00
parent ddcabe19a0
commit 1ef64ecc6c
1 changed files with 66 additions and 61 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

127
docs/uk/install/updating.md
View File

@ -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 <version-or-dist-tag>
@ -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
<AccordionGroup>
<Accordion title="Дерево пакета лише для читання">
OpenClaw розглядає упаковані глобальні встановлення як доступні лише для читання під час виконання, навіть коли глобальний каталог пакета доступний для запису поточному користувачу. Встановлення пакетів Plugin розміщуються в npm/git коренях, що належать OpenClaw, у каталозі користувацької конфігурації, а запуск Gateway не змінює дерево пакета OpenClaw.
<Accordion title="Дерево пакетів лише для читання">
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 записують дані поза цим глобальним каталогом пакета.
</Accordion>
<Accordion title="Посилені systemd unit">
Надайте OpenClaw доступ на запис до його коренів конфігурації/стану, щоб явні встановлення Plugin, оновлення Plugin і очищення doctor могли зберігати свої зміни:
<Accordion title="Посилені systemd-юніти">
Надайте OpenClaw доступ на запис до його коренів конфігурації/стану, щоб явні інсталяції plugin, оновлення plugin і очищення doctor могли зберігати свої зміни:
```ini
ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp
@ -134,13 +139,13 @@ bun add -g openclaw@latest
</Accordion>
<Accordion title="Попередня перевірка місця на диску">
Перед оновленнями пакетів і явними встановленнями Plugin OpenClaw намагається виконати best-effort перевірку місця на диску для цільового тому. Нестача місця створює попередження з перевіреним шляхом, але не блокує оновлення, оскільки квоти файлової системи, snapshot і мережеві томи можуть змінитися після перевірки. Фактичне встановлення через менеджер пакетів і перевірка після встановлення залишаються авторитетними.
Перед оновленнями пакетів і явними інсталяціями plugin OpenClaw намагається виконати best-effort перевірку місця на диску для цільового тому. Нестача місця створює попередження з перевіреним шляхом, але не блокує оновлення, оскільки файлові квоти, знімки та мережеві томи можуть змінитися після перевірки. Фактична інсталяція через менеджер пакетів і післяінсталяційна перевірка залишаються авторитетними.
</Accordion>
</AccordionGroup>
## Автооновлювач
## Автоматичне оновлення
Автооновлювач вимкнено за замовчуванням. Увімкніть його в `~/.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@<version>
@ -212,7 +217,7 @@ openclaw gateway restart
`npm view openclaw version` показує поточну опубліковану версію.
</Tip>
### Закріпити 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): посібники з міграції між основними версіями.