OpenClaw는 사용자에게 하나의 일관된 에이전트로 보이지만, 게이트웨이는 실제로 여러 채팅 API를 다루며 각각 재시도 의미가 다르다. 2026년 «모델이 미쳤다»처럼 보이는 사고는 종종 이중 전달된 Webhook이나 주 채널 장애에 대한 리허설된 보조 경로 부재다. 이 매트릭스는 Slack·Telegram·Discord의 페일오버를 순위 매기고, 멱등성 키를 정의하며, NodeMac 전용 Mac mini M4 호스트에 맞는 여덟 가지 재현 가능한 단계를 준다(SSH 자동화, 일회성 권한은 VNC, HK·JP·KR·SG·US 리전).
기준 통합: Slack 및 Discord Webhook, 멀티 모델 페일오버와 타임아웃, 상태 디렉터리와 헤드리스 게이트웨이 체크리스트. 헬스: 준비 프로브; 진단: doctor. 가격: 가격; 도움말: 도움말.
실제로 디버깅 중인 장애 모드
게이트웨이가 느린 HTTP 응답을 반환하면 채팅 제공자는 공격적으로 재시도한다. 도구 부작용(티켓, 배포, 환불)이 멱등이 아니면 재시도는 중복 사고가 된다. 별도로 Socket Mode나 롱 폴링은 노트북 절전, Wi‑Fi 변경, 기업 TLS 미들박스에서 끊긴다—고정 클라우드 Mac과 안정적인 이그레스에서는 증상이 사라진다.
- 적어도 한 번 전달이 기본 가정이다—그에 맞게 설계하라.
- 사람 에스컬레이션은 중복 제거 저장소를 쓸 수 없을 때 자동화를 우회해야 한다.
- 교차 게시로 같은 에이전트 답을 두 주 채널에 올리면 감사 추적이 혼란스럽다.
채널 등급 매트릭스
| 채널 | 2026년 최적 역할 | 페일오버 주의 |
|---|---|---|
| Slack | 엔터프라이즈 팀 주 채널; 풍부한 스레딩 | Socket Mode 토큰은 문서화된 캘린더로 회전 |
| Telegram | 빠른 개인 봇; 좋은 보조 방송 | 그룹 프라이버시 모드가 멘션 의미를 바꿈—실제 그룹으로 테스트 |
| Discord | 커뮤니티 대면 에이전트; Webhook 팬인 | 길드마다 속도 제한이 다름; 알림을 별도 샤드 |
멱등성 및 재생 매트릭스
| 인바운드 패턴 | 중복 제거 키 레시피 | TTL 힌트 |
|---|---|---|
| Slack Events API | event_id + team_id 해시 |
최소 24시간 |
| Telegram updates | 봇마다 update_id |
오래 오프라인 유지보수 가능하면 48시간 |
| Discord interactions | 인터랙션 페이로드 id + 길드 id |
더 긴 재시도를 프록시하지 않으면 12시간 |
스토리지 팁:중복 제거 상태를 OpenClaw 상태 디렉터리와 같은 비동기 볼륨에 두어 launchd에서 SQLite나 파일 잠금이 일관되게 동작하게 하라.
여덟 단계 롤아웃
- 등급 선언: 소유자가 있는 한 페이지 아키텍처 노트에.
- 중복 제거 저장소 구현: 히트율과 제거 메트릭 포함.
- 재생 테스트: 스테이징에서 저장한 페이로드를 채널마다 두 번.
- 서킷 브레이커 추가: 보조 채널도 오류면 사람에게 fail closed.
- 상관 ID 로깅: 게이트웨이, 도구 호출, 아웃바운드 채팅 답변을 가로지름.
- 토큰 회전 자동화: Slack Socket Mode는 분기마다 드릴.
- DNS 차단 게임 데이: 주 제공자 API에 대해.
- 동결 스위치 문서화: 구성을 삭제하지 않고 도구 실행 중지.
자주 묻는 질문
Slack과 Discord를 모두 주로 써야 하는가?
아니요—자동 도구 실행에는 주를 하나만; 다른 하나는 알림이나 저하 모드에.
좋은 중복 제거 키는?
안정적인 제공자 식별자에 작업 공간 또는 길드 범위를 더하고 해시해 재시도 창을 넘는 TTL로 저장.
전용 NodeMac Mac을 쓰는 이유는?
장수명 연결 가동 시간, 예측 가능한 경로, 사용자와 API에 가까운 리전 배치.