2026 OpenClaw 대여 Mac Mini 실전
범용 HTTP Webhook(Zapier·Make)으로 일일 요약·429/5xx 백오프·멱등을 재현하는 단계
2026년 4월 1일
RunMini 기술 전략팀
약 10분
렌탈 맥 미니에서 OpenClaw를 장기 가동할 때 HTTP 웹훅 경로가 흐트러지면 다이제스트가 비고, Zapier·Make 재시도가 429를 키우며 Bearer가 키 순환 후에도 어긋납니다. 표·일곱 단계·JSON·FAQ로 정리했습니다. 쿼터 하우투·GitLab 웹훅·고객센터.
대여 호스트에서 웹훅 다이제스트가 깨지는 이유
- 재부팅 뒤 포트 표류: 임시로 띄운 리스너와 SSH 세션만으로는 launchd 공백을 못 봅니다.
- 평면 URL: 진단용과 운영용이 한 경로에 섞이면 테스트 페이로드가 Slack 채널을 오염시킵니다.
- 멱등 없는 재시도: 지연 끝에 성공한 API를 노코드가 다시 쏘면 게시가 중복됩니다.
호스팅 다이제스트용 오케스트레이터 선택 표
| 레인 | 이럴 때 | 주의 |
|---|---|---|
| Zapier Webhooks | 같은 Zap에서 필터·SaaS 액션을 빠르게 묶을 때 | 태스크 쿼터·무료 지연 상한 |
| Make 커스텀 웹훅 | 시각 분기·시나리오 재사용이 많을 때 | 번들 한도·실행 로그 보존 |
| launchd·curl 직접 | 제삼자 금고 없이 비밀을 맥에만 둘 때 | 키 순환·셸 유지 부담 |
게이트웨이 가드 및 포트
게이트웨이는 고정 TCP 포트로 루프백·테일넷에만 바인딩하고 HTTPS 프록시가 TLS를 끝냅니다. 헬스와 모델 경로를 분리하고 렌탈 시리얼·리전 옆에 포트를 적어 둡니다.
웹훅 라우팅 설정
예약 요약은 POST /hooks/digest, 긴급 알림은 POST /hooks/alert처럼 레인별로 쪼개고 알 수 없는 메서드는 405로 막습니다.
{"route":"/hooks/digest","method":"POST","content_type":"application/json","auth":"Bearer"}
Zapier·Make 최소 시나리오 예시
Zapier: Catch Hook → severity 필터 → Slack·메일. Make: 커스텀 웹훅 → Router(run_id) → 확인만 게이트웨이 HTTP로.
스케줄은 7×24 매트릭스와 맞춰 VNC 창과 겹치지 않게.
일일 요약(다이제스트) 템플릿 필드
키 고정으로 노코드 필터가 유지됩니다. UTF-8·타임존 오프셋 명시.
run_id배치마다 유일window_start·window_endISO-8601summary_text채팅 한도(약 사 킬로바이트) 이내severityinfo·warn·critical 등 열거source_host렌탈 맥 호스트명과 일치
429/5xx 백오프와 멱등 키
429·5xx만 재시도. Retry-After 우선, 없으면 2초 시작·30% 지터·상한 ~15분·8회 후 에스컬레이션.
Idempotency-Key=run_id 또는 SQLite에 마지막 성공 키로 중복 게시 방지.
흔한 인증 실패 FAQ
- curl은 되는데 Zapier만 401
- 숨은 공백·
Bearer중복·따옴표 차이; 원시 헤더로 바이트 비교. - HMAC 웹훅이 갑자기 실패
- 맥·Make 타임존 정렬, 시계 오차 2분 이내.
- 키 순환은 동시에?
- 이중 비밀로 한 창 겹친 뒤 게이트웨이→금고 순 전환.
운영자 일곱 단계 체크리스트
- 주소·포트·launchd 경로 런북 기록
- TLS·digest·alert 경로 분리
- 캐치 URL·토큰은 금고만
run_id·시간 창 필수 방출- 401·403 재시도 끔·지터 상한
- 인증 실패 마스킹 로그→티켓
- 7일 녹색 시 프로덕션·가격·콘솔 정렬
인용·감사용 수치
- 이초 초기 백오프·십오 분 천장·여덟 회 자동 시도 상한
- HMAC 허용 시계 편차 이분 이내 권장
summary_text권장 상한 약 사 킬로바이트