Каналы разработки

Последнее обновление: 2026-01-21

OpenClaw предоставляет три канала обновлений:

• stable: npm dist-tag latest.
• beta: npm dist-tag beta (сборки на тестировании).
• dev: текущая голова ветки main (git). npm dist-tag: dev (когда опубликован).

Сборки публикуются в beta, тестируются, затем проверенная сборка продвигается в latest без изменения номера версии — dist-tag’и являются источником истины для npm-установок.

Переключение каналов

Git checkout:

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev

• stable/beta переключаются на последний подходящий тег (часто это один и тот же тег).
• dev переключается на main и делает rebase на upstream.

npm/pnpm глобальная установка:

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev

Обновление происходит через соответствующий npm dist-tag (latest, beta, dev).

Когда вы явно переключаете канал с помощью --channel, OpenClaw также приводит в соответствие способ установки:

• dev создаёт git-клон (по умолчанию ~/openclaw, можно переопределить через OPENCLAW_GIT_DIR), обновляет его и устанавливает глобальный CLI из этого клона.
• stable/beta устанавливают из npm с соответствующим dist-tag.

Совет: если хотите stable и dev параллельно — держите два клона и направляйте шлюз на стабильный.

Плагины и каналы

При переключении каналов через openclaw update OpenClaw также синхронизирует источники плагинов:

• dev предпочитает встроенные плагины из git-клона.
• stable и beta восстанавливают npm-установленные пакеты плагинов.

Рекомендации по тегам

• Ставьте теги на релизы, на которые должны попадать git-клоны (vYYYY.M.D для stable, vYYYY.M.D-beta.N для beta).
• Формат vYYYY.M.D.beta.N тоже распознаётся для совместимости, но предпочтительнее -beta.N.
• Устаревшие теги vYYYY.M.D-<patch> по-прежнему распознаются как stable (не beta).
• Теги должны быть неизменяемыми: никогда не перемещайте и не переиспользуйте тег.
• npm dist-tag’и остаются источником истины для npm-установок:
  • latest — stable
  • beta — кандидат на релиз
  • dev — snapshot ветки main (опционально)

Доступность приложения macOS

Beta- и dev-сборки могут не включать релиз macOS-приложения. Это нормально:

• Git-тег и npm dist-tag всё равно могут быть опубликованы.
• Укажите «нет сборки macOS для этой beta» в release notes или changelog.