2026: эксплуатация OpenClaw — health check шлюза и демон LaunchAgent

Зафиксируйте среду до того, как завести демон. Для стека OpenClaw в 2026 году на практике стандартизируют Node 22+ (проверьте node -v и npm -v под той же учётной записью, от которой будет работать LaunchAgent). Установите CLI по документации вашей ветки и заведите отдельного пользователя macOS для шлюза, чтобы права на каталоги логов и workspace не пересекались с интерактивным админом.

Вынесите секреты в файл, например ~/.openclaw/gateway.env, с правами chmod 600. Минимальный набор имён (уточните по своей сборке): OPENCLAW_GATEWAY_TOKEN, при необходимости хост и порт шлюза, а также HTTPS_PROXY / NO_PROXY, если патруль и сам процесс ходят в корпоративный прокси — иначе health check будет «дрожать» при смене маршрута, хотя процесс жив.

Сначала поднимите шлюз вручную в одной сессии: убедитесь, что порт свободен (lsof -nP -iTCP:ПОРТ), выполните документированную команду запуска OpenClaw gateway и проверьте запрос с заголовком Authorization: Bearer …. Полезно один раз убедиться, что без заголовка приходит ожидаемый отказ (401/403) — так вы отделяете проблемы сети от проблем аутентификации.

Для сценария «тот же Mac, что и CI-runner»: завяжите тяжёлые задания предзагрузки (git/npm/registry) на успешный внешний health check или на exit-код патруля. Пока gateway недоступен, не имеет смысла гонять обходные скрипты подтягивания — вы только множите таймауты у регистров. Именно здесь пользователям MacPull чаще всего нужен предсказуемый узел Apple Silicon с постоянным SSH и диском под кеши: меньше сюрпризов, чем на перегруженном мультитенанте.

1. Остановите «зависшие» процессы на том же порту (старые node после экспериментов).
2. Экспортируйте те же переменные, что потом пойдут в plist.
3. Запустите шлюз, зафиксируйте пути stdout/stderr для переноса в LaunchAgent.
4. Проверьте один успешный и один намеренно неавторизованный HTTP-запрос.
5. Запишите semver и время в внутренний changelog перед включением cron/CI.

Пользовательский LaunchAgent кладите в ~/Library/LaunchAgents/. В plist укажите WorkingDirectory, ProgramArguments, StandardOutPath и StandardErrorPath (например под ~/Library/Logs/OpenClaw/), RunAtLoad и пару KeepAlive + ThrottleInterval (например 30 с), чтобы при падении не крутить tight loop. На современных macOS загрузка обычно через launchctl bootstrap gui/$UID …; на старых заметках ещё встречается launchctl load.

Отдельный скрипт патруля (по cron на хосте или шагу CI с SSH) должен вызывать curl к health-endpoint с Bearer-токеном, проверять HTTP-код и при наличии — простое поле в JSON. Ненулевой exit-код пусть триггерит алерт раньше, чем в очередь встанут задания предзагрузки.

#!/bin/bash
set -euo pipefail
# Шаблон патруля — задайте HOST, PORT, TOKEN, HEALTH_PATH под вашу среду
HOST="${OPENCLAW_GATEWAY_HOST:-127.0.0.1}"
PORT="${OPENCLAW_GATEWAY_PORT:-18789}"
TOKEN="${OPENCLAW_GATEWAY_TOKEN:?укажите токен}"
HEALTH_PATH="${OPENCLAW_HEALTH_PATH:-/health}"
CODE=$(curl -s -o /tmp/oc_health.json -w "%{http_code}" \
  -H "Authorization: Bearer ${TOKEN}" \
  "http://${HOST}:${PORT}${HEALTH_PATH}")
test "$CODE" = "200" || { echo "health HTTP $CODE"; exit 1; }
if grep -q '"ok"' /tmp/oc_health.json 2>/dev/null; then
  grep -q '"ok":true' /tmp/oc_health.json || exit 1
fi
exit 0

Если тело ответа не JSON, уберите блок с grep и оставьте проверку кода 200 и при желании порога времени curl. После сбоя смотрите в первую очередь StandardErrorPath агента, затем — отдельный access-log шлюза, если вы его включили. Нехватка места на томе с логами иногда выглядит как «мистические» перезапуски: проверьте df -h на каталоге с логами.