Контрольный список обновления до OpenClaw 3.22: Практические шаги от разработчика, который уже обжёгся

Перед обновлением до OpenClaw 3.22

Проверьте ваш файл .env на наличие переменных с префиксами CLAWDBOT_ или MOLTBOT_. Версия 3.22 удалила все эти переменные без каких-либо запасных вариантов или совместимости. Если они у вас есть, ваш агент не запустится, а сообщение об ошибке будет неинформативным. Сначала переименуйте всё на OPENCLAW_. Если вы настраивали OpenClaw до середины февраля, у вас почти наверняка есть хотя бы одна из этих переменных.

Выполните openclaw backup create перед любыми изменениями. Рассмотрите возможность пометить текущий образ Docker как :pre-upgrade, чтобы при необходимости можно было мгновенно откатиться.

После обновления до OpenClaw 3.22

Запустите openclaw doctor --fix, который автоматически исправляет большинство миграций конфигурации.

Проверьте /tools в любом канале, чтобы увидеть, какие инструменты действительно доступны. Версия 3.22 изменила поверхность SDK плагинов (переход с openclaw/extension-api на openclaw/plugin-sdk/*), поэтому сторонние плагины, использующие старые пути импорта, просто тихо не загрузятся.

Запустите openclaw secrets audit, чтобы найти открытые API-ключи в вашем рабочем пространстве. Разработчик обнаружил два таких ключа, которые были полностью забыты и находились в файлах конфигурации навыков.

Новые возможности в 3.22

• Побочные беседы /btw
• Нативная установка из ClawHub через CLI (openclaw skills install вместо ручного скачивания файлов skill.md)
• Очистка неактивных сессий
• Экспоненциальная задержка повтора для cron, чтобы неудачное задание не истощило ваш API-бюджет за ночь
• Таймаут агента увеличен до 48 часов вместо 10 минут, что означает, что длительные задачи теперь действительно завершаются

Разработчик рекомендует выделить 30-45 минут на тщательное обновление, а не предполагать, что всё пройдёт гладко, отмечая, что после завершения "это действительно стало лучше".