Оновлення

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

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

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

openclaw update

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

openclaw update --channel betaopenclaw update --channel devopenclaw update --tag mainopenclaw update --dry-run   # preview without applying

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 для одноразового оновлення пакета.

Для керованих Plugin-ів резервний перехід beta-каналу є попередженням: оновлення ядра може все одно завершитися успішно, тоді як Plugin використовує свій записаний default/latest випуск, бо beta для Plugin недоступна.

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

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

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

# npm package install -> editable git checkoutopenclaw update --channel dev # git checkout -> npm package installopenclaw update --channel stable

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

openclaw update --channel dev --dry-runopenclaw 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, щоб пропустити онбординг. Щоб примусово вибрати конкретний тип встановлення через інсталятор, передайте --install-method git --no-onboard або --install-method npm --no-onboard.

Якщо openclaw update завершується помилкою після етапу встановлення npm-пакета, повторно запустіть інсталятор. Інсталятор не викликає старий засіб оновлення; він запускає глобальне встановлення пакета напряму й може відновити частково оновлене 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 для контрольованих встановлень, бо він може узгодити заміну пакета із запущеним сервісом Gateway. Якщо ви оновлюєте вручну, поки керований Gateway працює, перезапустіть Gateway одразу після завершення роботи менеджера пакетів, щоб старий процес не продовжував обслуговування з уже замінених файлів пакета.

Коли openclaw update керує глобальним npm-встановленням, він спершу встановлює ціль у тимчасовий npm-префікс, перевіряє інвентар упакованого dist, а потім замінює чисте дерево пакета в реальному глобальному префіксі. Це запобігає накладанню npm нового пакета на застарілі файли зі старого пакета. Якщо команда встановлення завершується помилкою, 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). Для відкату або відновлення після інциденту встановіть OPENCLAW_NO_AUTO_UPDATE=1 у середовищі Gateway, щоб заблокувати автоматичні застосування, навіть коли налаштовано update.auto.enabled. Підказки про оновлення під час запуску все ще можуть виконуватися, якщо update.checkOnStart також не вимкнено.

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

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

openclaw doctor

openclaw gateway restart

openclaw health

Відкат

Закріплення версії (npm)

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

Закріплення коміту (джерельний код)

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

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

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

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

Пов’язане

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