Как обновить OpenClaw до 2026.9.7 и ничего не сломать

Коротко

Релиз про надёжность обновления: расширено резервное копирование баз агентов и добавлен откат схемы при неудачной активации.
Фиксы апгрейда с 2026.9.5: убраны ложные откаты managed-обновлений, зависание апдейта Windows, сбои передачи Mac-приложения и нестартующие npm-установки.
Восстановление после перезапуска само находит прерванные ходы агента и различает сбой и обрыв. Прерванные вызовы инструментов не повторяются автоматически.
Если установка старше июня 2026, без промежуточного шага на 2026.9.5 не обойтись.

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

Обновление OpenClaw в этом релизе стало безопаснее: шире резервное копирование баз агентов, появился откат схемы при сбое активации и исправления для тех, кто откладывал обновление с 2026.9.5. Gateway после перезапуска сам подбирает прерванную работу главной сессии и сливает очередь доставки. Ниже что именно поменялось и какие команды выполнять.

Бэкапы при обновлении и откат схемы

Обновление копирует больше баз agents/<id>/agent/openclaw-agent.sqlite. Подходящие обновления дополнительно получают откат баз, если новая версия не прошла проверку до старта. Используйте встроенное средство обновления вместо голого npm i -g и заранее создайте проверенный архив.

openclaw backup create --verify
openclaw update
openclaw update --tag <known-good-version> --dry-run
openclaw update --tag <known-good-version>

Голый npm i -g не сохраняет предыдущий пакет и не запускает сценарий восстановления. Управляемый возврат на заведомо рабочую версию сработает только при совпадении схемы и поддержке со стороны предыдущего пакета.

Фиксы апгрейда с 2026.9.5

Для тех, кто обновлялся с 2026.9.5, исправлены четыре дефекта: неожиданные откаты управляемых обновлений, остановка обновления на Windows после миграции, сбои передачи Mac-приложения и не запускающиеся npm-установки. Установка, застрявшая на старом апдейтере, всё ещё может требовать ручного ремонта.

openclaw gateway stop && openclaw update --yes && openclaw gateway start

Эта последовательность нужна, если openclaw update отказывается с ошибкой service-membership-unverified: обновлятор не смог проверить, запущен ли он изнутри службы Gateway. Выполните её в обычном терминале, а не из сессии агента, под той же учётной записью, от которой установлен OpenClaw.

Восстановление после перезапуска

Подходящие прерванные ходы главной сессии автоматически возобновляются или приводятся в порядок через несколько секунд после старта. Прерванные запуски субагентов завершаются, а родитель решает, как продолжить. Очередь доставки отправляет ожидающие сообщения, cron-планировщик заново ставит расписание. Восстановление работает всегда. Два ограничения: прерванные вызовы инструментов не воспроизводятся автоматически, а откат на v2026.9.2 сохраняет новые поля receipt, но сам отвергает повторы по ним до выполнения.

openclaw status
openclaw doctor
openclaw health

Новые поля receipt отбрасываются старыми версиями при перезаписи метаданных сессии даже без смены SQL-схемы. Поэтому завершите восстановление отложенных доставок до отката.

Если установка старше июня 2026

Таким установкам нужен промежуточный шаг через версию 2026.9.5. Она импортирует tasks/runs.sqlite, flows/registry.sqlite, plugin-state/state.sqlite, JSON-состояние плагинов и credentials/oauth.json, чинит устаревшие ключи конфига агентов и каналов и сохраняет старые runtime-алиасы. Текущие релизы эти устаревшие файлы не трогают. Если установка старше июня 2026, сначала обновитесь до 2026.9.5, выполните её Doctor-миграции и только потом ставьте latest.

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

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

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

Что проверить при обновлении

Создайте проверенный архив состояния: openclaw backup create --verify.
Проверьте версию и путь Node: Node 24.16+ на линейке 24.x или Node 26.1+. На первом шаге моста openclaw --version должна показать 2026.9.5.
Если установка старше июня 2026, выполните промежуточный шаг на 2026.9.5 с --allow-scripts=openclaw и openclaw doctor --fix.
Запустите обновление штатным путём: openclaw update.
После активации проверьте состояние Gateway и историю обновления: openclaw gateway status --deep, openclaw update status --json, openclaw health, openclaw doctor --lint --json.
Если что-то пошло не так, откатитесь на заведомо рабочую версию: openclaw update --tag <known-good-version> --dry-run, затем без --dry-run. При автообновлении заранее задайте OPENCLAW_NO_AUTO_UPDATE=1 в среде Gateway.