diff --git a/docs/uk/cli/update.md b/docs/uk/cli/update.md index c32d7995b..779f4a99f 100644 --- a/docs/uk/cli/update.md +++ b/docs/uk/cli/update.md @@ -1,24 +1,24 @@ --- read_when: - - Ви хочете безпечно оновити вихідну копію репозиторію + - Ви хочете безпечно оновити вихідну копію коду - Вам потрібно зрозуміти скорочену поведінку `--update` -summary: Довідник CLI для `openclaw update` (відносно безпечне оновлення джерела + автоматичний перезапуск Gateway) +summary: Довідник CLI для `openclaw update` (досить безпечне оновлення джерела + автоматичний перезапуск Gateway) title: Оновлення x-i18n: - generated_at: "2026-04-26T08:15:42Z" + generated_at: "2026-04-26T09:50:15Z" model: gpt-5.4 provider: openai - source_hash: b06cab7f4eee12e0fa474b2ea0fb2848fb4899517f9446369888391d2eb3ea9e + source_hash: e86e7f8ffbf3f4ccd0787ba06aead35cb96e8db98c5d32c99b18ef9fda62efd6 source_path: cli/update.md workflow: 15 --- # `openclaw update` -Безпечно оновлюйте OpenClaw і перемикайтеся між каналами stable/beta/dev. +Безпечно оновіть OpenClaw і перемикайтеся між каналами stable/beta/dev. -Якщо ви встановили через **npm/pnpm/bun** (глобальне встановлення без метаданих git), -оновлення виконуються через потік менеджера пакетів у розділі [Оновлення](/uk/install/updating). +Якщо ви встановили через **npm/pnpm/bun** (глобальне встановлення, без метаданих git), +оновлення відбуваються через потік менеджера пакетів у [Оновлення](/uk/install/updating). ## Використання @@ -42,16 +42,16 @@ openclaw --update - `--no-restart`: пропустити перезапуск служби Gateway після успішного оновлення. Оновлення через менеджер пакетів, які перезапускають Gateway, перевіряють, що перезапущена служба повідомляє очікувану оновлену версію, перш ніж команда завершиться успішно. - `--channel `: встановити канал оновлення (git + npm; зберігається в конфігурації). - `--tag `: перевизначити цільовий пакет лише для цього оновлення. Для пакетних встановлень `main` зіставляється з `github:openclaw/openclaw#main`. -- `--dry-run`: попередньо показати заплановані дії оновлення (канал/тег/цільовий об’єкт/потік перезапуску) без запису конфігурації, встановлення, синхронізації Plugin або перезапуску. -- `--json`: вивести машиночитний JSON `UpdateRunResult`, включно з `postUpdate.plugins.integrityDrifts`, якщо під час післяоновлювальної синхронізації Plugin виявлено розбіжність артефактів npm Plugin. -- `--timeout `: тайм-аут для кожного кроку (типово 1200 с). -- `--yes`: пропустити запити на підтвердження (наприклад, підтвердження зниження версії) +- `--dry-run`: попередньо показати заплановані дії оновлення (канал/тег/ціль/потік перезапуску) без запису конфігурації, встановлення, синхронізації Plugin або перезапуску. +- `--json`: вивести машинозчитуваний JSON `UpdateRunResult`, включно з `postUpdate.plugins.integrityDrifts`, коли під час післяоновлювальної синхронізації Plugin виявлено розбіжність артефактів npm Plugin. +- `--timeout `: тайм-аут для кожного кроку (типово 1800 с). +- `--yes`: пропустити запити підтвердження (наприклад, підтвердження пониження версії) -Примітка: зниження версії потребує підтвердження, оскільки старіші версії можуть пошкодити конфігурацію. +Примітка: пониження версії вимагає підтвердження, оскільки старіші версії можуть зламати конфігурацію. ## `update status` -Показати активний канал оновлення + тег/гілку/SHA git (для вихідних копій репозиторію), а також доступність оновлення. +Показати активний канал оновлення + тег/гілку/SHA git (для вихідних копій коду), а також доступність оновлень. ```bash openclaw update status @@ -61,77 +61,76 @@ openclaw update status --timeout 10 Параметри: -- `--json`: вивести машиночитний JSON стану. +- `--json`: вивести машинозчитуваний JSON статусу. - `--timeout `: тайм-аут для перевірок (типово 3 с). ## `update wizard` -Інтерактивний потік для вибору каналу оновлення та підтвердження того, чи потрібно перезапускати Gateway -після оновлення (типово перезапуск виконується). Якщо ви виберете `dev` без checkout git, він -запропонує створити його. +Інтерактивний потік для вибору каналу оновлення та підтвердження, чи перезапускати Gateway +після оновлення (типово — перезапускати). Якщо ви виберете `dev` без вихідної копії git, +буде запропоновано її створити. Параметри: -- `--timeout `: тайм-аут для кожного кроку оновлення (типово `1200`) +- `--timeout `: тайм-аут для кожного кроку оновлення (типово `1800`) -## Що він робить +## Що це робить -Коли ви явно перемикаєте канали (`--channel ...`), OpenClaw також узгоджує -спосіб встановлення: +Коли ви явно перемикаєте канали (`--channel ...`), OpenClaw також підтримує +узгодженість зі способом встановлення: -- `dev` → забезпечує наявність checkout git (типово: `~/openclaw`, перевизначається через `OPENCLAW_GIT_DIR`), - оновлює його та встановлює глобальний CLI із цього checkout. -- `stable` → встановлює з npm за допомогою `latest`. -- `beta` → надає перевагу dist-tag npm `beta`, але повертається до `latest`, якщо beta - відсутня або старіша за поточний стабільний випуск. +- `dev` → забезпечує наявність вихідної копії git (типово: `~/openclaw`, перевизначається через `OPENCLAW_GIT_DIR`), + оновлює її та встановлює глобальний CLI з цієї вихідної копії. +- `stable` → встановлює з npm, використовуючи `latest`. +- `beta` → надає перевагу npm dist-tag `beta`, але повертається до `latest`, якщо beta + відсутня або старіша за поточний стабільний реліз. -Автооновлювач ядра Gateway (якщо ввімкнений через конфігурацію) повторно використовує цей самий шлях оновлення. +Автооновлювач ядра Gateway (якщо його ввімкнено через конфігурацію) повторно використовує цей самий шлях оновлення. -Для встановлень через менеджер пакетів `openclaw update` визначає цільову -версію пакета перед викликом менеджера пакетів. Навіть якщо встановлена версія +Для встановлень через менеджер пакетів `openclaw update` визначає цільову версію пакета +перед викликом менеджера пакетів. Навіть якщо встановлена версія вже відповідає цільовій, команда оновлює глобальне встановлення пакета, -потім запускає синхронізацію Plugin, оновлення completion і перезапуск. Це підтримує узгодженість -пакованих sidecar-компонентів і записів Plugin, що належать каналу, з установленою збіркою OpenClaw. +потім виконує синхронізацію Plugin, оновлення completion і перезапуск. Це підтримує +узгодженість упакованих sidecar і записів Plugin, що належать каналу, зі встановленою збіркою OpenClaw. -## Потік checkout git +## Потік для вихідної копії git Канали: -- `stable`: checkout останнього тега без beta, потім build + doctor. -- `beta`: надає перевагу останньому тегу `-beta`, але повертається до останнього стабільного тега, +- `stable`: переключає на останній тег без beta, потім виконує build + doctor. +- `beta`: надає перевагу останньому тегу `-beta`, але повертається до останнього стабільного тегу, якщо beta відсутня або старіша. -- `dev`: checkout `main`, потім fetch + rebase. +- `dev`: переключає на `main`, потім виконує fetch + rebase. -На високому рівні: +Узагальнено: -1. Потрібна чиста робоча директорія (без незакомічених змін). +1. Потребує чистого робочого дерева (без незакомічених змін). 2. Перемикається на вибраний канал (тег або гілку). 3. Виконує fetch з upstream (лише для dev). -4. Лише для dev: попередня перевірка lint + збірка TypeScript у тимчасовій робочій директорії; якщо поточна вершина не проходить, відступає назад максимум на 10 комітів, щоб знайти найновішу збірку, яка проходить без помилок. +4. Лише для dev: попередня перевірка lint + збірка TypeScript у тимчасовому робочому дереві; якщо вершина не проходить, повертається назад до 10 комітів, щоб знайти найновішу збірку, яка проходить перевірку. 5. Виконує rebase на вибраний коміт (лише для dev). -6. Встановлює залежності за допомогою менеджера пакетів репозиторію. Для checkout із pnpm засіб оновлення за потреби ініціалізує `pnpm` (спочатку через `corepack`, потім через тимчасовий резервний варіант `npm install pnpm@10`) замість запуску `npm run build` всередині робочого простору pnpm. -7. Виконує build + build для Control UI. +6. Встановлює залежності за допомогою менеджера пакетів репозиторію. Для вихідних копій pnpm засіб оновлення за потреби ініціалізує `pnpm` (спочатку через `corepack`, потім через тимчасовий резервний варіант `npm install pnpm@10`) замість виконання `npm run build` усередині workspace pnpm. +7. Виконує build + build Control UI. 8. Запускає `openclaw doctor` як фінальну перевірку «безпечного оновлення». -9. Синхронізує Plugin з активним каналом (dev використовує вбудовані Plugin; stable/beta використовують npm) і оновлює Plugin, встановлені через npm. +9. Синхронізує Plugin з активним каналом (dev використовує вбудовані Plugin; stable/beta використовують npm) та оновлює Plugin, встановлені через npm. -Якщо точне оновлення закріпленого npm Plugin визначає артефакт, чия цілісність -відрізняється від збереженого запису встановлення, `openclaw update` перериває це оновлення -артефакту Plugin замість його встановлення. Перевстановлюйте або оновлюйте Plugin явно -лише після перевірки, що ви довіряєте новому артефакту. +Якщо оновлення точно закріпленого npm Plugin визначає артефакт, чия цілісність +відрізняється від збереженого запису встановлення, `openclaw update` перериває оновлення +цього артефакту Plugin замість його встановлення. Перевстановлюйте або оновлюйте Plugin +явно лише після перевірки, що ви довіряєте новому артефакту. -Помилки післяоновлювальної синхронізації Plugin завершують оновлення з помилкою та зупиняють подальші дії -з перезапуском. Виправте помилку встановлення/оновлення Plugin, а потім повторно запустіть +Збої післяоновлювальної синхронізації Plugin призводять до збою результату оновлення та зупиняють подальші дії з перезапуску. Виправте помилку встановлення/оновлення Plugin, а потім повторно запустіть `openclaw update`. -Якщо ініціалізація pnpm усе ще не вдається, засіб оновлення тепер зупиняється раніше з помилкою, специфічною для менеджера пакетів, замість спроби виконати `npm run build` всередині checkout. +Якщо ініціалізація pnpm все одно завершується невдачею, засіб оновлення тепер зупиняється раніше з помилкою, специфічною для менеджера пакетів, замість спроби виконати `npm run build` усередині вихідної копії. ## Скорочення `--update` -`openclaw --update` переписується на `openclaw update` (зручно для оболонок і скриптів запуску). +`openclaw --update` переписується в `openclaw update` (корисно для оболонок і скриптів запуску). ## Пов’язане -- `openclaw doctor` (пропонує спочатку запустити оновлення для checkout git) +- `openclaw doctor` (пропонує спочатку запустити оновлення для вихідних копій git) - [Канали розробки](/uk/install/development-channels) - [Оновлення](/uk/install/updating) - [Довідник CLI](/uk/cli)