Если вы уже держите OpenClaw Gateway как демон на удалённом Mac, опасный момент не в том, чтобы один раз набрать npm install -g. Опасность в связке границ глобального Node, атомарных бэкапов конфигурации и учётных данных, post-upgrade probe, которые отделяют запущенный процесс от здоровья каналов, и обратимого pin версии npm, когда upstream движется быстро. Текст для команд, которые умеют поднять Gateway вручную и теперь хотят аудируемый путь: короткий список сбоев, матрица решений на месте против параллельной схемы, копируемый каркас команд, шесть операционных шагов и четыре ссылки для записи об изменении. Цены на странице тарифов NOVAKVM, заказ на странице заказа, политика доступа в центре помощи. При работе с вебхуками или обратным прокси перечитайте runbook установки и статью по каналам из индекса блога.
После чтения вы знаете, откатывать ли сначала npm или LaunchAgent, когда оба сигнала подозрительны, как использовать openclaw gateway probe как границу между зелёным процессом и реально живыми каналами и как задействовать bare-metal в Сингапуре, Японии, Южной Корее, Гонконге, востоке США и западе США с запасом M4 Pro, чтобы репетировать обновления без порчи продакшен-томов. Ссылки upstream и поведение версий меняются; откройте их снова перед выполнением.
Основные входы upstream, по одному URL в абзаце для удобного копирования.
https://github.com/openclaw/openclaw
https://openclaws.io/docs/install/updating/
[ SECTION_01 ] // PAIN_MAP Где обновления OpenClaw рвут Gateway в проде
- Два мира PATH: интерактивные шеллы видят новый глобальный префикс bin, а задания LaunchAgent всё ещё указывают на старый, что даёт ручной успех и провал после перезагрузки.
- JSON без учётных данных: копирование только
openclaw.jsonтеряет деревоcredentials; каналы падают с ошибками в форме учётных данных, похожими на регрессии. - Логи и рабочая область на одном малом томе: миграции или переиндексация усиливают запись; если логи Gateway на том же томе, вы гоняетесь за призраками в релиз-нотах.
- Пропуск probe после start: нулевой код выхода
openclaw gateway startне доказывает здоровье вебхуков или локальных слушателей; откладываяgateway probe, вы переносите боль на пик трафика. - Слепой
@latestбез записанного pin: откат превращается в угадывание тега вместо одной строки npm. - Малые хосты в окне обслуживания: давление по памяти и дрожь диска во время обновления маскируются под регрессии upstream; выделенный Apple silicon с запасом изолирует переменные.
Дополнительно зафиксируйте, какие сервисные учётные записи куда пишут, и совпадает ли личность runner CI с продакшен-пользователем LaunchAgent. Зелёный pipeline, обновляющий неверный префикс, хуже ручного окна, потому что скрывает зону поражения до прихода трафика. Для холодных копий, где могут быть токены или содержимое каналов, опишите цель, срок хранения и цепочку доступа в соответствии с внутренними правилами и применимыми требованиями к персональным данным, чтобы артефакты обслуживания не были шире необходимого.
[ SECTION_02 ] // DECISION_MATRIX Обновление на месте, параллельный префикс и откат npm
Матрица меняет радиус изменения на стоимость отката. На узком экране прокручивайте таблицу горизонтально.
| Стратегия | Лучшее окно | Якорь отката |
|---|---|---|
| На месте npm | Малые semver с читаемыми нотами и тридцатью минутами на probe | Сохранить npm ls -g --depth=0 до изменения; держать готовым npm install -g openclaw@<previous> |
| Параллельное переключение каталога | Средний риск, когда важны дельты конфигурации или ABI плагинов | Рабочие области и конфигурации с меткой времени; менять symlink входа или argv, не наступая на открытые дескрипторы |
| Заморозка версии | Аудит пересекается с неделей релиза или известными тредами регрессий | Запись об изменении фиксирует замороженный semver, владельца окна восстановления и допустимые минуты простоя |
Большинство команд выживают на обновлении на месте, строгих probe и зафиксированном откате npm. Параллельные деревья помогают, когда поверхность конфигурации или каналов достаточно разошлась для параллельной репетиции.
Хуки автоматизации заслуживают ту же строгость, что и бинарники: если CI запускает удалённые скрипты обновления, личность runner должна совпадать с продакшен-пользователем LaunchAgent, а секреты в CI не должны быть шире потребности. Ссылки документации входят в артефакт изменения: вставьте точный коммит или тег, который вы читали, а не только плавающий latest, чтобы ревьюеры воспроизвели допущения. Держите пакет ссылок рядом с транскриптом probe в тикете для аудита и дежурства.
Добавьте три строки передачи: какие порты были активны, какие внешние healthcheck были зелёными, менялась ли ротация логов в окне. Это экономит часы, когда следующий релиз приходит на следующий день и никто не помнит промежуточную версию в проде.
[ SECTION_03 ] // COMMANDS Глобальный npm плюс version, status и probe
Ниже показана структура, а не финальная линия безопасности. Перед запуском сверьте требования к мажору Node с README upstream. Запускайте probe в том же пользовательском контексте, что и прод, чтобы избежать ложных срабатываний, когда root проходит, а LaunchAgent нет. В тихом окне перепроверьте, остаётся ли обязательным Node 22 или новее для вашей цели.
npm install -g openclaw@latest
openclaw --version
openclaw status
openclaw gateway restart
openclaw gateway probe
В macOS с LaunchAgent, если перезапуск ведёт себя странно, используйте launchctl в окне обслуживания, чтобы убедиться, что загруженная plist всё ещё указывает на нужный исполняемый файл. Имена меток плывут между релизами; следуйте актуальным заметкам upstream, а не устаревшим идентификаторам.
Запишите порядок разбора как короткий сценарий, а не импровизацию: подтвердите существование процесса и привязку слушателя, затем просмотрите хвосты логов на ошибки в форме сертификата или DNS, и только потом подозревайте регрессии upstream. Снимите semver, глобальный префикс npm и ProgramArguments LaunchAgent вместе, чтобы ночные обсуждения оставались фактическими.
Ещё одна слепая зона — порядок между обновлением и пересборкой кэша: некоторые релизы предлагают переиндексацию или миграцию локального состояния. Под пиковой нагрузкой и при малом свободном месте обычное ожидание I/O выглядит как зависание. Сначала прогоните полное обновление плюс probe на равном по классу staging-хосте, затем повторите тот же скрипт в окне; краткая аренда bare metal даёт чистую репетицию без касания продакшен-томов. После окна снова сравните свободное место и убедитесь, что ротация логов соответствует политике.
[ SECTION_04 ] // BACKUP Чеклист бэкапа, который нужно зафиксировать до изменения
- Основной конфиг: обычно
openclaw.json; скопируйте в имя с меткой времени и проверьте парсинг JSON. - Деревья учётных данных:
credentialsили путь из документации upstream; откатывайте конфигурацию и учётные данные одним блоком. - Рабочая область и кэши: зафиксируйте размеры и пути; решите, стоят ли холодные копии времени при измеренном риске.
- Определения LaunchAgent: экспортируйте активную plist или эквивалент установщика; восстановите контекст запуска до споров о слоях npm.
- Инвентарь каналов и портов: перечислите Telegram, Discord или другие URL вебхуков и health для галочек после обновления.
- Персональные следы: если логи или экспорты могут содержать данные из каналов, опишите цель, место хранения, срок удаления и роли доступа до выноса копий за пределы продакшен-сервера.
После бэкапов выполните репетицию только для чтения: импортируйте копии под временным пользователем или префиксом без записи в продакшен-пути, запустите минимальные status и probe, убедитесь, что относительные пути разрешаются в рабочих каталогах LaunchAgent. Много сбоев после обновления — это дрейф cwd, а не повреждённые пакеты. Упражнение также показывает, не лежат ли чувствительные файлы там, где менеджер пакетов может убрать мусор.
[ SECTION_05 ] // RUNBOOK Шесть шагов от репетиции только для чтения до восстановления LaunchAgent
- Зафиксируйте запись об изменении: целевой semver, окно обслуживания, владелец отката, допустимые минуты простоя.
- Холодные артефакты: конфигурация, учётные данные, снимок рабочей области и вывод
npm ls -g --depth=0. - Приостановите вход: остановите вебхуки или покажите обслуживание на периметре, чтобы полуобновлённые писатели не трогали пользовательские данные.
- Выполните npm-обновление и проверку:
openclaw --versionиopenclaw statusдолжны совпадать с замыслом релиз-ноты. - Перезапустите Gateway и probe:
openclaw gateway restartзатемopenclaw gateway probe; перезагрузите LaunchAgent по указанию upstream и снова выполните probe. - Выровняйте политику и поднимите трафик: сверьте удалённые сессии, параллелизм и логирование с центром помощи, при необходимости скорректируйте размер на странице заказа, цены по странице тарифов остаются эталоном.
Расширьте runbook коротким блоком постмортем даже при успехе: настенные часы по шагам, точный semver до и после, были ли сбои probe временными или постоянными. Эта привычка превращает следующее окно из археологии в diff. Если несколько регионов обслуживают один канал, запишите, какой ствол нёс ingress в окне, чтобы связать отчёты о задержке с состоянием машины, а не слепо винить релиз.
Когда секреты крутятся реже пакетов, явно укажите, касается ли это окно токенов вообще. Наполовину обновлённые каталоги учётных данных вместе со свежими бинарниками часто дают частичные сбои, похожие в логах на сеть.
[ SECTION_06 ] // HARD_FACTS Проверяемые источники, сигналы отката, завершение в проде
- Релизы и issues upstream: GitHub Releases и Issues несут треды регрессий и рекомендуемый порядок; прочитайте пункты, связанные с вашим целевым тегом, до изменения. Источник: страница репозитория GitHub; откройте снова перед выполнением.
- Официальная документация updating: описывает глобальные обновления пакетов и порядок перезапуска Gateway; текст движется с релизами. Источник: страница updating на openclaws.io.
- Граница мажора Node: upstream задаёт требования к рантайму, которые меняются; держите совместимость Node 22 или новее в той же записи об изменении. Источник: README и релиз-ноты.
- След NOVAKVM: выделенные bare-metal Mac mini в Сингапуре, Японии, Южной Корее, Гонконге, востоке и западе США с уровнями M4 и M4 Pro для низколатентного разбора в окнах. Источник: страница тарифов и центр помощи на сайте.
Общая виртуализация или прод только на ноутбуке усиливают риск обновления за счёт шума соседей, политики сна и неаудируемого локального дрейфа. Держать Gateway на выделенном bare-metal Apple silicon сжимает переменные до версии пакета, конфигурации и контекста запуска.
Бюджет диска заслуживает отдельной строки в записи: свободное место до обновления, сразу после установки пакетов и после первого полного цикла probe. Если политика ротации логов изменилась между релизами, проверьте хранение на соответствие требованиям до объявления победы.
Для следующего окна OpenClaw набросайте доступные уровни M4 Pro и диска на странице тарифов NOVAKVM, затем репетируйте probe на хосте, который вы поднимаете через страницу заказа и который отражает топологию продакшена. Когда нужны задержка в шести регионах, повторяемые обновления и чёткие операционные границы для агентов, облачная bare-metal аренда Mac mini NOVAKVM чаще даёт более воспроизводимую базу, чем импровизация на потребительском железе с дрейфом. Продолжайте в центре помощи и в индексе инженерного блога на сайте.