2026 OpenClaw 맥 미니
웹훅 칠곱이십사 최소 재현
렌탈 노드에서 쿠마·업타임 알림이 흩어지면 야간에도 슬랙이 터집니다. 여기서는 웹훅을 오픈클로 게이트웨이 한 줄로 모으고 UTC 침묵·백오프 캡·헬스 병합만 박습니다. 슬라이스마다 들어오는 바디 크기가 달라지므로 스토리지 여유와 동시 접속 상한을 먼저 정하고 템플릿 변수로 상태 이름을 넘기면 런북 검색이 빨라집니다.
통증
- 유알엘이 늘면 비밀 회전이 빡세집니다.
- 침묵 없으면 야간 알림 신뢰가 무너집니다.
- 백오프 없으면 장애 중 채널이 막힙니다.
쿠마 대 업타임
| 축 | 쿠마 | 깃 |
|---|---|---|
| 훅 | 알림 탭 | 액션 POST |
| 침묵 | 창 수동 | 분기 |
| 병합 | 부모 의존 | 한 이슈 |
전제 조건
- 에스에이치 렌탈 맥에 관리자 권한과 호스트 이름 고정.
- 에이씨엠이로 퍼블릭 티엘에스 받을 도메인.
- 오픈클로 이천이십육점오 실행 파일과 홈 경로 문서.
- 방화벽은 팔십과 사백사삼만 열고 감사 로그 보존.
- 런치디 표준에러는 별도 파일로 두고 실패 때만 메일.
설치·예시
게이트웨이를 루프백 이천칠백칠십칠에 두고 슬라이스마다 배치아이디와 모니터슬러그를 제이에스오엔 한 줄로 남깁니다. 야간 배치 예시는 동일 창 안에서 큐 길이와 완료 건수를 함께 찍어 헬스체크와 숫자를 맞춥니다.
export OPENCLAW_GATEWAY_LOG=json
export OPENCLAW_HOME="$HOME/.openclaw"
openclaw gateway --bind 127.0.0.1:2777 --log-fields batch_id,monitor_slug,slice_utc
게이트웨이·프록시
공개 훅은 티엘에스 끝단만 열고 루프백으로 넘깁니다. 인증서 갱신 실패 시에도 큐가 쌓이지 않게 헬스 엔드포인트는 별도 경로로 두고 웹훅만 이 블록에 태웁니다.
hooks.runmini.example {
reverse_proxy 127.0.0.1:2777
}
웹훅·침묵·백오프·병합
고정 예: https://hooks.runmini.example/hooks/uptime-kuma
- 침묵 OPENCLAW_SILENCE_UTC=18:00-02:00 래퍼에서 스킵.
- 백오프 OPENCLAW_ALERT_BACKOFF_CAP_SEC=300 초기 2·4·8초.
- 병합 부모 한 건에 자식 붙이고 dedupe 키=이름+slice.
launchd 보존
킵얼라이브와 스로틀인터벌 구십에서 백이십초 사이로 재기동 폭주를 누릅니다. 표준출력은 뉴시스로그와 짝을 맞추고 교대 근무자가 위키 한 줄만 보고도 재시작 순서를 따라가게 적어 둡니다.
<key>KeepAlive</key><true/>
<key>ThrottleInterval</key><integer>90</integer>
<key>StandardOutPath</key><string>/var/log/openclaw/gw.log</string>
HowTo 체크
- 루프백 게이트웨이 기동 후 JSON 로그 확인.
- Caddy로 TLS 붙이고 curl로 403 아님 검증.
- 쿠마 알림에 훅 URL·바디 템플릿 저장.
- launchd EnvironmentVariables에 침묵·캡 주입.
- 부모 모니터로 자식 묶기.
- 장애 시 tail로만 좁히기.
인용
- ① 백오프 캡 300초·지터 30초.
- ② ThrottleInterval 90~120초.
- ③ 공개는 2777이 아니라 프록시 포트만.
배포·장애 FAQ
- 403인데 쿠마는 초록?
- HEAD 막힘 흔함. 프로브와 훅 경로 분리.
- 쿠마·깃 동시 울림?
- source 필드로 나누고 dedupe 20초.
- launchd만 고치면 됨?
- TLS·디스크도 의심. 디스크 FAQ.
요금제 CTA
웹훅 트래픽에 맞춰 코어·디스크 플랜을 고르세요.