Оновлення

Підтримуйте OpenClaw в актуальному стані.

# Рекомендовано: openclaw update

Найшвидший спосіб оновлення. Він визначає тип інсталяції (npm або git), отримує найновішу версію, запускає openclaw doctor і перезапускає Gateway.

openclaw update

Щоб перемкнути канали або вибрати конкретну версію:

openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag main
openclaw update --dry-run   # попередній перегляд без застосування

openclaw update не приймає --verbose. Для діагностики оновлення використовуйте --dry-run, щоб попередньо переглянути заплановані дії, --json для структурованих результатів або openclaw update status --json, щоб перевірити канал і стан доступності. Інсталятор має власний прапорець --verbose, але цей прапорець не є частиною openclaw update.

--channel beta надає перевагу beta, але середовище виконання повертається до stable/latest, коли тег beta відсутній або старіший за найновіший стабільний випуск. Використовуйте --tag beta, якщо вам потрібен сирий npm beta dist-tag для разового оновлення пакета.

Див. Канали розробки, щоб дізнатися про семантику каналів.

# Перемикання між інсталяціями npm і git

Використовуйте канали, коли хочете змінити тип інсталяції. Оновлювач зберігає ваш стан, конфігурацію, облікові дані та робочу область у ~/.openclaw; він змінює лише те, яку інсталяцію коду OpenClaw використовують CLI і Gateway.

# інсталяція npm package -> редагований git checkout
openclaw update --channel dev

# git checkout -> інсталяція npm package
openclaw update --channel stable

Спочатку запустіть із --dry-run, щоб попередньо переглянути точне перемикання режиму інсталяції:

openclaw update --channel dev --dry-run
openclaw update --channel stable --dry-run

Канал dev забезпечує git checkout, збирає його та встановлює глобальний CLI з цього checkout. Канали stable і beta використовують інсталяції пакетів. Якщо Gateway уже встановлено, openclaw update оновлює метадані сервісу і перезапускає його, якщо ви не передасте --no-restart.

# Альтернатива: повторно запустіть інсталятор

curl -fsSL https://openclaw.ai/install.sh | bash

Додайте --no-onboard, щоб пропустити onboarding. Щоб примусово вибрати конкретний тип інсталяції через інсталятор, передайте --install-method git --no-onboard або --install-method npm --no-onboard.

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

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm

Щоб зафіксувати відновлення на конкретній версії або dist-tag, додайте --version:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --version <version-or-dist-tag>

# Альтернатива: ручне встановлення через npm, pnpm або bun

npm i -g openclaw@latest

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

Коли openclaw update керує глобальною інсталяцією npm, він спершу встановлює ціль у тимчасовий npm prefix, перевіряє інвентар упакованого dist, а потім замінює чисте дерево package у справжньому глобальному prefix. Це запобігає накладанню npm нового package поверх застарілих файлів зі старого package. Якщо команда інсталяції завершується помилкою, OpenClaw повторює спробу один раз із --omit=optional. Ця повторна спроба допомагає хостам, де нативні необов’язкові залежності не можуть скомпілюватися, зберігаючи початкову помилку видимою, якщо резервний варіант також завершується помилкою.

pnpm add -g openclaw@latest

bun add -g openclaw@latest

# Розширені теми інсталяції npm

ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp

# Автооновлювач

Автооновлювач вимкнено за замовчуванням. Увімкніть його в ~/.openclaw/openclaw.json:

{
  update: {
    channel: "stable",
    auto: {
      enabled: true,
      stableDelayHours: 6,
      stableJitterHours: 12,
      betaCheckIntervalHours: 1,
    },
  },
}

Gateway також записує підказку про оновлення під час запуску (вимкніть за допомогою update.checkOnStart: false). Для downgrade або відновлення після інциденту встановіть OPENCLAW_NO_AUTO_UPDATE=1 у середовищі Gateway, щоб заблокувати автоматичні застосування навіть тоді, коли налаштовано update.auto.enabled. Підказки про оновлення під час запуску все ще можуть виконуватися, якщо update.checkOnStart також не вимкнено.

Оновлення через менеджер пакетів, запитані через live handler control-plane Gateway, примусово виконують невідкладний перезапуск оновлення без cooldown після заміни package. Це запобігає тому, щоб старий процес у пам’яті залишався достатньо довго для lazy-load фрагментів із дерева package, яке вже було замінене. Shell-команда openclaw update залишається бажаним шляхом для керованих інсталяцій, бо вона може зупинити та перезапустити сервіс навколо оновлення.

# Після оновлення

openclaw doctor

openclaw gateway restart

openclaw health

# Відкат

# Зафіксувати версію (npm)

npm i -g openclaw@<version>
openclaw doctor
openclaw gateway restart

# Зафіксувати commit (source)

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
pnpm install && pnpm build
openclaw gateway restart

Щоб повернутися до найновішої версії: git checkout main && git pull.

# Якщо ви застрягли

• Знову запустіть openclaw doctor і уважно прочитайте вивід.
• Для openclaw update --channel dev на source checkout оновлювач автоматично bootstrap-ить pnpm, коли це потрібно. Якщо ви бачите помилку bootstrap pnpm/corepack, встановіть pnpm вручну (або повторно увімкніть corepack) і запустіть оновлення ще раз.
• Перевірте: Усунення несправностей
• Запитайте в Discord: https://discord.gg/clawd

# Пов’язане

• Огляд інсталяції: усі способи інсталяції.
• Doctor: перевірки стану після оновлень.
• Міграція: посібники з міграції основних версій.