Обновление OpenClaw: как обновить до последней версии
Обновление OpenClaw — это одна команда openclaw update, которая сама определяет тип установки, скачивает новую версию, мигрирует конфиг через openclaw doctor и перезапускает gateway. В этой статье — пошаговая инструкция по обновлению, работа с каналами stable/beta/dev, настройка автообновления, что делать перед обновлением и как откатиться, если новая версия что-то сломала.
Что такое обновление OpenClaw
Обновление OpenClaw — это процесс замены установленного кода агента на новую версию из официального репозитория, при котором сохраняются конфигурация, credentials, память и навыки в ~/.openclaw, а gateway перезапускается с новым кодом.
В отличие от простой замены пакета, штатное обновление включает три обязательных шага: скачивание новой версии, миграцию конфигурации (за это отвечает openclaw doctor) и перезапуск gateway. Если пропустить миграцию конфига, gateway может не запуститься — поэтому разработчики собрали всё в одну команду.
OpenClaw выпускает примерно 1–2 значимых релиза в месяц. Только в первом квартале 2026 года вышли версии 2026.3.2, 2026.3.8 и 2026.3.13, каждая из которых содержала breaking changes. Регулярное обновление — это не роскошь, а часть безопасной эксплуатации агента: вместе с фичами вы получаете исправления безопасности и совместимости.
Как обновить OpenClaw до последней версии
Шаг 1. Создайте резервную копию
Перед значимым обновлением сделайте бэкап состояния. openclaw update автоматически сохраняет копию конфига до обновления, но это не полная точка восстановления. Полный архив создаётся командой:
mkdir -p ~/Backups/openclaw
openclaw backup create --output ~/Backups/openclaw --verify
Флаг --verify проверяет целостность архива сразу после создания. Команда openclaw backup create доступна в версиях 2026.3.8 и новее. Для более старых версий используйте прямой архив:
tar -czf openclaw-state-backup-$(date +%Y%m%d).tgz ~/.openclaw
Архив ~/.openclaw содержит credentials, API-ключи, токены платформ и историю сессий — храните его в защищённом месте с правами только для владельца.
Шаг 2. Запустите обновление
openclaw update
Команда автоматически:
openclaw doctor для миграции конфигурацииПовторно запускать openclaw doctor и openclaw gateway restart после openclaw update не нужно — они уже выполнены внутри команды. Ручной повтор может вызвать гонку двойного перезапуска.
Если вы хотите сначала посмотреть, что именно произойдёт, выполните предпросмотр:
openclaw update --dry-run
Команда покажет запланированные действия (канал, целевую версию, перезапуск) без фактической установки.
Шаг 3. Проверьте результат
openclaw --version
openclaw health
Первая команда покажет установленную версию, вторая — статус gateway. Дополнительная проверка:
curl -fsS http://127.0.0.1:18789/readyz
openclaw plugins list --json
openclaw gateway status --deep --json
Каналы обновления OpenClaw: stable, extended-stable, beta, dev
OpenClaw поддерживает четыре канала обновления. Канал задаётся флагом --channel и сохраняется после успешного обновления:
| Канал | Что устанавливает | Для кого |
|---|---|---|
| `stable` | Последнюю стабильную версию из npm (dist-tag `latest`) | Большинство пользователей |
| `extended-stable` | Точную версию из публичного селектора `extended-stable`, без отката на latest | Продакшн, где важна предсказуемость |
| `beta` | Бета-версию, с откатом на stable, если бета старее или отсутствует | Тестирование новых функций |
| `dev` | Постоянно обновляемый git checkout ветки `main` | Разработка, эксперименты |
openclaw update --channel stable
openclaw update --channel extended-stable
openclaw update --channel beta
openclaw update --channel dev
Канал extended-stable работает только для пакетных установок и не применим к git-чекауту. Канал dev наоборот — создаёт git-репозиторий (по умолчанию в ~/openclaw), собирает его и устанавливает глобальный CLI из этого чекаута.
Разовую установку конкретной версии или тега выполняют через --tag:
openclaw update --tag beta # разовая установка beta-тега
openclaw update --tag 2026.7.1 # разовая установка конкретной версии
Автоматическое обновление OpenClaw
Автообновление в OpenClaw выключено по умолчанию. Включить его можно в файле ~/.openclaw/openclaw.json:
{
"update": {
"channel": "stable",
"auto": {
"enabled": true
}
}
}
Поведение зависит от канала:
Если нужно заблокировать автообновление при инциденте, установите переменную окружения OPENCLAW_NO_AUTO_UPDATE=1 для gateway. Отключить подсказки при старте можно через update.checkOnStart: false.
Обновление в зависимости от способа установки
Если OpenClaw установлен через npm, pnpm или bun
Штатный способ — openclaw update, он координирует замену пакета с работающим gateway. Если вы обновляетесь вручную, сначала остановите gateway, затем обновите пакет и перезапустите:
openclaw gateway stop
npm i -g openclaw@latest
openclaw doctor
openclaw gateway restart
Для pnpm: pnpm add -g openclaw@latest. Для bun: bun add -g openclaw@latest.
Если openclaw update на Linux завершается с ошибкой EACCES (права на системный каталог пакетов), восстановите установку так:
openclaw gateway stop
sudo /usr/bin/npm i -g openclaw@latest
openclaw gateway install --force
openclaw gateway restart
Если OpenClaw установлен из git-репозитория
Для одиночной установки из исходников используйте канал dev — он сам управляет чекаутом, сборкой и перезапуском:
openclaw update --channel dev
Если OpenClaw запущен в Docker
Для Docker, Podman и Kubernetes обновление — это замена образа контейнера, инструкция описана в разделе Upgrading container images документации. Критично: навыки (skills), вшитые в слой образа, стираются при пересборке. Храните навыки в смонтированном volume с каталогом состояния, а не внутри образа.
Универсальный способ: переустановка через скрипт
Если openclaw update не справился после фазы установки пакета, переустановите через официальный скрипт:
curl -fsSL https://openclaw.ai/install.sh | bash
Флаг --no-onboard пропускает онбординг, --install-method npm или --install-method git принудительно задаёт тип установки. Скрипт не вызывает updater, а напрямую выполняет глобальную установку пакета — это помогает восстановить частично обновлённую npm-установку.
Что делать после обновления
openclaw --version должна показывать новую версию.openclaw config validate (доступно с версии 2026.3.2) выявляет несовместимые поля и устаревшие настройки до перезапуска.openclaw config get tools и openclaw config get agents. В версии 2026.3.2 у новых установок профиль по умолчанию сменился на messaging, который убирает доступ к чтению, записи и выполнению команд. Если агент после обновления «разучился» работать с файлами — верните tools.profile: "coding".openclaw health проверяет только сам gateway, а не работу агента. Доверьте агенту простую задачу (например, прочитать файл и ответить), чтобы убедиться, что инструменты работают.Что делать, если после обновления что-то сломалось
Сначала проверьте, не связана ли проблема с известными breaking changes. В версии 2026.3.2, например, одновременно изменились три вещи:
messaging (лечится настройкой tools.profile: "coding");acp.dispatch.enabled: false);registerHttpHandler() был удалён в пользу registerHttpRoute({ path, auth, handler }) — плагины с устаревшим API перестают работать.Запустите openclaw doctor ещё раз и внимательно прочитайте вывод — он подскажет, что именно нужно мигрировать.
Откат на предыдущую версию
Шаг 1. Найдите известную рабочую версию:
npm view openclaw versions --json
Шаг 2. Предпросмотрите откат:
openclaw update --tag --dry-run
Шаг 3. Установите версию:
openclaw update --tag
Команда обнаружит даунгрейд, запросит подтверждение, выполнит проверки совместимости плагинов и перезапустит gateway. Если CLI-путь недоступен, используйте ручной откат:
openclaw gateway stop
npm i -g openclaw@
openclaw gateway install --force
openclaw gateway restart
Для git-установки откат выполняется так:
git fetch --all --tags
git checkout --detach
pnpm install && pnpm build
openclaw gateway restart
Если после даунгрейда появляются предупреждения «config written by a newer version», сбросьте метаданные:
openclaw config unset meta.lastTouchedVersion
Восстанавливать состояние из бэкапа нужно только в том случае, если старая версия не может прочитать новый формат конфига или базы данных. В этом случае остановите gateway, восстановите файлы из снапшота и отдельно сохраните текущее состояние — восстановление удалит изменения, сделанные после бэкапа.
Полезные команды для управления обновлением
| Команда | Назначение |
|---|---|
| `openclaw update status` | Показать текущий канал и доступность обновления |
| `openclaw update —dry-run` | Предпросмотр действий без установки |
| `openclaw update —json` | Машиночитаемый результат обновления |
| `openclaw update repair` | Повторная финализация, если плагины или доктор не доработали после установки ядра |
| `openclaw update wizard` | Интерактивный выбор канала и перезапуска |
| `openclaw update —no-restart` | Обновить без перезапуска gateway |
| `openclaw —update` | Синоним `openclaw update` |
Команда openclaw update repair не устанавливает новое ядро и не перезапускает gateway — она доводит до конца работу, которая должна была выполниться после установки: синхронизацию плагинов, обновление метаданных и openclaw doctor --fix.
Частые вопросы об обновлении OpenClaw
Сохранятся ли мои навыки и конфиг при обновлении?
Да. Конфигурация, credentials, память и навыки хранятся в ~/.openclaw и не затрагиваются обновлением кода при npm, pnpm, bun и git-установках. Навыки в ~/.openclaw/skills/ переживают обновление. Исключение — Docker: навыки, вшитые в образ, стираются при пересборке, поэтому храните их в смонтированном volume.
В чём разница между `openclaw update` и `npm install -g openclaw@latest`?
openclaw update определяет тип установки, скачивает новую версию, запускает openclaw doctor для миграции конфига и перезапускает gateway — всё одной командой. npm install -g openclaw@latest заменяет только пакет: миграцию конфига и перезапуск gateway нужно выполнять вручную, иначе gateway может не запуститься на новом коде.
Как часто выходят новые версии OpenClaw?
Примерно 1–2 значимых релиза в месяц. В Q1 2026 вышли версии 2026.3.2, 2026.3.8 и 2026.3.13, каждая с breaking changes. Перед обновлением стоит просматривать список релизов на GitHub на предмет пометок BREAKING CHANGE.
Нужно ли делать бэкап перед каждым обновлением?
Перед значимым обновлением — да. openclaw update создаёт автоматическую копию конфига, но не полную точку восстановления. Полный бэкап делается командой openclaw backup create --output ~/Backups/openclaw --verify и занимает меньше минуты.
Как откатиться, если новая версия сломала агента?
Найдите предыдущую версию через npm view openclaw versions --json, затем выполните openclaw update --tag — команда обнаружит даунгрейд, запросит подтверждение и перезапустит gateway. Для ручного отката: остановите gateway, установите старую версию через npm, выполните openclaw doctor и перезапустите gateway.
Ссылки
Читайте также на openclawiki: