Перейти к основному содержимому

Команды CLI

update

Безопасно обновите OpenClaw и переключайтесь между стабильным, бета- и dev-каналами. Если вы установили через npm/pnpm (глобальная установка, без метаданных git), обновления происходят через процесс менеджера пакетов, описанный в разделе Обновление.

Использование​

openclaw update
openclaw update status
openclaw update wizard
openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag beta
openclaw update --dry-run
openclaw update --no-restart
openclaw update --json
openclaw --update

Опции​

  • --no-restart: пропустить перезапуск сервиса Gateway после успешного обновления.
  • --channel <stable|beta|dev>: установить канал обновления (git + npm; сохраняется в конфигурации).
  • --tag <dist-tag|version>: переопределить npm dist-tag или версию только для этого обновления.
  • --dry-run: предварительный просмотр запланированных действий обновления (процесс channel/tag/target/restart) без записи конфигурации, установки, синхронизации плагинов или перезапуска.
  • --json: вывод машиночитаемого JSON UpdateRunResult.
  • --timeout : таймаут для каждого шага (по умолчанию 1200с).

Примечание: для понижения версии требуется подтверждение, так как старые версии могут нарушить конфигурацию.

update status​

Показать активный канал обновления + git tag/branch/SHA (для исходных копий), а также доступность обновлений.

openclaw update status
openclaw update status --json
openclaw update status --timeout 10

Опции:

  • --json: вывод машиночитаемого JSON статуса.
  • --timeout : таймаут для проверок (по умолчанию 3с).

update wizard​

Интерактивный процесс для выбора канала обновления и подтверждения необходимости перезапуска Gateway после обновления (по умолчанию перезапуск выполняется). Если вы выберете dev без git-репозитория, будет предложено его создать.

Что делает команда​

При явном переключении каналов (--channel ...) OpenClaw также приводит метод установки в соответствие:

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

Автообновление ядра Gateway (когда включено в конфигурации) использует этот же путь обновления.

Процесс работы с git-репозиторием​

Каналы:

  • stable: переключиться на последний не-бета тег, затем собрать + проверить (doctor).
  • beta: переключиться на последний тег -beta, затем собрать + проверить (doctor).
  • dev: переключиться на ветку main, затем получить изменения (fetch) + перебазировать (rebase).

Общий алгоритм:

  1. Требуется чистое рабочее дерево (без незафиксированных изменений).
  2. Переключение на выбранный канал (тег или ветку).
  3. Получение изменений из upstream (только для dev).
  4. Только для dev: предварительная проверка линтером + сборка TypeScript во временном рабочем дереве; если сборка на последнем коммите не удалась, происходит поиск (до 10 коммитов назад) новейшей чистой сборки.
  5. Перебазирование на выбранный коммит (только для dev).
  6. Установка зависимостей (предпочтительно pnpm; запасной вариант npm).
  7. Сборка + сборка панели управления (Control UI).
  8. Запуск openclaw doctor в качестве финальной проверки «безопасного обновления».
  9. Синхронизация плагинов с активным каналом (dev использует встроенные расширения; stable/beta используют npm) и обновление плагинов, установленных через npm.

Сокращённая запись --update​

openclaw --update переписывается в openclaw update (полезно для оболочек и скриптов-запускателей).

Смотрите также​

uninstallvoicecall