Канали випусків

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 stableopenclaw update --channel betaopenclaw 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.

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

Використовуйте --tag, щоб націлитися на певний dist-tag, версію або специфікацію пакета для одного оновлення без зміни вашого збереженого каналу:

# Install a specific versionopenclaw 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 checkoutopenclaw update --channel dev # Install a specific npm package specopenclaw update --tag openclaw@2026.4.1-beta.1 # Install from GitHub main once without persisting the channelopenclaw 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-runopenclaw update --channel beta --dry-runopenclaw update --tag 2026.4.1-beta.1 --dry-runopenclaw 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.

Пов’язане

• Оновлення
• Внутрішня робота інсталятора