Обновление

Поддерживайте OpenClaw в актуальном состоянии.

Рекомендуется: openclaw update

Самый быстрый способ обновления. Он определяет тип вашей установки (npm или git), получает последнюю версию, запускает openclaw doctor и перезапускает Gateway.

openclaw update

Чтобы переключить каналы или выбрать конкретную версию:

openclaw update --channel betaopenclaw update --channel devopenclaw update --dry-run   # preview without applying

openclaw update не принимает --verbose. Для диагностики обновления используйте --dry-run, чтобы предварительно посмотреть запланированные действия, --json для структурированных результатов или openclaw update status --json, чтобы проверить состояние канала и доступности. У установщика есть собственный флаг --verbose, но этот флаг не является частью openclaw update.

--channel beta предпочитает beta, но runtime откатывается к stable/latest, когда тег beta отсутствует или старше последнего стабильного выпуска. Используйте --tag beta, если вам нужен исходный npm dist-tag beta для разового обновления пакета.

Используйте --channel dev для постоянного движущегося checkout ветки GitHub main. Для обновлений пакетов --tag main сопоставляется с github:openclaw/openclaw#main для одного запуска, а спецификации источников GitHub/git упаковываются во временный tarball перед staged npm install.

Для управляемых плагинов fallback beta-канала является предупреждением: обновление ядра все равно может успешно завершиться, пока плагин использует свой записанный default/latest выпуск, потому что beta-версия плагина недоступна.

См. Каналы разработки, чтобы узнать семантику каналов.

Переключение между установками npm и git

Используйте каналы, когда хотите изменить тип установки. Средство обновления сохраняет ваши состояние, конфигурацию, учетные данные и рабочую область в ~/.openclaw; оно изменяет только то, какую установку кода OpenClaw используют CLI и Gateway.

# npm package install -> editable git checkoutopenclaw update --channel dev # git checkout -> npm package installopenclaw update --channel stable

Сначала запустите с --dry-run, чтобы предварительно посмотреть точное переключение режима установки:

openclaw update --channel dev --dry-runopenclaw update --channel stable --dry-run

Канал dev обеспечивает git checkout, собирает его и устанавливает глобальный CLI из этого checkout. Каналы stable и beta используют установки пакетов. Если Gateway уже установлен, openclaw update обновляет метаданные службы и перезапускает ее, если вы не передали --no-restart.

Для установок пакетов с управляемой службой Gateway openclaw update нацеливается на корень пакета, используемый этой службой. Если shell-команда openclaw приходит из другой установки, средство обновления выводит оба корня и путь Node управляемой службы. Обновление пакета использует менеджер пакетов, которому принадлежит корень службы, и проверяет Node управляемой службы относительно engine целевого выпуска перед заменой пакета.

Альтернатива: повторно запустить установщик

curl -fsSL https://openclaw.ai/install.sh | bash

Добавьте --no-onboard, чтобы пропустить onboarding. Чтобы принудительно выбрать конкретный тип установки через установщик, передайте --install-method git --no-onboard или --install-method npm --no-onboard.

Если openclaw update завершается ошибкой после этапа установки npm-пакета, повторно запустите установщик. Установщик не вызывает старое средство обновления; он напрямую запускает установку глобального пакета и может восстановить частично обновленную npm-установку.

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm

Чтобы закрепить восстановление за конкретной версией или dist-tag, добавьте --version:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --version <version-or-dist-tag>

Альтернатива: ручной npm, pnpm или bun

npm i -g openclaw@latest

Предпочитайте openclaw update для supervised-установок, потому что он может согласовать замену пакета с работающей службой Gateway. Если вы обновляете supervised-установку вручную, остановите управляемый Gateway до запуска менеджера пакетов. Менеджеры пакетов заменяют файлы на месте, и работающий Gateway иначе может попытаться загрузить файлы ядра или плагинов, пока дерево пакета временно заменено лишь частично. Перезапустите Gateway после завершения работы менеджера пакетов, чтобы служба подхватила новую установку.

