프로덕션 OpenClaw 게이트웨이는 네이티브 macOS에서 일회성 REST보다 오래 지속되는 WebSocket 세션을 더 많이 붙잡는다——그럼에도 팀은 HTTP 타임아웃만 조정하고 배포 중 채팅 클라이언트가 떨리는 이유를 궁금해한다. 이번 2026-05-08 매트릭스는 인그레스 한도, 인플라이트 역압, 재연결 정책을 하나의 계약으로 본다: hello에서 상한을 알리고 익명 버스트를 집게 하며 재연결 루프에 지터를 넣어 자동화 클라이언트 떼가 장애를 재현하지 않게 한다. 두 표, JSON-LD 8단계, FAQ, 분할 인그레스와 관측 가능성 링크로 운영자는 Apple Silicon M4 CPU뿐 아니라 큐 깊이를 본다.
루프백 대 공개 인그레스 분할과 짝을 이루고, 게이트웨이 인증과 도구 속도 한도의 인증된 invoke 스로틀과 비교하며, 게이트웨이 관측 가능성과 마스킹으로 로그를 정직하게 유지해 재시도가 권한 페이로드를 숨기지 않게 한다.
WebSocket 폭풍 동안 CPU 유휴 그래프가 거짓말하는 이유
Apple Silicon 통합 메모리는 CPU 사용률을 온순하게 유지하지만 연결 테이블, TLS 세션, 프레임 파서가 모델 호출과 같은 코어를 다툰다. Mac mini M4 게이트웨이가 CI 레인과 함께 있으면 업로드 버스트와 시뮬레이터 회전이 CPU 게이지를 움직이지 않고 PCIe/NIC 주의를 빼앗는다——클라이언트가 「모델 지연」을 느낄 때 병목이 소켓 가장자리 승인 제어일 때가 바로 그때다.
- 대칭 재연결 떼: 지터가 정렬을 깨지 않으면 클라이언트는 cron과 재시도 박자를 공유한다.
- 익명 인그레스: 경로를 분할하지 않으면 webhook이나 채팅 브리지가 신뢰 자동화와 같은 리스너 계열을 친다.
- 숨은 큐: 서버는 TCP를 받아들이고 애플리케이션 큐는 부풀어 오른다——드롭이 시작되기 전까지 활성 프로브는 녹색이다.
설계 체크포인트: 공표된 한도는 hello 핸드셰이크에 속한다——429 JSON에서만 한도를 배운 클라이언트는 트래픽을 책임 있게 형상화하기엔 너무 늦다.
매트릭스 A — 정책 표면 vs 운영 가정 vs 검증 습관
| 정책 표면 | 흔한 가정 | 검증 수단 |
|---|---|---|
| 연결별 프레임 창 | 「클라이언트가 공손히 자기 제한한다」 | 공격적 자동화로 부하 테스트; 하드 종료 전 경고를 기대한다. |
| 인플라이트 큐 깊이 | TCP 수락이 건강과 같다 | 큐 깊이 메트릭 내보내기; 연결 클래스당 보류 프레임이 64를 넘으면 알림. |
| 재연결 백오프 정책 | 고정 5초 재시도면 충분 | 통제 게이트웨이 재시작 훈련 후 재연결 충돌 측정. |
매트릭스 B — 장애 모드 vs 신호 vs 완화
| 장애 모드 | 신호 | 완화 |
|---|---|---|
| 우레와 같은 재연결 떼 | 로그의 대칭 끊김 스파이크 | 지터 계수를 0.35로 올림; IP당 최대 동시 세션을 일시 절반으로. |
| CPU 상승 없는 큐 성장 | 지연 증가 while CPU < 40% | 익명 경로에 역압 드롭 활성화; 관리 트래픽을 루프백 리스너로. |
| 릴리스 간 정책 드리프트 | 클라이언트가 불일치 hello 상한을 봄 | 게이트웨이 semver 고정; 재시작 전 구성 검증; 런북에 semver 기록. |
생산적으로 다툴 수 있는 숫자 기본값
- 재연결 기본 지연: 2초에서 시작, 지수 계수 2×, 상한 60초, 지터 폭 ±35%.
- 프레임 예산: 피크 채팅 자동화에서 인증 세션당 10초에 애플리케이션 메시지 100건 가정——측정 p99로 조정.
- 인시던트 SLA: 5분 동안 세션 15% 이상 끊김율이 지속되면 모델 제공자 탓하기 전에 게이트웨이 소유자에게 페이지.
8단계 롤아웃(JSON-LD와 대응)
- 한도 공표 모든 리스너 클래스 hello에서.
- 사전 인증 제한 연결 시도 슬라이딩 윈도우.
- 인플라이트 경계 명시적 드롭 또는 일시중지 의미론.
- 재연결 조정 자동화 함대 전체에 지터 백오프.
- 인그레스 분할 관리 경로가 익명 경합을 피하게.
- 구조화 로그 상관 ID 이벤트.
- 왜곡 알림 수락률과 처리율 사이.
- 분기 검토 벤더 한도와 클라이언트 성장 대비.
FAQ
WebSocket 인그레스가 빡빡해도 HTTP 속도 제한이 필요한가?
예——다른 표면; 공격자나 버그 클라이언트는 소켓이 양호해도 REST invoke를 남용할 수 있다.
게이트웨이를 무거운 CI와 같은 Mac에서 돌려야 하는가?
cgroup 클래스 스케줄링 규율이 있을 때만; 프로덕션 채팅 게이트웨이는 격리 호스트나 엄격 CPU 고정이 마땅하다——NodeMac 리전은 깜짝 지연보다 격리가 저렴하다.
홍콩, 일본, 한국, 싱가포르, 미국에서 임대 Mac mini M4 용량으로 OpenClaw를 운영하면 채팅 인그레스 실험과 CI 업로드를 분리한다——둘 다 네트워크를 압박하지만 정책은 다르다. Apple Silicon 효율보다 승인의 정직함이 중요하다; SSH 자동화와 선택적 VNC는 macOS가 무인 복구를 막을 때 동의 프롬프트를 해결한다. 물리 전용 노드는 공유 노트북 대비 시끄러운 이웃 스토리를 줄이고 위 매트릭스는 WebSocket 행동을 「모델이 느리다」 속설이 아니라 측정 가능한 SLO로 바꾼다.