Уже пользуетесь старой версией OpenClaw и хотите обновиться до 2026.3.x, но боитесь несовместимости конфига? В 2026.3.x изменилась логика конфига по умолчанию (tools.profile, ACP dispatch и т.д.), старые туториалы могут не работать. В этом руководстве: зачем мигрировать, обязательные шаги перед обновлением (бэкап и проверки), миграция в 5 шагов (установка/обновление → мастер onboard → API и права → демон → проверка), а также типичные подводные камни — откат прав, конфликты портов, переменные окружения — и советы по VNC удалённому Mac, чтобы пройти обновление без сюрпризов.
① Зачем мигрировать на 2026.3.x? Старые туториалы и основные изменения
В 2026.3.x ужесточены безопасность и значения по умолчанию: при новой установке tools.profile по умолчанию messaging (только инструменты чата/сессии). Если вы полагаетесь на чтение/запись файлов или выполнение в терминале, после обновления появится «нет прав». ACP dispatch включён по умолчанию и может изменить маршрутизацию мульти-агентов; изменилась и регистрация HTTP плагинов. Поэтому старый конфиг или копирование старых туториалов часто приводит к сбоям после обновления.
| Изменение | Старое / типичное состояние | 2026.3.x по умолчанию / рекомендация |
|---|---|---|
| tools.profile | Не задано или coding/full | При новой установке по умолчанию messaging; при необходимости чтения/записи/выполнения установить coding или full |
| acp.dispatch | Часто не задано | По умолчанию enabled; отключить, если нужен только /acp без авто-маршрутизации |
| Регистрация HTTP плагинов | registerHttpHandler и т.д. | Поведение регистрации изменилось; проверить код и документацию плагинов |
② Перед обновлением: бэкап, версия, зависимости
Сделайте эти три шага до обновления, чтобы избежать сбоя или потери конфига без возможности отката.
Бэкап конфига и workspace
Скопируйте ~/.openclaw/openclaw.json и ~/.openclaw/workspace/ в надёжное место. При переносе на новую машину скопируйте оба, затем выполните openclaw doctor и openclaw gateway restart.
Версия и зависимости
Проверьте версию Node (рекомендуется 20+); openclaw doctor для миграции и исправлений; openclaw config validate для проверки синтаксиса конфига.
Проверить текущие tools и ACP
Выполните openclaw config get tools для текущего profile; при использовании ACP убедитесь, что acp.dispatch.enabled соответствует ожиданиям.
③ Миграция в 5 шагов: установка/обновление → мастер onboard → API и права → демон → проверка
Шаг 1: Обновитесь до 2026.3.x через npm install -g openclaw@latest или официальный скрипт установки.
Шаг 2: Запустите openclaw onboard для мастера настройки; выберите сценарий (личный/команда), тип установки (QuickStart и т.д.), модель и API (OpenAI/Claude/сторонние).
Шаг 3: В ~/.openclaw/openclaw.json установите или подтвердите tools.profile в coding (обычные файлы и выполнение) или full; чтобы отключить авто-маршрутизацию ACP, установите acp.dispatch.enabled: false.
Шаг 4: При использовании демона/LaunchAgent выполните openclaw onboard --install-daemon или настройте демон по документации; убедитесь, что в plist/переменных окружения указаны PATH и переменные API.
Шаг 5: Выполните openclaw gateway restart, затем openclaw health для проверки сервиса; на удалённом Mac рекомендуется подключиться по VNC и один раз пройти полный цикл, чтобы не осталось неподтверждённых запросов прав.
④ Подводные камни: откат прав, конфликты портов, переменные окружения, VNC удалённый Mac
Откат прав: После обновления «нет прав на чтение/запись/выполнение» — часто tools.profile установлен в messaging; верните coding или full и перезапустите gateway.
Конфликты портов: Порт занят — lsof -i :порт для поиска процесса, завершить его или изменить конфиг на другой порт.
Переменные окружения: При запуске через launchd или PM2 явно задайте PATH и переменные API в plist или ecosystem, иначе интерактивный терминал может работать, а фоновый сервис — нет.
VNC удалённый Mac: Для обновления и первой авторизации всегда подключайтесь по VNC, чтобы обрабатывать системные диалоги и Keychain. После обновления можно использовать SSH для автоматизации. Обновление только по SSH может оставить диалоги недоступными для клика и заблокировать процесс.
openclaw doctor для применения миграции и исправлений; при переносе на новую машину копируйте ~/.openclaw/ и ~/.openclaw/workspace/ вместе, чтобы сохранить конфиг, состояние каналов и учётные данные.⑤ FAQ: откат, несколько экземпляров, ссылки на наши статьи по устранению неполадок
Как откатиться? При наличии бэкапа openclaw.json и workspace восстановите их, установите старую версию npm и перезапустите сервис; без бэкапа придётся перенастроить под новую логику.
Миграция нескольких экземпляров? У каждого экземпляра свой каталог конфига; делайте бэкап и обновляйте по отдельности, различая порты и profile.
Связанные статьи на сайте: При ошибках установки или выполнения см. OpenClaw частые ошибки и устранение неполадок; для диалогов авторизации на удалённом Mac — OpenClaw VNC одобрения и изоляция безопасности; выбор окружения — OpenClaw v2026.3.7 выбор окружения.
Почему для обновления OpenClaw на удалённом Mac лучше использовать VNC
Миграция 2026.3.x предполагает несколько «первых запусков» и возможные диалоги прав системы и Keychain. Только по SSH эти диалоги нажать нельзя, процесс может зависнуть. На VNC удалённом Mac вы можете завершить onboard, обработать диалоги и проверить openclaw health и логи как на локальной машине — путь обновления ясен, отладка быстрее. Чтобы избежать «после обновления не запускается» или «права не совпадают», делайте обновление и проверку на узле VNCMac удалённого Mac, а при необходимости используйте SSH для повседневной автоматизации — часто это самый надёжный и быстрый вариант.