Для root-owned глобальной установки Linux на уровне системы, если openclaw update завершается ошибкой с EACCES и вы восстанавливаете установку через системный npm, держите Gateway остановленным на протяжении ручной замены пакета. Используйте те же флаги профиля openclaw или окружение, которые вы обычно используете для этого Gateway. Замените /usr/bin/npm на системный npm, которому принадлежит root-owned глобальный prefix на вашем хосте:

openclaw gateway stopsudo /usr/bin/npm i -g openclaw@latestopenclaw gateway install --forceopenclaw gateway restart

Затем проверьте службу:

openclaw --versioncurl -fsS http://127.0.0.1:18789/readyzopenclaw plugins list --jsonopenclaw gateway status --deep --jsonopenclaw doctor --lint --json

Когда openclaw update управляет глобальной npm-установкой, он сначала устанавливает целевую версию во временный npm prefix, проверяет инвентарь упакованного dist, затем заменяет чистое дерево пакета в реальном глобальном prefix. Это предотвращает наложение npm нового пакета поверх устаревших файлов из старого пакета. Если команда установки завершается ошибкой, OpenClaw повторяет попытку один раз с --omit=optional. Эта повторная попытка помогает хостам, где native optional-зависимости не могут скомпилироваться, при этом сохраняя видимой исходную ошибку, если fallback тоже завершается ошибкой.

Команды обновления npm и обновления плагинов, управляемые OpenClaw, также очищают quarantine npm min-release-age для дочернего процесса npm. npm может сообщать эту политику как производный cutoff before; оба полезны для общих политик supply-chain quarantine, но явное обновление OpenClaw означает: «установить выбранный выпуск OpenClaw сейчас».

pnpm add -g openclaw@latest

bun add -g openclaw@latest

Расширенные темы установки npm

ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp

Автообновление

Автообновление по умолчанию выключено. Включите его в ~/.openclaw/openclaw.json:

{  update: {    channel: "stable",    auto: {      enabled: true,      stableDelayHours: 6,      stableJitterHours: 12,      betaCheckIntervalHours: 1,    },  },}

Gateway также записывает подсказку об обновлении при запуске (отключается через update.checkOnStart: false). Для отката версии или восстановления после инцидента задайте OPENCLAW_NO_AUTO_UPDATE=1 в окружении Gateway, чтобы блокировать автоматическое применение даже при настроенном update.auto.enabled. Подсказки об обновлении при запуске все еще могут выполняться, если также не отключен update.checkOnStart.

Обновления через менеджер пакетов, запрошенные через обработчик live control-plane Gateway, не заменяют дерево пакета внутри запущенного процесса Gateway. В управляемых сервисных установках Gateway запускает отсоединенную передачу управления, завершает работу и позволяет обычному пути CLI openclaw update --yes --json остановить сервис, заменить пакет, обновить метаданные сервиса, перезапустить, проверить версию Gateway и доступность, а также по возможности восстановить установленный, но не загруженный macOS LaunchAgent. Если Gateway не может безопасно выполнить такую передачу управления, update.run сообщает безопасную shell-команду вместо запуска менеджера пакетов внутри процесса.

После обновления

openclaw doctor

openclaw gateway restart

openclaw health

Откат

Закрепите версию (npm)

npm i -g openclaw@<version>openclaw doctoropenclaw gateway restart

Закрепите коммит (исходный код)

git fetch origingit checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"pnpm install && pnpm buildopenclaw gateway restart

Чтобы вернуться к последней версии: git checkout main && git pull.

Если вы застряли

• Снова запустите openclaw doctor и внимательно прочитайте вывод.
• Для openclaw update --channel dev в checkout исходного кода средство обновления автоматически подготавливает pnpm при необходимости. Если вы видите ошибку начальной подготовки pnpm/corepack, установите pnpm вручную (или снова включите corepack) и повторно запустите обновление.
• Проверьте: Устранение неполадок
• Спросите в Discord: https://discord.gg/clawd

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

• Обзор установки: все способы установки.
• Doctor: проверки состояния после обновлений.
• Миграция: руководства по миграции между основными версиями.