2026 OpenClaw 대여 Mac Mini 실전 범용 HTTP Webhook(Zapier·Make)으로 일일 요약·429/5xx 백오프·멱등을 재현하는 단계

약 10분

렌탈 맥 미니에서 OpenClaw를 장기 가동할 때 HTTP 웹훅 경로가 흐트러지면 다이제스트가 비고, Zapier·Make 재시도가 429를 키우며 Bearer가 키 순환 후에도 어긋납니다. 표·일곱 단계·JSON·FAQ로 정리했습니다. 쿼터 하우투·GitLab 웹훅·고객센터.

대여 호스트에서 웹훅 다이제스트가 깨지는 이유

  1. 재부팅 뒤 포트 표류: 임시로 띄운 리스너와 SSH 세션만으로는 launchd 공백을 못 봅니다.
  2. 평면 URL: 진단용과 운영용이 한 경로에 섞이면 테스트 페이로드가 Slack 채널을 오염시킵니다.
  3. 멱등 없는 재시도: 지연 끝에 성공한 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_end ISO-8601
  • summary_text 채팅 한도(약 사 킬로바이트) 이내
  • severity info·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분 이내.
키 순환은 동시에?
이중 비밀로 한 창 겹친 뒤 게이트웨이→금고 순 전환.

운영자 일곱 단계 체크리스트

  1. 주소·포트·launchd 경로 런북 기록
  2. TLS·digest·alert 경로 분리
  3. 캐치 URL·토큰은 금고만
  4. run_id·시간 창 필수 방출
  5. 401·403 재시도 끔·지터 상한
  6. 인증 실패 마스킹 로그→티켓
  7. 7일 녹색 시 프로덕션·가격·콘솔 정렬

인용·감사용 수치

  • 이초 초기 백오프·십오 분 천장·여덟 회 자동 시도 상한
  • HMAC 허용 시계 편차 이분 이내 권장
  • summary_text 권장 상한 약 사 킬로바이트

장기 호스팅 자동화를 마무리하며

장기 호스팅: ·구매·고객센터·블로그를 북마크하세요.

OpenClaw 웹훅용 맥 미니 노드 선택

장기 렌탈로 게이트웨이·스케줄을 고정하세요. ·가격·구매·고객센터·블로그.

OpenClaw 웹훅용 맥 미니 대여