---
read_when:
    - Ви хочете безпечно оновити робочу копію вихідного коду
    - Вам потрібно зрозуміти поведінку скороченого запису `--update`
summary: Довідка CLI для `openclaw update` (відносно безпечне оновлення джерела + автоматичний перезапуск Gateway)
title: Оновити
x-i18n:
    generated_at: "2026-04-28T11:08:06Z"
    model: gpt-5.5
    provider: openai
    source_hash: 9cd4be6be8f6ae7df501f8bce3d208dd507ae5a1539f9772101cd844dcd93976
    source_path: cli/update.md
    workflow: 16
---

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

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

## `update status`

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

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

Параметри:

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

## `update wizard`

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

Параметри:

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

## Що це робить

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

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

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

Для встановлень через менеджер пакетів `openclaw update` визначає цільову версію
пакета перед викликом менеджера пакетів. Глобальні встановлення npm використовують поетапне
встановлення: OpenClaw встановлює новий пакет у тимчасовий npm-префікс, перевіряє
запакований інвентар `dist` там, а потім замінює це чисте дерево пакета в
реальному глобальному префіксі. Якщо перевірка не вдається, післяоновлювальні doctor, синхронізація plugin і
робота з перезапуску не запускаються з підозрілого дерева. Навіть коли встановлена версія
вже збігається з цільовою, команда оновлює глобальне встановлення пакета,
а потім запускає синхронізацію plugin, оновлення завершення основних команд і роботу з перезапуску. Це
підтримує узгодженість запакованих sidecar і записів plugin, що належать каналу, з
установленою збіркою OpenClaw, залишаючи повні перебудови завершення команд plugin для
явних запусків `openclaw completion --write-state`.

Коли встановлено локальну керовану службу Gateway і перезапуск увімкнено,
оновлення через менеджер пакетів зупиняють запущену службу перед заміною дерева
пакета, потім оновлюють метадані служби з оновленого встановлення, перезапускають
службу та перевіряють, що перезапущений Gateway повідомляє очікувану версію. З
`--no-restart` заміна пакета все одно виконується, але керована служба не
зупиняється й не перезапускається, тому запущений Gateway може зберігати старий код, доки ви не перезапустите
його вручну.

## Потік git checkout

### Вибір каналу

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

### Кроки оновлення

<Steps>
  <Step title="Перевірити чистий worktree">
    Потребує відсутності незакомічених змін.
  </Step>
  <Step title="Перемкнути канал">
    Перемикає на вибраний канал (тег або гілку).
  </Step>
  <Step title="Отримати upstream">
    Лише dev.
  </Step>
  <Step title="Передпольотна збірка (лише dev)">
    Запускає lint і TypeScript build у тимчасовому worktree. Якщо tip не проходить, відступає назад до 10 комітів, щоб знайти найновішу чисту збірку.
  </Step>
  <Step title="Rebase">
    Виконує rebase на вибраний коміт (лише dev).
  </Step>
  <Step title="Встановити залежності">
    Використовує менеджер пакетів репозиторію. Для pnpm checkout оновлювач bootstraps `pnpm` на вимогу (спершу через `corepack`, потім через тимчасовий fallback `npm install pnpm@10`) замість запуску `npm run build` усередині pnpm workspace.
  </Step>
  <Step title="Зібрати Control UI">
    Збирає gateway і Control UI.
  </Step>
  <Step title="Запустити doctor">
    `openclaw doctor` запускається як фінальна перевірка безпечного оновлення.
  </Step>
  <Step title="Синхронізувати plugins">
    Синхронізує plugins з активним каналом. Dev використовує bundled plugins; stable і beta використовують npm. Оновлює plugins, установлені через npm.
  </Step>
</Steps>

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

<Note>
Збої післяоновлювальної синхронізації plugin позначають результат оновлення як невдалий і зупиняють подальшу роботу з перезапуску. Виправте помилку встановлення або оновлення plugin, потім повторно запустіть `openclaw update`.

Коли оновлений Gateway запускається, runtime-залежності ввімкнених bundled plugin готуються перед активацією plugin. Перезапуски, спричинені оновленням, завершують будь-яке активне staging runtime-залежностей перед закриттям Gateway, тому перезапуски service manager не переривають npm install, що виконується.

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

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

`openclaw --update` переписується в `openclaw update` (корисно для shell і launcher scripts).

## Пов’язане

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