2026 OpenClaw Gateway 7×24: сбои и диагностика демона — install-daemon, launchd и openclaw health (воспроизводимый сценарий)

2. Три частых корневых причины

1. launchd против интерактивной оболочки: запуск openclaw gateway вручную подхватывает nvm/fnm и свой PATH, а LaunchAgents наследуют только EnvironmentVariables из plist. Симптомы — эпизодические command not found или отсутствующие пути к локальным моделям.
2. Спираль «падение — throttle» (ThrottleInterval): 429 от upstream, ротация сертификатов или конфликт портов быстро завершают процесс; launchd перезапускает через секунды, попадает в откат — снаружи это «тихие минуты». Без LastExitStatus это часто принимают за чисто сетевой сбой.
3. Проверки здоровья без readiness: опрос «процесс жив» вместо готовности по HTTP или слишком агрессивный опрос дают ложные перезапуски при GC или смене DNS-кэша и усиливают проблему ThrottleInterval. Сценарии с фоновыми обходами (цены, compliance) добавляют плановую нагрузку — синхронизируйте окна с оркестратором, чтобы пики шлюза не совпадали с «слепыми» cron-штормами. Почему физический Mac mini M4 выигрывает у облака по задержке и стабильности агентов — в обзоре локального развёртывания OpenClaw на Mac mini M4.

3. Матрица: симптом → доказательства → действие

Одна таблица — что видит пользователь, что собрать первым делом и какой шаг снизит хаос в логах.

4. Семь воспроизводимых шагов

1. Базовая линия: в здоровом состоянии выполните openclaw health --json, если сборка поддерживает JSON; сохраните URL прослушивания, версию и проверки зависимостей как эталон.
2. Окно воспроизведения: log stream --predicate 'process == "launchd"' или Console с фильтром по Label Gateway; сфокусируйтесь на ±5 минутах вокруг инцидента.
3. Состояние launchd: launchctl print gui/$(id -u)/com.openclaw.gateway (подставьте свой Label), зафиксируйте LastExitStatus, число запусков и state.
4. Переустановка демона: в окне обслуживания openclaw install-daemon, затем launchctl bootout для старой записи и launchctl bootstrap нового plist — без двух экземпляров.
5. Параметры: осмысленный ThrottleInterval (часто ≥10 с), KeepAlive и ExitTimeOut (разумная отправная точка — 20 с), чтобы при SIGTERM успеть корректно закрыть соединения.
6. Пробы health: внешняя оркестрация — openclaw health каждые 30–60 с; алерт после трёх подряд неудач, чтобы отсечь джиттер.
7. Приёмка: кривая health и счётчики запусков launchd за 24 ч; ступенчатый рост — вернитесь к шагу 3 и сравните коды выхода.

5. Цифры и чек-лист

• ExitTimeOut 20 с: даёт время на drain после SIGTERM; слишком мало — launchd шлёт SIGKILL и фиксирует ненулевой выход.
• Опрос health 30–60 с: баланс ложных срабатываний и задержки обнаружения; внутренние метрики можно чаще (например 15 с), не связывая политику рестарта с этим шагом.
• ThrottleInterval ≥10 с: временно гасит шторм перезапусков до устранения первопричины; дополняйте лимитами upstream и мониторингом сертификатов, а не одним только откатом.

6. Почему Mac mini спокойнее для Gateway

Нагрузки шлюза плохо переносят два скрытых риска: перезагрузки из‑за питания/температуры и лишний слой виртуализации с джиттером планировщика. Mac mini на Apple Silicon часто простаивает около ~4 Вт в розетке — это удобно для постоянных демонов; связка macOS и Silicon упрощает рассуждения о launchd, сети и TLS при написании runbook.

На выделенном железе меньше «таинственной» задержки соседей по гипервизору, чем в мультитенантных VM. Нативный Unix-стек и SSH — первый класс, шаги выше легко встраиваются в CI или плейбуки дежурства.

Если нужен OpenClaw Gateway на тихом, экономичном и предсказуемом железе, Mac mini M4 — сильная отправная точка: посмотрите узлы ZoneMac и за один проход выровняйте раскладку демона и мониторинг.