2026 OpenClaw 맥 미니 대여 실전
Zendesk 웹훅으로 야간 배치 티켓 요약·침묵창·백오프 재시도를 같은 런북에 고정하기
2026년 4월 20일
RunMini 기술 전략팀
약 9분
칠곱이십사로 대여 맥 미니에 OpenClaw를 올리면 사람이 보는 기록은 Zendesk에 남고, 새벽에는 큐를 묶은 야간 다이제스트가 돌아갑니다. 트리거 웹훅은 인바운드 JSON을 밀어 넣고 Support API는 내부 노트로 요약을 씁니다. 그런데 토큰 범위·HTTPS 게이트웨이·스케줄이 흐트러지면 새벽에 상담원만 깨웁니다.
같은 패턴은 Datadog 이벤트·Opsgenie 웹훅 글과 짝을 이룹니다. 설치·런타임 고정은 전 플랫폼 설치를 먼저 맞추세요. 공개 구매는 로그인 없이(플랜에 따름).
야간에 깨지는 세 가지
- 공용 관리자 토큰 이메일+API 토큰 한 쌍이 유출되면 Support 전 범위가 흔들립니다. 런치디 plist 한 줄도 비밀 저장소와 분리하세요.
- 끝없는 웹훅 파싱 실패해도 엣지가 이백을 주면 트리거는 성공으로 남고 OpenClaw 쪽 작업만 쌓입니다.
- 재시도 폭풍 사백이십구에 지터 없이 달리면 세그먼트 재시작이 겹쳐 지역별 한도가 길어집니다.
인바운드 웹훅과 아웃바운드 Support API
감사 추적을 만족하는 최소 표면만 고르세요. 실시간 이벤트는 HTTPS 리스너로 밀고, 야간 요약은 검색·뷰로 묶어 POST하는 편이 낫습니다.
| 필요 | 트리거 웹훅 | 미니에서 API |
|---|---|---|
| 실시간 티켓 | JSON을 OpenClaw 근처로 푸시 | 폴링은 지연이 붙음 |
| 야간 다이제스트 | 집계에는 부적합 | 내부 노트에 마크다운 |
| 이그레스 감사 | TLS 호스트·체인 증명 | zendesk.com만 허용하면 단순 |
침묵창·백오프·중복 임계
한 대 호스트 칠곱이십사 기본값입니다. 잡 p95와 Zendesk RateLimit 헤더로 조정하세요.
| 항목 | 시작값 | 메모 |
|---|---|---|
| 침묵 꼬리 | 유지보수 종료 + 십오~삼십 분 | Zendesk 일정과 런치디 플래그 정렬 |
| 백오프 | 이 초 시작·육십 초 상한·다섯 회 | 매 수면에 이십퍼센트 지터 |
| 중복 창 | 동일 다이제스트 해시 오 분 | 상태 볼륨에 체크섬 |
| 게이트웨이 알림 | 오xx 세 번 연속 | TLS 만료·업스트림 부하와 상관 |
OpenClaw가 지켜야 할 다이제스트 계약
매크로·뷰가 조용히 깨지지 않게 batch_schema 태그로 버전을 박습니다.
- ticket_ids 정렬·링크로 주간 트리아지에 바로 들어가게.
- priority_mix 긴급도별 건수로 모바일 스캔이 빠르게.
- segment 런치디 라벨+OpenClaw 빌드 해시.
- window_utc 감사·재생 분쟁용 명시 구간.
- error_summary와 멱등용 external_id.
설치부터 검증까지 일곱 단계
- 설치 상단에서 링크한 전 플랫폼 설치 가이드로 OpenClaw를 올리고 Node 런타임을 고정합니다. 웹훅 버퍼는 빠른 NVMe WorkingDirectory에 둡니다.
- 토큰 봇 관리자에 전용 Support API 토큰을 만들고
email/token을 깃 밖에 chmod 육백으로 두며 EnvironmentVariables로 주입합니다. 렌탈 이미지 갈아엎을 때마다 회전합니다. - TLS Caddy·nginx로 공개 DNS 이름에 인증서를 걸고 로컬 리스너로 포워드합니다.
openssl s_client -connect로 체인을 보고 Zendesk 트리거 테스트가 오 초 안에 이백인지 확인합니다. - 게이트웨이 기초 점검 사백일·사백삼이면 시크릿·HMAC·IP 허용을, 오백이·게이트웨이 타임아웃이면 프록시 바디 한도·킵얼라이브를 먼저 올립니다. OpenClaw 자체를 의심하기 전에 엣지 로그를 봅니다.
- 야간 배치 뷰·검색으로 큐를 묶어 내부 노트에 POST하고 Zendesk 유지보수 UTC와 동일한 침묵 플래그로 아웃바운드를 멈춥니다.
- HTTP 클라이언트 사백이십구·오xx에 지수 백오프,
Retry-After우선, 시도 상한,x-zendesk-request-id로그를 남깁니다. - 로그·알림 구조화 로그를 디스크나 Vector로 보내고 웹훅 오류율이 임계를 넘으면 알림. 재시도 예산이 바닥난 뒤에만 사람을 깨우면 칠곱이십사 운영이 안정됩니다.
인용·감사용 수치
중복 창 오 분, 다이제스트당 시도 다섯 회, 백오프 상한 육십 초, 침묵 꼬리 십오 분, 테넌트 파이프라인당 external_id 하나, 게이트웨이 실패 세 번 연속 후 페이징.
FAQ
- OAuth가 나을까요 API 토큰이 나을까요
- 여러 고객에게 파는 앱이면 OAuth, 단일 렌탈 호스트 자동화는 토큰이 단순합니다. 호스트마다 토큰을 쪼개세요.
- 전송 성공인데 워커가 비었습니다
- TLS 종료 직후 단계별로 서명·파싱 로그를 나누면 원인이 갈립니다.
- 프로세스 재시작 후 노트가 두 번 달립니다
- 창마다 마지막 성공 id를 디스크에 두고 제목 문자열을 고정하세요.