> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Обновление Поддерживайте OpenClaw в актуальном состоянии. ## Рекомендуется: `openclaw update` Самый быстрый способ обновления. Он определяет тип вашей установки (npm или git), получает последнюю версию, запускает `openclaw doctor` и перезапускает Gateway. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw update ``` Чтобы переключить каналы или выбрать конкретную версию: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw update --channel beta openclaw update --channel dev openclaw 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-версия плагина недоступна. См. [Каналы разработки](/ru/install/development-channels), чтобы узнать семантику каналов. ## Переключение между установками npm и git Используйте каналы, когда хотите изменить тип установки. Средство обновления сохраняет ваши состояние, конфигурацию, учетные данные и рабочую область в `~/.openclaw`; оно изменяет только то, какую установку кода OpenClaw используют CLI и Gateway. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # npm package install -> editable git checkout openclaw update --channel dev # git checkout -> npm package install openclaw update --channel stable ``` Сначала запустите с `--dry-run`, чтобы предварительно посмотреть точное переключение режима установки: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw update --channel dev --dry-run openclaw 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 целевого выпуска перед заменой пакета. ## Альтернатива: повторно запустить установщик ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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-установку. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm ``` Чтобы закрепить восстановление за конкретной версией или dist-tag, добавьте `--version`: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --version ``` ## Альтернатива: ручной npm, pnpm или bun ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 на вашем хосте: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw gateway stop sudo /usr/bin/npm i -g openclaw@latest openclaw gateway install --force openclaw gateway restart ``` Затем проверьте службу: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw --version curl -fsS http://127.0.0.1:18789/readyz openclaw plugins list --json openclaw gateway status --deep --json openclaw 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 сейчас». ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} pnpm add -g openclaw@latest ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} bun add -g openclaw@latest ``` ### Расширенные темы установки npm OpenClaw рассматривает упакованные глобальные установки как доступные только для чтения во время выполнения, даже если каталог глобального пакета доступен текущему пользователю для записи. Установки пакетов Plugin находятся в принадлежащих OpenClaw корнях npm/git в каталоге пользовательской конфигурации, а запуск Gateway не изменяет дерево пакета OpenClaw. Некоторые конфигурации npm в Linux устанавливают глобальные пакеты в каталоги, принадлежащие root, например `/usr/lib/node_modules/openclaw`. OpenClaw поддерживает такую структуру, потому что команды установки/обновления Plugin записывают данные за пределами этого каталога глобального пакета. Предоставьте OpenClaw доступ на запись к его корням конфигурации/состояния, чтобы явные установки Plugin, обновления Plugin и очистка doctor могли сохранять свои изменения: ```ini theme={"theme":{"light":"min-light","dark":"min-dark"}} ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp ``` Перед обновлениями пакетов и явными установками Plugin OpenClaw пытается выполнить максимально возможную проверку свободного места на целевом томе. При нехватке места выводится предупреждение с проверенным путем, но обновление не блокируется, потому что квоты файловой системы, снимки и сетевые тома могут измениться после проверки. Фактическая установка через менеджер пакетов и проверка после установки остаются авторитетными. ## Автообновление Автообновление по умолчанию выключено. Включите его в `~/.openclaw/openclaw.json`: ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { update: { channel: "stable", auto: { enabled: true, stableDelayHours: 6, stableJitterHours: 12, betaCheckIntervalHours: 1, }, }, } ``` | Канал | Поведение | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | `stable` | Ожидает `stableDelayHours`, затем применяет обновление с детерминированным джиттером в пределах `stableJitterHours` (постепенное развертывание). | | `beta` | Проверяет каждые `betaCheckIntervalHours` (по умолчанию: каждый час) и применяет сразу. | | `dev` | Автоматическое применение отсутствует. Используйте `openclaw update` вручную. | 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-команду вместо запуска менеджера пакетов внутри процесса. ## После обновления ### Запустите doctor ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw doctor ``` Мигрирует конфигурацию, проверяет политики DM и проверяет состояние Gateway. Подробности: [Doctor](/ru/gateway/doctor) ### Перезапустите Gateway ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw gateway restart ``` ### Проверьте ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw health ``` ## Откат ### Закрепите версию (npm) ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} npm i -g openclaw@ openclaw doctor openclaw gateway restart ``` `npm view openclaw version` показывает текущую опубликованную версию. ### Закрепите коммит (исходный код) ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} git fetch origin git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)" pnpm install && pnpm build openclaw gateway restart ``` Чтобы вернуться к последней версии: `git checkout main && git pull`. ## Если вы застряли * Снова запустите `openclaw doctor` и внимательно прочитайте вывод. * Для `openclaw update --channel dev` в checkout исходного кода средство обновления автоматически подготавливает `pnpm` при необходимости. Если вы видите ошибку начальной подготовки pnpm/corepack, установите `pnpm` вручную (или снова включите `corepack`) и повторно запустите обновление. * Проверьте: [Устранение неполадок](/ru/gateway/troubleshooting) * Спросите в Discord: [https://discord.gg/clawd](https://discord.gg/clawd) ## Связанные материалы * [Обзор установки](/ru/install): все способы установки. * [Doctor](/ru/gateway/doctor): проверки состояния после обновлений. * [Миграция](/ru/install/migrating): руководства по миграции между основными версиями.