Перейти до основного вмісту
OpenClaw постачається з трьома каналами оновлень:
  • stable: npm dist-tag latest. Рекомендовано для більшості користувачів.
  • beta: npm dist-tag beta, коли він актуальний; якщо beta відсутній або старіший за останній стабільний випуск, потік оновлення повертається до latest.
  • dev: рухома вершина main (git). npm dist-tag: dev (коли опубліковано). Гілка main призначена для експериментів і активної розробки. Вона може містити незавершені функції або несумісні зміни. Не використовуйте її для production gateways.
Зазвичай ми спершу постачаємо стабільні збірки в beta, тестуємо їх там, а потім запускаємо явний крок просування, який переносить перевірену збірку до latest без зміни номера версії. Мейнтейнери також можуть опублікувати стабільний випуск безпосередньо в latest, коли це потрібно. Dist-tags є джерелом істини для встановлень npm.

​
Перемикання каналів

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
--channel зберігає ваш вибір у конфігурації (update.channel) і узгоджує метод встановлення:
  • stable (встановлення пакетів): оновлення через npm dist-tag latest.
  • beta (встановлення пакетів): надає перевагу npm dist-tag beta, але повертається до latest, коли beta відсутній або старіший за поточний стабільний тег.
  • stable (встановлення з git): переходить на останній стабільний git-тег, виключаючи semver prerelease-теги, як-от -alpha.N, -beta.N, -rc.N, -dev.N, -next.N, -preview.N, -canary.N, -nightly.N та інші prerelease- суфікси.
  • beta (встановлення з git): надає перевагу останньому beta git-тегу, але повертається до останнього стабільного git-тегу, коли beta відсутній або старіший.
  • dev: забезпечує git checkout (типово ~/openclaw або $OPENCLAW_HOME/openclaw, коли встановлено OPENCLAW_HOME; перевизначте через OPENCLAW_GIT_DIR), перемикається на main, виконує rebase на upstream, збирає та встановлює глобальний CLI з цього checkout.
Якщо ви хочете мати stable і dev паралельно, тримайте два клони й спрямовуйте свій gateway на стабільний.

​
Одноразове націлювання на версію або тег

Використовуйте --tag, щоб націлитися на певний dist-tag, версію або специфікацію пакета для одного оновлення без зміни вашого збереженого каналу: 
# Install a specific version
openclaw update --tag 2026.4.1-beta.1

# Install from the beta dist-tag (one-off, does not persist)
openclaw update --tag beta

# Switch to the moving GitHub main checkout
openclaw update --channel dev

# Install a specific npm package spec
openclaw update --tag openclaw@2026.4.1-beta.1

# Install from GitHub main once without persisting the channel
openclaw update --tag main
Примітки:
  • --tag застосовується лише до встановлень пакетів (npm). Встановлення з git ігнорують його.
  • Тег не зберігається. Ваш наступний openclaw update використовує налаштований канал, як зазвичай.
  • Для встановлень пакетів OpenClaw попередньо пакує специфікації джерела GitHub/git у тимчасовий tarball перед staged npm install. Використовуйте --channel dev або --install-method git --version main, коли вам потрібен рухомий checkout main як постійне встановлення.
  • Захист від downgrade: якщо цільова версія старіша за вашу поточну версію, OpenClaw запитує підтвердження (пропустіть за допомогою --yes).
  • --channel beta відрізняється від --tag beta: потік каналу може повернутися до stable/latest, коли beta відсутній або старіший, тоді як --tag beta націлюється на сирий dist-tag beta для цього одного запуску.

​
Dry run

Попередньо перегляньте, що зробив би openclaw update, без внесення змін: 
openclaw update --dry-run
openclaw update --channel beta --dry-run
openclaw update --tag 2026.4.1-beta.1 --dry-run
openclaw update --dry-run --json
Dry run показує ефективний канал, цільову версію, заплановані дії та чи потрібне підтвердження downgrade.

​
Plugins і канали

Коли ви перемикаєте канали за допомогою openclaw update, OpenClaw також синхронізує джерела plugin:
  • dev надає перевагу bundled plugins із git checkout.
  • stable і beta відновлюють встановлені через npm packages plugin.
  • Встановлені через npm plugins оновлюються після завершення оновлення ядра.

​
Перевірка поточного стану

openclaw update status
Показує активний канал, тип встановлення (git або package), поточну версію та джерело (config, git tag, git branch або default).

​
Найкращі практики тегування

  • Позначайте тегами випуски, на які мають потрапляти git checkouts (vYYYY.M.PATCH для stable, vYYYY.M.PATCH-beta.N для beta; іменовані semver prerelease-суфікси, як-от -alpha.N, -rc.N і -next.N, не є стабільними цілями).
  • Застарілі числові stable-теги, як-от vYYYY.M.PATCH-1 і v1.0.1-1, усе ще розпізнаються як стабільні git-теги для сумісності.
  • vYYYY.M.PATCH.beta.N також розпізнається для сумісності, але надавайте перевагу -beta.N.
  • Зберігайте теги незмінними: ніколи не переміщуйте й не використовуйте тег повторно.
  • npm dist-tags залишаються джерелом істини для встановлень npm:
    • latest -> stable
    • beta -> кандидатна збірка або beta-first stable build
    • dev -> main snapshot (необов’язково)

​
Доступність застосунку macOS

Beta- і dev-збірки можуть не містити випуску застосунку macOS. Це нормально:
  • Git-тег і npm dist-tag усе одно можуть бути опубліковані.
  • Зазначте “немає збірки macOS для цієї beta” в нотатках до випуску або changelog.

​
Пов’язане