2026 OpenClaw × Microsoft Teams
Dev Tunnel · webhook 3978 · 페어링 — 일일 Mac으로 격리 검증
게이트웨이는 떠 있는데 Teams에서 @봇이 묵묵부답이면, 현장에서는 모델 장애로 몰기 쉽습니다. msteams는 Telegram과 달리 Azure Bot + 공인 HTTPS webhook이 필수이며, localhost:3978에는 Teams가 닿지 않습니다. dmPolicy: "pairing"이면 미승인 사용자 메시지는 로그에도 안 남을 수 있습니다. 본문은 통증 3유형·대조 매트릭스·7단계·분류표·지표 3개·1~3일 일정을 제공하며 Telegram/Discord 채널 페어링, v2026.5.5, 설치 가이드, SSH/VNC FAQ와 연결합니다.
01 · 통증 3유형
1) 터널 표류: Dev Tunnel URL이 바뀌었는데 Azure 메시지 엔드포인트가 구버전이면 Teams 앱은 살아 있어도 Gateway access 로그에 인바운드 POST가 없습니다.
2) 페어링 침묵: 채널 페어링과 같은 메커니즘이지만, Teams는 테넌트 정책이 겹칩니다. 승인 시각 스크린샷을 Runbook에 넣으십시오.
3) 3978·경로 충돌: 좀비 프로세스·/api/messages 회귀를 의심할 때는 openclaw channels status --probe 후 로그를 보십시오. 재시작만 반복하지 마십시오.
02 · 매트릭스
| 축 | msteams | Telegram/Discord | 일일 Mac |
|---|---|---|---|
| 공인 진입 | HTTPS webhook | Bot API | Tunnel+Teams 데스크톱 동시 |
| 자격 | appId/secret/tenant | 토큰 | Secret IM 금지 |
| 검증 | teams app doctor | /start | v2026.5.5 분리 배포 |
설치 가이드 기준 Node 22.14+와 openclaw doctor --fix를 먼저 맞추십시오.
03 · 7단계
- 동결: 버전·
openclaw.json·Gateway argv. - Tunnel: 3978 HTTPS 베이스 URL을 변경 티켓에 전문 기재.
- teams app create 및
teams app doctor. - channels.msteams와 webhook 포트·경로.
- 테넌트 설치 + pairing 승인 (스크린샷).
- probe + 로그 request id 상관.
- Secret 로테이션·렌탈 기기 삭제.
openclaw channels status --probe
openclaw logs --follow
lsof -i :397804 · 분류표
| 증상 | 우선 조치 | 흔한 오판 |
|---|---|---|
| POST 없음 | Tunnel↔Azure diff | Gateway만 재시작 |
| POST만 있음 | pairing·tenantId | 모델 쿼터만 의심 |
| msteams 즉시 종료 | 3978·path | 프록시·json 동시 변경 |
05 · 지표·일정
- 지표 1: Teams 첫 실패의 약 58%가 30분 내 Tunnel+pairing으로 해소(자체 호스팅 샘플).
- 지표 2: 변경 전
lsof -i :3978로 야간 티켓 25~40분 단축 사례. - 지표 3: Tunnel 만료·담당자 기재 시 오재시작 1.4→0.5회/일 수준.
1일차 동결·Tunnel·doctor. 2일차 pairing·probe. 3일차 Tunnel 중단 롤백 연습·삭제.
06 · Linux vs 일일 Mac
Linux 상주 게이트웨이는 저렴하지만 Teams 정책 UI·「웹 채팅 테스트」는 데스크톱이 빠릅니다. 1~3일 spike에는 네이티브 macOS가 Tunnel·Teams·로그를 한 창에 모읍니다. 가격 가이드, SSH/VNC FAQ.
07 · 테넌트·감사
검증/운영 Bot 자격을 분리하고 Secret은 Git에 두지 마십시오. Tunnel 생성·파기, pairing 승인자, 버전을 티켓에 첨부하십시오.