헤드리스 Mac mini M4의 이벤트 기반 OpenClaw 게이트웨이는 두 번 죽는다. 한 번은 TLS 인그레스가 깜빡일 때, 또 한 번은 아무도 멱등 키를 표준화하지 않아 업스트림 재시도가 중복 특권 실행을 낳을 때다. 본 2026-05-07 매트릭스는 웹훅 중복 제거 계약, 재시도 상한, 데드레터 위생을 관측 가능 신호에 연결한다—표 2개, JSON-LD와 대응하는 롤아웃 8단계, FAQ, 인그레스 분할·구조화 로깅으로의 링크로 재무가 사고를 통제된 분산이 아니라 혼돈으로 읽지 않게 한다.
루프백 관리 대 공개 웹훅 분할 프록시로 인그레스를 강화하고, 게이트웨이 가시성·비식별로 텔레메트리 규율을 맞춘 뒤, 설치 후 스모크 매트릭스로 기준선을 확인하고 재시도 횟수만 돌린다.
중복 전달이 왜 중복 신뢰 실행이 되는가
로드밸런서, SaaS 브로커, 조급한 cron이 모두 POST를 재시도한다. 중복 제거 없이 각 재시도는 Apple Silicon 통합 메모리에서 또 하나의 도구 가능 에이전트 세션을 큐에 넣을 수 있다—CPU 그래프가 한가해 보여도 CI 이웃의 대역을 조용히 훔친다. 멱등 키는 운영자가 영수증을 업스트림 재생 창만큼 오래 유지하면 논리적으로 동일한 전달을 하나의 승인 실행으로 접는다.
- 지터 없는 폭풍: 동기화된 재시도가 단일 리전 게이트웨이에 스파이크를 증폭한다.
- 의미 모호: 안전 본문 없는 HTTP 500은 503용 공격적 재시도 정책을 물려받아선 안 된다.
- 감사 함정: 본문 해시 없는 DLQ는 규정 악몽을 재현한다.
운영 불변식: 관측 스택이 “이 웹훅은 이미 수락됐는가?”를 조회 200 ms 안에 답하지 못하면 중복 제거는 이론이다—백오프 곡선을 만지기 전에 저장소를 고친다.
매트릭스 A — HTTP 계열 대 재시도 정책 대 최대 시도 대 DLQ 자세
| HTTP 결과 | 재시도 정책 | 최대 시도 | DLQ 자세 |
|---|---|---|---|
| 429 / 503 | 지수 백오프 + 전체 지터 | 8 | 예산 소진 후에만 DLQ, 페이로드 해시 보존 |
| 408 / 연결 타임아웃 | 상한 있는 선형 백오프 | 6 | 10분간 타임아웃률이 5%를 넘기면 경고 |
| 400 / 401 / 403 | 자동 재시도 없음 | 0 | 즉시 DLQ, 서명자 귀속 필수 |
| 500 모호 본문 | 제한적 신중 재시도 | 3 | 수동 조정 티켓 자동 개설 |
매트릭스 B — 실패 냄새 대 모니터링 사각 대 완화
| 냄새 | 사각 | 완화 |
|---|---|---|
| 사용자 트래픽이 늘지 않아도 동일 페이로드로 CPU가 급등 | 영수증 누락 | 중앙 키 저장소를 켜고 TTL ≥ 업스트림 재생 창(기본 벤치마 24 h). |
| DLQ 깊이가 매주 월요일에 선형 성장 | 인증 로테이션을 무시하는 cron 재시도 | 비밀 파이프라인이 새 서명 재료 배포를 확인할 때까지 재시도를 막는다. |
| 게이트웨이 패치 후 지연 급증 | 뜨거운 키 캐시 없이 직렬 검증 | 영수증 조회를 샤딩하고 핫 경로는 각 Mac 게이트웨이의 로컬 SSD 백 스토어에 둔다. |
런북에 적을 만한 정량 손잡이
- 중복 제거 창: 업스트림 계약이 더 길지 않으면 수락 지문을 최소 24시간 보존한다.
- 웹훅 본문 상한: 명시 승인 없이 6 MB 초과 페이로드는 거절하거나 스트림 분할한다.
- 재생 SLA: 승인된 DLQ 재생은 운영자 확인 후 15분 안에 끝나야 한다.
8단계 롤아웃(JSON-LD와 대응)
- 키 표준화: 생산자 전체에—팀마다 난수는 금지.
- 응답 분류: 백오프 상수 조율 전에.
- 재시도 상한: 지터로 통합 메모리 이웃을 보호.
- 영수증 지속: 선언된 재생 창 동안.
- DLQ 운영: 해시와 승인.
- 인그레스 계측: 관리 API와 분리.
- 안전 재생: 이중 통제 하에.
- 분기 연습: 스테이징 리전에서 중복 폭주.
FAQ
멱등 키가 웹훅 서명을 대체하는가
아니다. 서명은 진위를, 키는 재시도 간 논리적 유일성을 증명한다. 둘 다 통과해야 한다.
영수증은 Redis만에 두어도 되는가
게이트웨이 프로세스 재시작을 견디는 내구성을 쓴다. 순수 휘발 캐시는 배포 뒤 중복 실행 재난을 되살린다.
전용 Mac mini M4에서 OpenClaw를 호스팅하면 네이티브 macOS 호환과 동시 도구 세션을 위한 Apple Silicon 처리량을 얻는다—바로 순진한 웹훅 재시도가 가장 아프게 하는 지점이다. NodeMac은 홍콩·일본·한국·싱가포르·미국에서 SSH 운영과 선택적 VNC를 제공해 스테이징 웹훅 폭풍을 프로덕션 게이트웨이와 분리한다. 단일 테넌트 하드웨어 렌탈은 공유 노트북보다 충돌 위험이 낮고, 리전 탄력으로 DLQ 재생 훈련을 CapEx 스파이크 없이 흡수한다—위 매트릭스와 결합하면 재시도가 특권 작업을 곱하지 않는다.