---
read_when:
    - Ви хочете безпечно оновити вихідну checkout-копію
    - Вам потрібно зрозуміти скорочену поведінку `--update`
summary: Довідка CLI для `openclaw update` (відносно безпечне оновлення джерела + автоматичний перезапуск Gateway)
title: Оновлення
x-i18n:
    generated_at: "2026-04-23T22:57:53Z"
    model: gpt-5.4
    provider: openai
    source_hash: c7ab28ae6fe91c094826ccbd9fa11c5d7c41849cc95d570a634a0721b82f0e3a
    source_path: cli/update.md
    workflow: 15
---

# `openclaw update`

Безпечно оновлюйте OpenClaw і перемикайтеся між каналами stable/beta/dev.

Якщо ви встановили через **npm/pnpm/bun** (глобальне встановлення, без метаданих git),
оновлення відбуваються через потік менеджера пакетів у розділі [Оновлення](/uk/install/updating).

## Використання

```bash
openclaw update
openclaw update status
openclaw update wizard
openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag beta
openclaw update --tag main
openclaw update --dry-run
openclaw update --no-restart
openclaw update --yes
openclaw update --json
openclaw --update
```

## Параметри

- `--no-restart`: пропустити перезапуск служби Gateway після успішного оновлення.
- `--channel <stable|beta|dev>`: установити канал оновлення (git + npm; зберігається в конфігурації).
- `--tag <dist-tag|version|spec>`: перевизначити цільовий пакет лише для цього оновлення. Для встановлень через менеджер пакетів `main` зіставляється з `github:openclaw/openclaw#main`.
- `--dry-run`: попередній перегляд запланованих дій оновлення (канал/тег/цільовий об’єкт/потік перезапуску) без запису конфігурації, встановлення, синхронізації plugin або перезапуску.
- `--json`: вивести машинозчитуваний JSON `UpdateRunResult`, зокрема
  `postUpdate.plugins.integrityDrifts`, коли під час синхронізації plugin після
  оновлення виявлено розбіжність артефактів npm plugin.
- `--timeout <seconds>`: тайм-аут для кожного кроку (типово 1200 с).
- `--yes`: пропустити запити на підтвердження (наприклад, підтвердження зниження версії)

Примітка: зниження версії потребує підтвердження, оскільки старіші версії можуть пошкодити конфігурацію.

## `update status`

Показати активний канал оновлення + тег/гілку/SHA git (для вихідних checkout-копій), а також доступність оновлення.

```bash
openclaw update status
openclaw update status --json
openclaw update status --timeout 10
```

Параметри:

- `--json`: вивести машинозчитуваний JSON статусу.
- `--timeout <seconds>`: тайм-аут для перевірок (типово 3 с).

## `update wizard`

Інтерактивний потік для вибору каналу оновлення та підтвердження, чи потрібно перезапустити Gateway
після оновлення (типово виконується перезапуск). Якщо ви виберете `dev` без checkout-копії git,
буде запропоновано її створити.

Параметри:

- `--timeout <seconds>`: тайм-аут для кожного кроку оновлення (типово `1200`)

## Що він робить

Коли ви явно перемикаєте канали (`--channel ...`), OpenClaw також
узгоджує спосіб встановлення:

- `dev` → забезпечує наявність checkout-копії git (типово: `~/openclaw`, перевизначається через `OPENCLAW_GIT_DIR`),
  оновлює її та встановлює глобальний CLI із цієї checkout-копії.
- `stable` → встановлює з npm через `latest`.
- `beta` → надає перевагу dist-tag `beta` у npm, але повертається до `latest`, якщо `beta`
  відсутній або старіший за поточний stable-реліз.

Core auto-updater Gateway (коли він увімкнений через конфігурацію) повторно використовує цей самий шлях оновлення.

Для встановлень через менеджер пакетів `openclaw update` визначає цільову
версію пакета перед викликом менеджера пакетів. Якщо встановлена версія точно
збігається з цільовою і не потрібно зберігати зміну каналу оновлення, команда
завершується як пропущена до встановлення пакета, синхронізації plugin, оновлення completion
або перезапуску Gateway.

## Потік checkout-копії git

Канали:

- `stable`: переключитися на останній тег без beta, потім виконати build + doctor.
- `beta`: надавати перевагу останньому тегу `-beta`, але повертатися до останнього stable-тегу,
  якщо `beta` відсутній або старіший.
- `dev`: переключитися на `main`, потім виконати fetch + rebase.

На високому рівні:

1. Потребує чистого робочого дерева (без незакомічених змін).
2. Перемикається на вибраний канал (тег або гілку).
3. Отримує зміни з upstream (лише для dev).
4. Лише dev: виконує попередню перевірку lint + TypeScript build у тимчасовому worktree; якщо останній коміт не проходить перевірку, відступає назад до 10 комітів, щоб знайти найновіший build, що проходить без помилок.
5. Виконує rebase на вибраний коміт (лише для dev).
6. Встановлює залежності за допомогою менеджера пакетів репозиторію. Для checkout-копій 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.

Якщо точне оновлення npm plugin із зафіксованою версією визначає артефакт, цілісність якого
відрізняється від збереженого запису встановлення, `openclaw update` перериває це оновлення
артефакту plugin замість його встановлення. Перевстановлюйте або оновлюйте plugin явно лише після перевірки,
що ви довіряєте новому артефакту.

Якщо ініціалізація pnpm усе ще не вдається, оновлювач тепер зупиняється раніше з помилкою, специфічною для менеджера пакетів, замість спроби виконати `npm run build` усередині checkout-копії.

## Скорочення `--update`

`openclaw --update` переписується в `openclaw update` (зручно для оболонок і скриптів запуску).

## Пов’язано

- `openclaw doctor` (пропонує спочатку запустити оновлення для checkout-копій git)
- [Канали розробки](/uk/install/development-channels)
- [Оновлення](/uk/install/updating)
- [Довідка CLI](/uk/cli)
