Миграция флота OpenClaw 2.0: что на самом деле сломалось

Обновить один экземпляр OpenClaw — это одно, но при миграции целого парка живых клиентов каждая поломка умножается. Одна команда потратила целый день на переход на OpenClaw 2.0 и поделилась самыми острыми углами. Вот что реально сломалось и как этого избежать.

Схема конфигурации стала строже

В версии 2.0 схема конфигурации стала строже, и некоторые поля переместились (env-ключи, TTS, медиамодели). Самая большая ловушка: doctor --fix молча удаляет неизвестные поля. Если ваш ключ модели находится в области, которая теперь устарела, он может исчезнуть вместе с этими полями. Команда переписала конфиги вручную до запуска doctor, чтобы не потерять ключи.

Внешние плагины ломают шлюз

WhatsApp, Brave, Discord и Perplexity больше не входят в основной образ; они являются внешними плагинами. Если ваш конфиг по-прежнему ссылается на них, шлюз никогда не становится готовым, контейнер попадает в цикл перезапуска, и снаружи это выглядит как ошибка 502. Просто добавить плагины в образ недостаточно, потому что согласие на возможности привязано к конкретной машине, и doctor его не принимает. Единственный рабочий подход — запуск openclaw plugins install ... --accept-capabilities отдельным шагом.

Сопряжение устройств: заголовки Cloudflare нарушают локальность

Веб-чат начал выдавать PAIRING_REQUIRED. Корень проблемы: 2.0 доверяет только запросам с loopback без каких-либо пересылаемых заголовков. Просто не задавать их в nginx недостаточно — Cloudflare отправляет свои заголовки, поэтому их нужно явно обнулять в nginx. Это выглядело как сломанный токен, но на самом деле было конфликтом между Cloudflare, nginx и логикой локальности OpenClaw.

Perplexity автоматически загружается нежелательно

Perplexity будет автоматически загружаться, если обнаружит ключ OpenRouter, а затем потребует согласия, даже если вы не хотите использовать этот плагин. Установка enabled: false не помогает; необходимо использовать plugins.deny, чтобы заблокировать его.

Вывод: предпочитайте стабильность функциям

Основной принцип: лучше временно потерять веб-поиск или один канал, чем уронить весь агент с ошибкой 502. Планируйте множественные поломки и тестируйте каждый компонент отдельно.

Это основано на реальном отчете о миграции с облачной платформы, размещающей OpenClaw для клиентов. Если вы планируете обновление, прочитайте источник для получения дополнительных сведений и информации от сообщества.