Skip to main content
OpenClaw поставляется с четырьмя каналами обновлений:
  • stable: dist-tag npm latest. Рекомендуется большинству пользователей.
  • extended-stable: dist-tag npm extended-stable. Совершенно новый канал пакетов за предыдущий поддерживаемый месяц. Он предназначен только для пакетов, а установка выполняется только в интерактивном режиме на переднем плане. При сохранённом выборе отображаются доступные только для чтения подсказки об обновлениях, если включён update.checkOnStart, но обновления никогда не применяются автоматически.
  • beta: dist-tag npm beta. Использует latest, если beta отсутствует или старше текущего стабильного выпуска.
  • dev: постоянно обновляемая вершина main (git). При публикации используется dist-tag npm dev. main предназначен для экспериментов и активной разработки; он может содержать незавершённые функции или несовместимые изменения. Не используйте его для рабочих Gateway.
Стабильные сборки обычно сначала выпускаются в канале beta, проходят там проверку, а затем переводятся в latest без повышения версии. Сопровождающие также могут публиковать непосредственно в latest. Dist-tag являются источником истины для установок npm.

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

--channel сохраняет выбор в параметре update.channel конфигурации и управляет обоими способами установки: Для установок git dev рабочая копия по умолчанию находится в ~/openclaw (или $OPENCLAW_HOME/openclaw, если задан OPENCLAW_HOME); переопределите это с помощью OPENCLAW_GIT_DIR.
Чтобы использовать stable и dev параллельно, создайте две отдельные рабочие копии и направьте каждый Gateway на собственную.

​
Однократный выбор версии или тега

Используйте --tag, чтобы выбрать конкретный dist-tag, версию или спецификацию пакета для одного обновления без изменения сохранённого канала:
Примечания:
  • --tag применяется только к установкам пакетов (npm); установки git его игнорируют.
  • Тег не сохраняется; следующий запуск openclaw update использует настроенный канал.
  • --tag main сопоставляется с совместимой с npm спецификацией github:openclaw/openclaw#main для этого одного запуска. Для постоянной установки из обновляемой ветки main используйте openclaw update --channel dev (установки пакетов переключатся на рабочую копию git) или переустановите с помощью метода git установщика: curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --version main. Способ установки через npm сразу отклоняет цели, указывающие на источники GitHub/git, и предлагает вместо этого использовать метод git.
  • Защита от понижения версии: если целевая версия старше текущей, OpenClaw запрашивает подтверждение (пропустите его с помощью --yes).
  • Extended-stable всегда использует точную проверенную целевую версию пакета. Это не однократный псевдоним для --tag extended-stable, а --tag нельзя сочетать с фактически выбранным каналом extended-stable.
  • --channel beta отличается от --tag beta: при выборе канала может использоваться stable/latest, если beta отсутствует или старше, тогда как --tag beta всегда выбирает исходный dist-tag beta для этого одного запуска.

​
Пробный запуск

Просмотрите, что сделает openclaw update, без внесения изменений:
Пробный запуск сообщает фактический канал, целевую версию, запланированные действия, а также необходимость подтверждения понижения версии.

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

Переключение каналов с помощью openclaw update также синхронизирует источники плагинов:
  • dev переключает установленные плагины, имеющие встроенные аналоги, обратно на встроенный источник (рабочую копию git).
  • stable и beta восстанавливают пакеты плагинов, установленные через npm или ClawHub.
  • extended-stable разрешает подходящие официальные плагины npm с пустым намерением, намерением по умолчанию или намерением latest в точную установленную версию ядра. Во время выполнения он не запрашивает теги @extended-stable плагинов.
  • Плагины, установленные через npm, обновляются после завершения обновления ядра.

​
Проверка текущего состояния

Показывает активный канал с указанием определившего его источника (конфигурация, тег git, ветка git, установленная версия или значение по умолчанию), тип установки (git или пакет), текущую версию и наличие обновления.

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

  • Помечайте тегами выпуски, на которых должны останавливаться рабочие копии git: vYYYY.M.PATCH для stable, vYYYY.M.PATCH-beta.N для beta. Именованные суффиксы предварительных выпусков, такие как -alpha.N, -rc.N и -next.N, не являются целевыми версиями stable или beta.
  • Устаревшие числовые стабильные теги, такие как vYYYY.M.PATCH-1 и v1.0.1-1, по-прежнему распознаются как стабильные теги git для совместимости.
  • vYYYY.M.PATCH.beta.N (с точками в качестве разделителей) также распознаётся для совместимости; предпочитайте -beta.N.
  • Сохраняйте теги неизменными: никогда не перемещайте и не используйте тег повторно.
  • Dist-tag npm остаются источником истины для установок npm:
    • latest -> stable
    • extended-stable -> выпуск пакета за предыдущий поддерживаемый месяц
    • beta -> сборка-кандидат или стабильная сборка, сначала выпущенная как beta
    • dev -> снимок main (необязательно)

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

Сборки beta и dev могут не включать выпуск приложения macOS. Это допустимо:
  • Тег git и dist-tag npm всё равно можно публиковать независимо.
  • Укажите «нет сборки macOS для этой бета-версии» в примечаниях к выпуску или журнале изменений.

​
Связанные материалы