2026 OpenClaw MeshMac 실전: Microsoft Teams Incoming Webhook으로 다중 노드 빌드 상태 브로드캐스트
MeshMac 풀에서 어느 Mac이 빌드하든 Teams 채널 하나로 상태를 모읍니다. OpenClaw 2026 게이트웨이만 Incoming Webhook을 호출하는 최소 경로와 다섯 가지 점검 축—커넥터·URL, 출구 화이트리스트, 집계 필드, 재시도·멱등, 미수신 FAQ—을 압축했습니다(본문 약 800–1500자).
클러스터 설치·동기화로 단일 게이트웨이를 두고 openclaw doctor까지 확인합니다. 워커는 공유 큐로 이벤트만 넣고 Teams POST는 게이트웨이만 합니다. 설정 트리는 프로젝트별 설정·로그, 구조 비교는 Matrix Webhook, 모음은 OpenClaw 허브입니다.
① Teams 커넥터와 URL 보안
채널에 Incoming Webhook을 만들고 URL을 베어러로 취급합니다. …/teams/build-status.url 한 파일·0440·전용 그룹만 읽게 하고, 권한 패턴은 시크릿·최소 권한과 맞춥니다.
- 로그: 전체 URL 금지, 호스트+토큰 끝 4자만.
- 로테이션: 커넥터 재발급 → 파일 교체 → 리로드(IM·토큰 로테이션).
- 환경: 스테이징·프로덕션 URL 분리.
- JSON: MessageCard 등 지원 스키마; 400은 스키마 오류 가능성 큼.
클래식 커넥터가 막히면 Power Automate 등 좁은 HTTPS 엔드포인트로 동일 모델을 유지합니다. 공유 빌드 Webhook의 검증·큐 원칙을 그대로 적용합니다.
② 게이트웨이·프록시 아웃바운드 화이트리스트
게이트웨이만 outlook.office.com·*.webhook.office.com 등 테넌트가 쓰는 호스트로 HTTPS POST합니다. TLS 프록시가 있으면 SNI를 문서화하고, 러너의 인터넷 직출구는 막습니다.
데몬과 동일 프록시 환경에서 curl -I로 CONNECT를 검증합니다. 노드별 웹훅 직통 예외를 없애면 페일오버 때 허용 목록이 단순해집니다.
③ 다중 노드 상태 집계 필드 설계
GitHub Actions·GitLab CI 등 페이로드를 게이트웨이에서 한 번 정규화한 뒤 Teams 텍스트·카드로 렌더링합니다.
| 정규화 키 | 소스 예 | Teams·운영 용도 |
|---|---|---|
workflow |
GitHub workflow, GitLab pipeline.name |
제목 줄: 어떤 자동화가 발화했는지 |
state |
conclusion, status, result | succeeded·failed·cancelled·running 등 팀 합의 이모지·색 구역 |
branch |
ref, head_branch | 릴리스 vs 피처 가시성 |
commit |
sha, commit.id | 짧은 7자 + 실행 페이지 링크 |
run_url |
html_url, web_url | 로그·아티팩트 심층 링크 |
mesh_node_id |
러너 이름, 호스트 라벨, 풀 태그 | 풀 안 어느 Mac이 실행했는지 푸터 |
provider_run_id |
run_id, pipeline id, build number | state와 함께 멱등·중복 제거 키 |
여유 있으면 duration_sec·queued_sec를 추가합니다. 네트워크 재시도는 태스크 큐·재시도와 잡 재실행과 분리합니다.
④ 재시도와 멱등성
429·5xx에는 지수 백오프·지터와 시도 상한을 씁니다. 상태 코드는 게이트웨이 로그에만 상세히 남깁니다.
멱등: provider_run_id + state로 72시간 창에서 중복 전송을 건너뜁니다(SQLite 등 소형 저장).
400·401은 페이로드·URL부터 수정합니다. 404는 커넥터 삭제로 봅니다.
⑤ 메시지가 안 올 때 FAQ
- CI는 녹색인데 채널이 비음
- 게이트웨이 POST·HTTP 코드 로그,
curl최소 본문, 테넌트 커넥터 정책을 확인합니다. - 일부 노드만 간헐 실패
- 직통 웹훅·옛 시크릿·프록시 우회 여부를 보고 게이트웨이 단일 경로로 통일합니다.
- 200인데 카드 오류
@type·summary·title·길이 제한을 점검합니다.- 월요일에만 끊김
- 프록시 인증서·DNS·시크릿 잡을 의심하고 로테이션 런북과 비교합니다.
요약
게이트웨이 우선·URL 한 곳·출구 화이트리스트·mesh_node_id·멱등 재시도. 홈·블로그·도움말은 로그인 없이 열람 가능합니다.