chore(i18n): refresh uk translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
df681bb996
commit
dcc4f63d43
@ -1,14 +1,15 @@
|
||||
---
|
||||
read_when:
|
||||
- Ви хочете безпечно оновити робочу копію вихідного коду
|
||||
- Вам потрібно зрозуміти скорочену поведінку `--update`
|
||||
- Ви налагоджуєте вивід або параметри `openclaw update`
|
||||
- Потрібно розуміти поведінку скороченого запису `--update`
|
||||
summary: Довідник CLI для `openclaw update` (відносно безпечне оновлення джерела + автоматичний перезапуск Gateway)
|
||||
title: Оновлення
|
||||
title: Оновити
|
||||
x-i18n:
|
||||
generated_at: "2026-05-03T16:59:31Z"
|
||||
generated_at: "2026-05-03T20:26:26Z"
|
||||
model: gpt-5.5
|
||||
provider: openai
|
||||
source_hash: 767f3902877209f3945f50f7f8bd6ec7650a708685f1c4008d4191dc00eb1774
|
||||
source_hash: 66bae6ee2b01c667aaf47dfb17fe8a2a5e39e884f157fead242d2f9d4040f817
|
||||
source_path: cli/update.md
|
||||
workflow: 16
|
||||
---
|
||||
@ -18,7 +19,7 @@ x-i18n:
|
||||
Безпечно оновлюйте OpenClaw і перемикайтеся між каналами stable/beta/dev.
|
||||
|
||||
Якщо ви встановили через **npm/pnpm/bun** (глобальне встановлення, без git-метаданих),
|
||||
оновлення відбуваються через потік менеджера пакетів у [Оновлення](/uk/install/updating).
|
||||
оновлення виконуються через потік менеджера пакетів у [Оновлення](/uk/install/updating).
|
||||
|
||||
## Використання
|
||||
|
||||
@ -39,23 +40,31 @@ openclaw --update
|
||||
|
||||
## Параметри
|
||||
|
||||
- `--no-restart`: пропустити перезапуск служби Gateway після успішного оновлення. Оновлення через менеджер пакетів, які перезапускають Gateway, перед успішним завершенням команди перевіряють, що перезапущена служба повідомляє очікувану оновлену версію.
|
||||
- `--no-restart`: пропустити перезапуск служби Gateway після успішного оновлення. Оновлення через менеджер пакетів, які перезапускають Gateway, перевіряють, що перезапущена служба повідомляє очікувану оновлену версію, перш ніж команда завершиться успішно.
|
||||
- `--channel <stable|beta|dev>`: встановити канал оновлення (git + npm; зберігається в конфігурації).
|
||||
- `--tag <dist-tag|version|spec>`: перевизначити ціль пакета лише для цього оновлення. Для встановлень пакетів `main` зіставляється з `github:openclaw/openclaw#main`.
|
||||
- `--dry-run`: попередньо переглянути заплановані дії оновлення (канал/тег/ціль/потік перезапуску) без запису конфігурації, встановлення, синхронізації плагінів або перезапуску.
|
||||
- `--json`: вивести машинозчитуваний JSON `UpdateRunResult`, зокрема
|
||||
`postUpdate.plugins.integrityDrifts`, коли під час синхронізації плагінів після оновлення
|
||||
виявлено дрейф артефактів npm-плагінів.
|
||||
- `--tag <dist-tag|version|spec>`: перевизначити ціль пакета лише для цього оновлення. Для пакетних встановлень `main` відповідає `github:openclaw/openclaw#main`.
|
||||
- `--dry-run`: переглянути заплановані дії оновлення (канал/тег/ціль/потік перезапуску) без запису конфігурації, встановлення, синхронізації plugins або перезапуску.
|
||||
- `--json`: вивести машинно-читаний JSON `UpdateRunResult`, включно з
|
||||
`postUpdate.plugins.integrityDrifts`, коли під час синхронізації plugins після оновлення
|
||||
виявлено дрейф артефактів npm plugin.
|
||||
- `--timeout <seconds>`: тайм-аут для кожного кроку (типово 1800 с).
|
||||
- `--yes`: пропустити запити підтвердження (наприклад, підтвердження повернення до старішої версії).
|
||||
- `--yes`: пропустити запити підтвердження (наприклад, підтвердження пониження версії).
|
||||
|
||||
`openclaw update` не має прапорця `--verbose`. Використовуйте `--dry-run`, щоб переглянути
|
||||
заплановані дії каналу/тега/встановлення/перезапуску, `--json` для машинно-читаних
|
||||
результатів, і `openclaw update status --json`, коли потрібні лише відомості про канал і
|
||||
доступність. Якщо ви налагоджуєте журнали Gateway під час оновлення,
|
||||
докладність консолі та рівень файлових журналів налаштовуються окремо: Gateway `--verbose` впливає
|
||||
на вивід у термінал/WebSocket, тоді як файлові журнали потребують `logging.level: "debug"` або
|
||||
`"trace"` у конфігурації. Див. [Журналювання Gateway](/uk/gateway/logging).
|
||||
|
||||
<Warning>
|
||||
Повернення до старішої версії потребує підтвердження, бо старіші версії можуть порушити конфігурацію.
|
||||
Пониження версії потребує підтвердження, бо старіші версії можуть зламати конфігурацію.
|
||||
</Warning>
|
||||
|
||||
## `update status`
|
||||
|
||||
Показує активний канал оновлення + git-тег/гілку/SHA (для вихідних checkout), а також доступність оновлення.
|
||||
Показує активний канал оновлення + git-тег/гілку/SHA (для checkout з вихідного коду), а також доступність оновлень.
|
||||
|
||||
```bash
|
||||
openclaw update status
|
||||
@ -65,13 +74,13 @@ openclaw update status --timeout 10
|
||||
|
||||
Параметри:
|
||||
|
||||
- `--json`: вивести машинозчитуваний JSON стану.
|
||||
- `--json`: вивести машинно-читаний JSON стану.
|
||||
- `--timeout <seconds>`: тайм-аут для перевірок (типово 3 с).
|
||||
|
||||
## `update wizard`
|
||||
|
||||
Інтерактивний потік для вибору каналу оновлення й підтвердження, чи перезапускати Gateway
|
||||
після оновлення (типово перезапускається). Якщо ви виберете `dev` без git checkout, він
|
||||
Інтерактивний потік для вибору каналу оновлення та підтвердження, чи перезапускати Gateway
|
||||
після оновлення (типово перезапускається). Якщо вибрати `dev` без git checkout, він
|
||||
запропонує створити його.
|
||||
|
||||
Параметри:
|
||||
@ -81,43 +90,43 @@ openclaw update status --timeout 10
|
||||
## Що він робить
|
||||
|
||||
Коли ви явно перемикаєте канали (`--channel ...`), OpenClaw також підтримує
|
||||
узгодженість методу встановлення:
|
||||
відповідність методу встановлення:
|
||||
|
||||
- `dev` → забезпечує git checkout (типово: `~/openclaw`, перевизначається через `OPENCLAW_GIT_DIR`),
|
||||
оновлює його та встановлює глобальний CLI із цього checkout.
|
||||
- `dev` → забезпечує наявність git checkout (типово: `~/openclaw`, перевизначається через `OPENCLAW_GIT_DIR`),
|
||||
оновлює його та встановлює глобальний CLI з цього checkout.
|
||||
- `stable` → встановлює з npm за допомогою `latest`.
|
||||
- `beta` → віддає перевагу npm dist-tag `beta`, але повертається до `latest`, коли beta
|
||||
відсутня або старіша за поточний stable-реліз.
|
||||
відсутній або старіший за поточний стабільний випуск.
|
||||
|
||||
Автооновлювач ядра Gateway (коли ввімкнений у конфігурації) запускає шлях оновлення CLI
|
||||
поза живим обробником запитів Gateway. Оновлення менеджера пакетів `update.run` у площині керування
|
||||
примусово виконують невідкладний перезапуск оновлення без періоду очікування після заміни пакета,
|
||||
бо старий процес Gateway може досі мати в пам’яті фрагменти, що посилаються на
|
||||
Автооновлювач ядра Gateway (коли ввімкнений через конфігурацію) запускає шлях оновлення CLI
|
||||
поза активним обробником запитів Gateway. Оновлення через менеджер пакетів control-plane `update.run`
|
||||
примусово виконують невідкладний перезапуск оновлення без cooldown після заміни пакета,
|
||||
бо старий процес Gateway усе ще може мати в пам’яті фрагменти, що вказують на
|
||||
файли, видалені новим пакетом.
|
||||
|
||||
Для встановлень через менеджер пакетів `openclaw update` визначає цільову версію
|
||||
пакета перед викликом менеджера пакетів. Глобальні встановлення npm використовують поетапне
|
||||
встановлення: OpenClaw встановлює новий пакет у тимчасовий префікс npm, перевіряє
|
||||
там інвентар упакованого `dist`, а потім замінює цим чистим деревом пакета
|
||||
реальний глобальний префікс. Якщо перевірка не вдається, doctor після оновлення, синхронізація плагінів і
|
||||
Для встановлень через менеджер пакетів `openclaw update` визначає цільову версію пакета
|
||||
перед викликом менеджера пакетів. Глобальні встановлення npm використовують поетапне
|
||||
встановлення: OpenClaw встановлює новий пакет у тимчасовий npm-префікс, перевіряє
|
||||
там інвентар запакованого `dist`, а потім замінює цим чистим деревом пакета
|
||||
справжній глобальний префікс. Якщо перевірка не вдається, post-update doctor, синхронізація plugin і
|
||||
перезапуск не запускаються з підозрілого дерева. Навіть коли встановлена версія
|
||||
вже відповідає цілі, команда оновлює глобальне встановлення пакета,
|
||||
а потім запускає синхронізацію плагінів, оновлення завершення основних команд і перезапуск. Це
|
||||
підтримує узгодженість упакованих sidecar-компонентів і записів плагінів, що належать каналу, із
|
||||
встановленою збіркою OpenClaw, залишаючи повну перебудову завершення команд плагінів для
|
||||
вже відповідає цільовій, команда оновлює глобальне встановлення пакета,
|
||||
після чого запускає синхронізацію plugin, оновлення completions для основних команд і перезапуск. Це
|
||||
підтримує відповідність запакованих sidecar-компонентів і записів plugins, що належать каналу, із
|
||||
встановленою збіркою OpenClaw, залишаючи повні перебудови completions для команд plugins для
|
||||
явних запусків `openclaw completion --write-state`.
|
||||
|
||||
Коли встановлено локальну керовану службу Gateway і ввімкнено перезапуск,
|
||||
оновлення через менеджер пакетів зупиняють запущену службу перед заміною дерева
|
||||
пакета, потім оновлюють метадані служби з оновленого встановлення, перезапускають
|
||||
службу й перевіряють, що перезапущений Gateway повідомляє очікувану версію перед
|
||||
повідомленням про успіх. На macOS перевірка після оновлення також перевіряє, що LaunchAgent
|
||||
завантажений/запущений для активного профілю, а налаштований порт loopback є
|
||||
справним. Якщо plist встановлено, але launchd не наглядає за ним, OpenClaw
|
||||
автоматично повторно bootstrap-ить і kickstart-ить LaunchAgent, а потім повторно запускає
|
||||
перевірки готовності health/версії/каналу. Якщо Gateway усе ще не стає
|
||||
Коли встановлено локальну керовану службу Gateway і перезапуск увімкнений,
|
||||
оновлення через менеджер пакетів зупиняють запущену службу перед заміною дерева пакета,
|
||||
потім оновлюють метадані служби з оновленого встановлення, перезапускають
|
||||
службу та перевіряють, що перезапущений Gateway повідомляє очікувану версію, перш ніж
|
||||
повідомити про успіх. На macOS перевірка після оновлення також підтверджує, що LaunchAgent
|
||||
завантажений/запущений для активного профілю, а налаштований порт loopback
|
||||
справний. Якщо plist встановлено, але launchd ним не керує, OpenClaw
|
||||
автоматично повторно bootstrap і kickstart LaunchAgent, а потім повторно запускає
|
||||
перевірки готовності health/version/channel. Якщо Gateway усе ще не стає
|
||||
справним, команда завершується з ненульовим кодом і виводить шлях до журналу перезапуску, а також явні
|
||||
інструкції щодо перезапуску, перевстановлення та відкату пакета. З `--no-restart`
|
||||
інструкції з перезапуску, перевстановлення та відкату пакета. З `--no-restart`
|
||||
заміна пакета все одно виконується, але керована служба не зупиняється і не
|
||||
перезапускається, тому запущений Gateway може зберігати старий код, доки ви не перезапустите його
|
||||
вручну.
|
||||
@ -126,30 +135,30 @@ openclaw update status --timeout 10
|
||||
|
||||
### Вибір каналу
|
||||
|
||||
- `stable`: checkout останнього небета-тега, потім build і doctor.
|
||||
- `beta`: віддати перевагу останньому тегу `-beta`, але повернутися до останнього stable-тега, коли beta відсутня або старіша.
|
||||
- `stable`: checkout останнього не-beta тегу, потім збирання та doctor.
|
||||
- `beta`: віддати перевагу останньому тегу `-beta`, але повернутися до останнього стабільного тегу, коли beta відсутній або старіший.
|
||||
- `dev`: checkout `main`, потім fetch і rebase.
|
||||
|
||||
### Кроки оновлення
|
||||
|
||||
<Steps>
|
||||
<Step title="Перевірити чистий worktree">
|
||||
Вимагає відсутності незакомічених змін.
|
||||
Не повинно бути незакомічених змін.
|
||||
</Step>
|
||||
<Step title="Перемкнути канал">
|
||||
Перемикає на вибраний канал (тег або гілку).
|
||||
</Step>
|
||||
<Step title="Отримати upstream">
|
||||
Лише для dev.
|
||||
<Step title="Fetch upstream">
|
||||
Лише dev.
|
||||
</Step>
|
||||
<Step title="Preflight build (лише dev)">
|
||||
Запускає lint і TypeScript build у тимчасовому worktree. Якщо tip не проходить, повертається назад до 10 комітів, щоб знайти найновіший чистий build.
|
||||
<Step title="Передпольотне збирання (лише dev)">
|
||||
Запускає lint і TypeScript build у тимчасовому worktree. Якщо tip не проходить, відступає назад до 10 комітів, щоб знайти найновіше чисте збирання.
|
||||
</Step>
|
||||
<Step title="Rebase">
|
||||
Виконує rebase на вибраний коміт (лише dev).
|
||||
</Step>
|
||||
<Step title="Встановити залежності">
|
||||
Використовує менеджер пакетів репозиторію. Для pnpm checkout оновлювач bootstrap-ить `pnpm` на вимогу (спочатку через `corepack`, потім через запасний тимчасовий `npm install pnpm@10`) замість запуску `npm run build` усередині pnpm workspace.
|
||||
Використовує менеджер пакетів репозиторію. Для pnpm checkout оновлювач bootstrap `pnpm` на вимогу (спочатку через `corepack`, потім тимчасовий fallback `npm install pnpm@10`) замість запуску `npm run build` усередині pnpm workspace.
|
||||
</Step>
|
||||
<Step title="Зібрати Control UI">
|
||||
Збирає gateway і Control UI.
|
||||
@ -157,35 +166,35 @@ openclaw update status --timeout 10
|
||||
<Step title="Запустити doctor">
|
||||
`openclaw doctor` запускається як фінальна перевірка безпечного оновлення.
|
||||
</Step>
|
||||
<Step title="Синхронізувати плагіни">
|
||||
Синхронізує плагіни з активним каналом. Dev використовує bundled плагіни; stable і beta використовують npm. Оновлює відстежувані встановлення плагінів.
|
||||
<Step title="Синхронізувати plugins">
|
||||
Синхронізує plugins з активним каналом. Dev використовує bundled plugins; stable і beta використовують npm. Оновлює відстежувані встановлення plugin.
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
На каналі оновлення beta відстежувані npm і ClawHub встановлення плагінів, що слідують
|
||||
типовій/latest лінії, спершу пробують реліз плагіна `@beta`. Якщо плагін не має
|
||||
beta-релізу, OpenClaw повертається до записаної типової/latest специфікації. Точні
|
||||
На каналі оновлення beta відстежувані встановлення npm і ClawHub plugin, які дотримуються
|
||||
типової/latest лінії, спочатку пробують випуск plugin `@beta`. Якщо plugin не має
|
||||
beta-випуску, OpenClaw повертається до записаної специфікації default/latest. Точні
|
||||
версії та явні теги не переписуються.
|
||||
|
||||
<Warning>
|
||||
Якщо оновлення точно закріпленого npm-плагіна визначає артефакт, цілісність якого відрізняється від збереженого запису встановлення, `openclaw update` перериває оновлення цього артефакту плагіна замість його встановлення. Перевстановлюйте або явно оновлюйте плагін лише після перевірки, що ви довіряєте новому артефакту.
|
||||
Якщо оновлення npm plugin із точно зафіксованою версією визначає артефакт, цілісність якого відрізняється від збереженого запису встановлення, `openclaw update` перериває це оновлення артефакту plugin замість його встановлення. Перевстановіть або оновіть plugin явно лише після перевірки, що ви довіряєте новому артефакту.
|
||||
</Warning>
|
||||
|
||||
<Note>
|
||||
Збої синхронізації плагінів після оновлення призводять до невдалого результату оновлення й зупиняють подальшу роботу перезапуску. Виправте помилку встановлення або оновлення плагіна, потім повторно запустіть `openclaw update`.
|
||||
Помилки синхронізації plugin після оновлення призводять до невдалого результату оновлення та зупиняють подальші дії перезапуску. Виправте помилку встановлення або оновлення plugin, а потім повторно запустіть `openclaw update`.
|
||||
|
||||
Коли оновлений Gateway запускається, завантаження плагінів працює лише в режимі перевірки: startup не запускає менеджери пакетів і не змінює дерева залежностей. Перезапуски менеджера пакетів `update.run` обходять звичайне відкладення під час простою та cooldown перезапуску після заміни дерева пакета, тому старий процес не може продовжувати lazy-load видалених фрагментів.
|
||||
Коли оновлений Gateway запускається, завантаження plugin працює лише в режимі перевірки: запуск не запускає менеджери пакетів і не змінює дерева залежностей. Перезапуски `update.run` через менеджер пакетів обходять звичайне відкладення простою та restart cooldown після заміни дерева пакета, тому старий процес не може продовжувати lazy-loading видалених фрагментів.
|
||||
|
||||
Якщо pnpm bootstrap усе ще не вдається, оновлювач зупиняється рано з помилкою, специфічною для менеджера пакетів, замість спроби виконати `npm run build` усередині checkout.
|
||||
Якщо bootstrap pnpm усе одно не вдається, оновлювач зупиняється рано з помилкою, специфічною для менеджера пакетів, замість спроби `npm run build` усередині checkout.
|
||||
</Note>
|
||||
|
||||
## Скорочення `--update`
|
||||
|
||||
`openclaw --update` переписується на `openclaw update` (корисно для оболонок і launcher-скриптів).
|
||||
`openclaw --update` переписується на `openclaw update` (корисно для shell і скриптів запуску).
|
||||
|
||||
## Пов’язане
|
||||
|
||||
- `openclaw doctor` (пропонує спершу запустити update на git checkout)
|
||||
- `openclaw doctor` (пропонує спочатку запустити update на git checkout)
|
||||
- [Канали розробки](/uk/install/development-channels)
|
||||
- [Оновлення](/uk/install/updating)
|
||||
- [Довідник CLI](/uk/cli)
|
||||
|
||||
@ -1,14 +1,14 @@
|
||||
---
|
||||
read_when:
|
||||
- Оновлення OpenClaw
|
||||
- Щось не працює після оновлення
|
||||
- Щось перестало працювати після оновлення
|
||||
summary: Безпечне оновлення OpenClaw (глобальне встановлення або з вихідного коду), а також стратегія відкату
|
||||
title: Оновлення
|
||||
x-i18n:
|
||||
generated_at: "2026-05-01T20:38:35Z"
|
||||
generated_at: "2026-05-03T20:26:19Z"
|
||||
model: gpt-5.5
|
||||
provider: openai
|
||||
source_hash: 84bf4462a4ee041b0d22e433d1e9f44cfd799a5c327ba94f9df96595d92bdb3c
|
||||
source_hash: f9e26ea71748dfd1573cdca01126bf29ebc56be56eac604e2b6a009b463820d1
|
||||
source_path: install/updating.md
|
||||
workflow: 16
|
||||
---
|
||||
@ -17,7 +17,7 @@ x-i18n:
|
||||
|
||||
## Рекомендовано: `openclaw update`
|
||||
|
||||
Найшвидший спосіб оновлення. Він визначає тип вашого встановлення (npm або git), отримує найновішу версію, запускає `openclaw doctor` і перезапускає Gateway.
|
||||
Найшвидший спосіб оновлення. Він визначає тип вашого встановлення (npm або git), отримує останню версію, запускає `openclaw doctor` і перезапускає Gateway.
|
||||
|
||||
```bash
|
||||
openclaw update
|
||||
@ -32,13 +32,23 @@ openclaw update --tag main
|
||||
openclaw update --dry-run # preview without applying
|
||||
```
|
||||
|
||||
`--channel beta` надає перевагу beta, але середовище виконання повертається до stable/latest, коли тег beta відсутній або старіший за найновіший стабільний випуск. Використовуйте `--tag beta`, якщо вам потрібен сирий npm beta dist-tag для одноразового оновлення пакета.
|
||||
`openclaw update` не приймає `--verbose`. Для діагностики оновлення використовуйте
|
||||
`--dry-run`, щоб переглянути заплановані дії, `--json` для структурованих результатів або
|
||||
`openclaw update status --json`, щоб перевірити канал і стан доступності.
|
||||
Інсталятор має власний прапорець `--verbose`, але цей прапорець не є частиною
|
||||
`openclaw update`.
|
||||
|
||||
Див. [Канали розробки](/uk/install/development-channels) щодо семантики каналів.
|
||||
`--channel beta` віддає перевагу beta, але середовище виконання повертається до stable/latest, коли
|
||||
тег beta відсутній або старіший за останній стабільний реліз. Використовуйте `--tag beta`,
|
||||
якщо вам потрібен необроблений npm beta dist-tag для одноразового оновлення пакета.
|
||||
|
||||
## Перемикання між npm- і git-встановленнями
|
||||
Див. [Канали розробки](/uk/install/development-channels) для семантики каналів.
|
||||
|
||||
Використовуйте канали, коли хочете змінити тип встановлення. Оновлювач зберігає ваш стан, конфігурацію, облікові дані й робочу область у `~/.openclaw`; він змінює лише те, яке встановлення коду OpenClaw використовують CLI і Gateway.
|
||||
## Перемикання між встановленнями npm і git
|
||||
|
||||
Використовуйте канали, коли потрібно змінити тип встановлення. Засіб оновлення зберігає ваші
|
||||
стан, конфігурацію, облікові дані й робочий простір у `~/.openclaw`; він змінює лише те,
|
||||
яке встановлення коду OpenClaw використовують CLI і Gateway.
|
||||
|
||||
```bash
|
||||
# npm package install -> editable git checkout
|
||||
@ -55,35 +65,48 @@ openclaw update --channel dev --dry-run
|
||||
openclaw update --channel stable --dry-run
|
||||
```
|
||||
|
||||
Канал `dev` забезпечує git checkout, збирає його й установлює глобальний CLI з цього checkout. Канали `stable` і `beta` використовують пакетні встановлення. Якщо Gateway уже встановлено, `openclaw update` оновлює метадані сервісу й перезапускає його, якщо ви не передали `--no-restart`.
|
||||
Канал `dev` забезпечує git checkout, збирає його та встановлює глобальний CLI
|
||||
з цього checkout. Канали `stable` і `beta` використовують встановлення пакетів. Якщо
|
||||
Gateway уже встановлено, `openclaw update` оновлює метадані служби
|
||||
та перезапускає її, якщо ви не передали `--no-restart`.
|
||||
|
||||
## Альтернатива: повторно запустіть інсталятор
|
||||
## Альтернатива: повторно запустити інсталятор
|
||||
|
||||
```bash
|
||||
curl -fsSL https://openclaw.ai/install.sh | bash
|
||||
```
|
||||
|
||||
Додайте `--no-onboard`, щоб пропустити онбординг. Щоб примусово вибрати конкретний тип встановлення через інсталятор, передайте `--install-method git --no-onboard` або `--install-method npm --no-onboard`.
|
||||
Додайте `--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>
|
||||
```
|
||||
|
||||
## Альтернатива: вручну через npm, pnpm або bun
|
||||
## Альтернатива: ручне встановлення через npm, pnpm або bun
|
||||
|
||||
```bash
|
||||
npm i -g openclaw@latest
|
||||
```
|
||||
|
||||
Коли `openclaw update` керує глобальним npm-встановленням, він спочатку встановлює ціль у тимчасовий npm prefix, перевіряє упакований інвентар `dist`, а потім замінює реальне глобальне prefix чистим деревом пакета. Це запобігає накладанню нового пакета npm поверх застарілих файлів зі старого пакета. Якщо команда встановлення завершується помилкою, OpenClaw повторює спробу один раз із `--omit=optional`. Ця повторна спроба допомагає хостам, де native optional dependencies не можуть скомпілюватися, водночас залишаючи початкову помилку видимою, якщо fallback також завершується невдало.
|
||||
Коли `openclaw update` керує глобальним встановленням npm, він спочатку встановлює цільову версію в
|
||||
тимчасовий префікс npm, перевіряє інвентар упакованого `dist`, а потім замінює
|
||||
чисте дерево пакета в реальному глобальному префіксі. Це запобігає накладанню npm
|
||||
нового пакета поверх застарілих файлів зі старого пакета. Якщо команда встановлення завершується помилкою,
|
||||
OpenClaw повторює спробу один раз із `--omit=optional`. Ця повторна спроба допомагає хостам, де нативні
|
||||
необов’язкові залежності не можуть скомпілюватися, водночас зберігаючи видимою початкову помилку,
|
||||
якщо резервний варіант також не спрацює.
|
||||
|
||||
```bash
|
||||
pnpm add -g openclaw@latest
|
||||
@ -96,13 +119,13 @@ bun add -g openclaw@latest
|
||||
### Розширені теми встановлення npm
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Дерево пакетів лише для читання">
|
||||
OpenClaw розглядає упаковані глобальні встановлення як доступні лише для читання під час виконання, навіть коли глобальний каталог пакета доступний для запису поточному користувачу. Встановлення пакетів Plugin розміщуються в npm/git-коренях, що належать OpenClaw, у каталозі конфігурації користувача, а запуск Gateway не змінює дерево пакета OpenClaw.
|
||||
<Accordion title="Дерево пакета лише для читання">
|
||||
OpenClaw розглядає упаковані глобальні встановлення як доступні лише для читання під час виконання, навіть коли глобальний каталог пакета доступний для запису поточному користувачу. Встановлення пакетів Plugin розміщуються в npm/git коренях, що належать OpenClaw, у каталозі користувацької конфігурації, а запуск Gateway не змінює дерево пакета OpenClaw.
|
||||
|
||||
Деякі Linux-конфігурації npm встановлюють глобальні пакети в каталоги, що належать root, наприклад `/usr/lib/node_modules/openclaw`. OpenClaw підтримує таку структуру, оскільки команди встановлення/оновлення Plugin записують дані поза цим глобальним каталогом пакета.
|
||||
Деякі конфігурації npm у Linux встановлюють глобальні пакети в каталоги, що належать root, наприклад `/usr/lib/node_modules/openclaw`. OpenClaw підтримує таке компонування, оскільки команди встановлення й оновлення Plugin записують дані поза цим глобальним каталогом пакета.
|
||||
|
||||
</Accordion>
|
||||
<Accordion title="Посилені systemd-юніти">
|
||||
<Accordion title="Посилені systemd unit">
|
||||
Надайте OpenClaw доступ на запис до його коренів конфігурації/стану, щоб явні встановлення Plugin, оновлення Plugin і очищення doctor могли зберігати свої зміни:
|
||||
|
||||
```ini
|
||||
@ -111,13 +134,13 @@ bun add -g openclaw@latest
|
||||
|
||||
</Accordion>
|
||||
<Accordion title="Попередня перевірка місця на диску">
|
||||
Перед оновленнями пакетів і явними встановленнями Plugin OpenClaw намагається виконати best-effort перевірку вільного місця на цільовому томі. Нестача місця створює попередження з перевіреним шляхом, але не блокує оновлення, оскільки файлові квоти, snapshots і мережеві томи можуть змінитися після перевірки. Фактичне встановлення через менеджер пакетів і післяінсталяційна перевірка залишаються авторитетними.
|
||||
Перед оновленнями пакетів і явними встановленнями Plugin OpenClaw намагається виконати best-effort перевірку місця на диску для цільового тому. Нестача місця створює попередження з перевіреним шляхом, але не блокує оновлення, оскільки квоти файлової системи, snapshot і мережеві томи можуть змінитися після перевірки. Фактичне встановлення через менеджер пакетів і перевірка після встановлення залишаються авторитетними.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Автооновлювач
|
||||
|
||||
Автооновлювач типово вимкнено. Увімкніть його в `~/.openclaw/openclaw.json`:
|
||||
Автооновлювач вимкнено за замовчуванням. Увімкніть його в `~/.openclaw/openclaw.json`:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -133,16 +156,21 @@ bun add -g openclaw@latest
|
||||
}
|
||||
```
|
||||
|
||||
| Канал | Поведінка |
|
||||
| -------- | ------------------------------------------------------------------------------------------------------------------------ |
|
||||
| `stable` | Очікує `stableDelayHours`, потім застосовує з детермінованим jitter у межах `stableJitterHours` (розподілене розгортання). |
|
||||
| `beta` | Перевіряє кожні `betaCheckIntervalHours` (типово: щогодини) і застосовує негайно. |
|
||||
| `dev` | Автоматичне застосування відсутнє. Використовуйте `openclaw update` вручну. |
|
||||
| Канал | Поведінка |
|
||||
| -------- | ------------------------------------------------------------------------------------------------------------- |
|
||||
| `stable` | Чекає `stableDelayHours`, а потім застосовує з детермінованим jitter у межах `stableJitterHours` (поетапне розгортання). |
|
||||
| `beta` | Перевіряє кожні `betaCheckIntervalHours` (за замовчуванням: щогодини) і застосовує негайно. |
|
||||
| `dev` | Без автоматичного застосування. Використовуйте `openclaw update` вручну. |
|
||||
|
||||
Gateway також записує підказку про оновлення під час запуску (вимикається через `update.checkOnStart: false`).
|
||||
Для відкату або відновлення після інциденту встановіть `OPENCLAW_NO_AUTO_UPDATE=1` у середовищі Gateway, щоб заблокувати автоматичні застосування, навіть коли налаштовано `update.auto.enabled`. Підказки про оновлення під час запуску все ще можуть виконуватися, якщо `update.checkOnStart` також не вимкнено.
|
||||
Для downgrade або відновлення після інциденту встановіть `OPENCLAW_NO_AUTO_UPDATE=1` у середовищі Gateway, щоб заблокувати автоматичні застосування навіть коли налаштовано `update.auto.enabled`. Підказки про оновлення під час запуску все ще можуть виконуватися, якщо `update.checkOnStart` також не вимкнено.
|
||||
|
||||
Оновлення через менеджер пакетів, запитані через live Gateway control-plane handler, примусово виконують невідкладений перезапуск без cooldown після заміни пакета. Це запобігає ситуації, коли старий процес у пам’яті залишається достатньо довго, щоб lazy-load chunks із дерева пакета, яке вже було замінено. Shell `openclaw update` залишається рекомендованим шляхом для керованих встановлень, оскільки він може зупинити й перезапустити сервіс навколо оновлення.
|
||||
Оновлення менеджера пакетів, запитані через live обробник control-plane Gateway,
|
||||
примусово виконують restart оновлення без відкладання й без cooldown після заміни пакета. Це
|
||||
не дає старому процесу в пам’яті залишатися достатньо довго, щоб lazy-load фрагменти
|
||||
з дерева пакета, яке вже було замінено. Shell `openclaw update`
|
||||
залишається бажаним шляхом для керованих встановлень, оскільки він може зупинити й
|
||||
перезапустити службу навколо оновлення.
|
||||
|
||||
## Після оновлення
|
||||
|
||||
@ -154,7 +182,7 @@ Gateway також записує підказку про оновлення п
|
||||
openclaw doctor
|
||||
```
|
||||
|
||||
Мігрує конфігурацію, перевіряє політики DM і стан Gateway. Докладніше: [Doctor](/uk/gateway/doctor)
|
||||
Мігрує конфігурацію, аудитує політики DM і перевіряє справність Gateway. Докладніше: [Doctor](/uk/gateway/doctor)
|
||||
|
||||
### Перезапустіть Gateway
|
||||
|
||||
@ -172,7 +200,7 @@ openclaw health
|
||||
|
||||
## Відкат
|
||||
|
||||
### Зафіксуйте версію (npm)
|
||||
### Закріпити версію (npm)
|
||||
|
||||
```bash
|
||||
npm i -g openclaw@<version>
|
||||
@ -184,7 +212,7 @@ openclaw gateway restart
|
||||
`npm view openclaw version` показує поточну опубліковану версію.
|
||||
</Tip>
|
||||
|
||||
### Зафіксуйте commit (source)
|
||||
### Закріпити commit (source)
|
||||
|
||||
```bash
|
||||
git fetch origin
|
||||
@ -193,17 +221,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 оновлювач автоматично bootstrap-ить `pnpm`, коли це потрібно. Якщо бачите помилку bootstrap pnpm/corepack, установіть `pnpm` вручну (або повторно ввімкніть `corepack`) і запустіть оновлення ще раз.
|
||||
- Для `openclaw update --channel dev` на source checkouts засіб оновлення автоматично bootstraps `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): посібники з міграції між основними версіями.
|
||||
- [Doctor](/uk/gateway/doctor): перевірки справності після оновлень.
|
||||
- [Міграція](/uk/install/migrating): посібники з міграції основних версій.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user