2026 OpenClaw MeshMac Webex Incoming Webhook 다중 노드 빌드·실패 요약·로테
MeshMac 풀에서 Webex 한 스페이스에만 진실을 남기려면 게이트웨이 한 대가 webexapis.com으로만 나가고 노드는 종료 이벤트만 큐에 넣으면 됩니다. 아래는 HTTP 표·로테·체크리스트입니다.
자세는 Mattermost·Teams 웹훅과 같이 단일 발신입니다. 토폴로지는 큐 동기화·OpenClaw 허브를 참고하고 실패 발췌는 짧게 로그엔 해시만 남깁니다.
이 패턴이 없애는 세 가지 통증
- 시크릿 확산. URL을 맥마다 복사하면 유출·로테 비용이 커집니다.
- 소유 모호. 큐 없이 부분 상태가 겹치면 스레드만 시끄럽습니다.
- 불투명 실패. CI 초록과 게이트웨이 POST 로그를 따로 봐야 합니다.
웹훅 구성
발신 한 곳. 게이트웨이만 webexapis.com TLS 종료 워커는 공유 큐에 종료 JSON만 넣습니다.
웹훅·본문. 스페이스에 Incoming Webhook 추가 후 URL 한 번 복사 베어러 취급 POST application/json markdown에 브랜치 SHA mesh_node_id provider_run_id 상태 run_url 실패 시 짧은 로그만 넣습니다.
출구. 게이트웨이에서 서비스와 동일 CA·프록시로 curl 프로브 타임아웃은 레이트·세션 상한과 맞춥니다.
- 로그엔 호스트·경로 끝 네 글자만 스테이징·프로덕션 훅 분리 프록시 SNI·CA 문서화
최소 권한
/etc/openclaw/secrets.d/webex/build-status.url 모드 0440 그룹 openclaw-notify 개발자는 제외 시크릿·최소 권한 참고.
REST가 불필요하면 봇 토큰은 게이트웨이 두 번째 파일만 로테 새 훅 파일 교체 리로드 프로브 구 훅 폐기 순은 IM·토큰 로테와 같이 적습니다.
재시도·백오프
429 503는 Retry-After 우선 없으면 지수 백오프·지터·상한 스페이스당 POST 직렬화로 떼 재시도 방지
provider_run_id+종료 state 멱등 큐 재시도 백프레셔 markdown 약2KiB 타임아웃 십이십초 인시던트는 카드 한 장 합치기
흔한 4xx·5xx 처리
온콜용 요약 표입니다 빠르게 분기합니다.
| HTTP | 가능 원인·조치 |
|---|---|
400 | 스키마·빈 본문 고치기 재시도 남발 금지 |
401·403 | URL 로테·정책·멤버십 |
404 | 훅 삭제·오타 재발급·파일 갱신 |
429 | 병합·동시도↓ Retry-After·백오프 |
500·503 | 지터 재시도 상한·상관 ID |
다중 노드 협업 가치
동일 스키마로 큐에 올리면 Webex엔 한 타임라인만 남습니다. 맥을 늘려도 URL 재배포가 없고 TLS 감사도 한 줄입니다. 같은 스트림을 Teams 요약으로 분기할 수 있습니다.
체크리스트·트러블슈팅
- curl 200·카드 표시
- 종료 이벤트만
- 멱등 캐시
- 방화벽
webexapis.com:443게이트웨이 서브넷만 - 로테 런북
CI 초록 무음: POST 로그·본문·프록시·UID curl 일부 맥: 직접 POST 금지 중복: 멱등·동시 포스터 축소