Как обновить OpenClaw и восстановиться после сбоя

Коротко

• Для npm, pnpm, Bun и git-установок используйте openclaw update. Перед крупным обновлением создайте проверенную резервную копию.
• Если Gateway не поднялся или каналы опустели, начните с проверки статуса и openclaw doctor --fix.
• Откат выполняйте через восстановление состояния вместе с совместимой версией OpenClaw.

Сверено с документацией OpenClaw 2026.10.7, 25 октября 2026.

Обновить OpenClaw можно штатной командой openclaw update, а после сбоя — через Doctor и repair. Перед изменениями сохраните проверенную копию состояния и проверьте готовность Gateway.

Как обновить OpenClaw

Штатный апдейт определяет тип установки: npm, pnpm, Bun или git. Он проверяет новую версию, пока старый Gateway обслуживает запросы, и только затем её активирует.

openclaw update

Для предварительной проверки используйте --dry-run. Чтобы выбрать канал обновлений, укажите --channel.

openclaw update --dry-run
openclaw update --channel extended-stable
openclaw update --channel beta
openclaw update --channel dev
openclaw update status

Если openclaw update не может обновить установку, которой владеет системный пакетный менеджер, используйте его. Для Arch-систем это sudo pacman -Syu или AUR-помощник. Для FreeBSD используйте pkg или Ports.

Для Docker, Podman и Kubernetes обновляйте образ и пересоздавайте контейнер с прежними mount’ами состояния и конфигурации. Entrypoint обращается к Doctor перед запуском Gateway.

Что происходит во время обновления

Для OpenClaw.app обновляйте приложение через встроенное средство обновления. Он обновляет Gateway и runtime вместе. openclaw update покажет подсказку, но не изменит пакет.

После обновления убедитесь, что Gateway отвечает, а версия соответствует ожидаемой.

openclaw status --all
openclaw update status --json
openclaw gateway status --deep

Если после обновления что-то сломалось

Если Gateway не запустился, каналы пусты или модель получает 401, выполните восстановление по порядку. Doctor исправляет конфигурацию и выполняет миграции.

openclaw status --all
openclaw update status --json
openclaw gateway status --deep
openclaw doctor --fix
openclaw gateway restart

Если обновление не передало управление Gateway, запустите openclaw update repair. Проверьте статус ещё раз: команда покажет ожидающие миграции и записанное предупреждение.

openclaw update repair
openclaw update status --json
openclaw gateway status --deep

Если возникает Doctor could not enter maintenance, проверьте владельца каталога состояния. Не удаляйте файлы блокировки: сначала устраните конфликт процесса или запустите openclaw update repair.

Откат и восстановление

Перед крупным обновлением создайте проверенную резервную копию. Автоматические копии конфигурации и оригиналы миграций не заменяют полную резервную копию состояния.

При откате восстановите состояние и запустите совместимую с ним версию OpenClaw. Старые версии не открывают обновлённые схемы SQLite, поэтому порядок версий важен.

Для установок старше июля 2026 сначала обновитесь до 2026.9.5, выполните миграции Doctor, затем переходите к latest.

openclaw gateway stop &&
  npm install -g openclaw@2026.9.5 --allow-scripts=openclaw &&
  openclaw --version &&
  openclaw doctor --fix

После успешного импорта установите текущий релиз и перезапустите Gateway.

npm install -g openclaw@latest --allow-scripts=openclaw &&
  openclaw doctor --fix &&
  openclaw gateway start &&
  openclaw gateway status --deep

Для pnpm используйте pnpm add -g --allow-build=openclaw openclaw@2026.9.5, затем pnpm add -g --allow-build=openclaw openclaw@latest. Для Bun выполните bun add -g --trust openclaw@2026.9.5, затем bun add -g --trust openclaw@latest.

Частые ошибки

• Запускали обновление при активном конфликтующем Gateway: проверьте openclaw gateway status --deep и устраните конфликт владения состоянием.
• Удаляли файлы блокировки, чтобы войти в режим обслуживания: не делайте этого; следуйте диагностике Doctor.
• Делали откат только программы, оставив обновлённую базу: восстанавливайте совместимый бэкап и версию вместе.
• Правили meta.lastTouchedVersion, чтобы запустить старую версию: не удаляйте эту защиту и не обходите её.
• Запускали openclaw update для macOS-приложения или контейнера: используйте встроенное средство обновления приложения либо обновление образа.