PDF·텔레그램 스트리밍·Teams가 한꺼번에 올 때의 통증 신호
가드레일·프록시·신원이 겹칩니다. pdfMaxBytesMb·pdfMaxPages 없이 PDF 이해를 켜면 헬스는 멀쩡해도 큐가 막혀 텔레그램 드롭처럼 보입니다. 인바운드 한도는 아웃바운드 미디어 정책과 같이 적습니다. 프록시가 청크를 버퍼링하면 curl -N으로 루프백과 공개 호스트명을 비교하고 Nginx·Caddy 가이드로 타임아웃을 맞춥니다. Teams SDK OAuth·카드 오류는 로그만으로는 안 보이므로 테넌트 진단을 교차 확인합니다. 노드 버전이 엇갈리면 openclaw doctor만으로는 부족합니다. 게이트웨이 운영 가이드 순서로 에지→루프백→채널을 봅니다.
비전 PDF는 토큰·동시 작업을 캡하고, 규제 환경에서는 로그에 본문 대신 상관 ID를 남깁니다.
2026년 3월 2026.3 운영 표면을 쉬운 말로
PDF는 agents.defaults.pdfModel, 텔레그램은 스트리밍 전제 전달, Teams는 공식 SDK·카드 스키마 쪽으로 정리됩니다. 운영에서는 모델·전송·신원을 갈래로 나눕니다.
코드 전에 방화벽·이그레스를 확인합니다. 엔드포인트와 Graph 범위는 클라우드 배포 FAQ와 대조하세요. 승격 전에는 비전 끄기·스트리밍 되돌리기·Teams 텍스트 폴백을 한 번에 리허설해 프록시가 청크를 캐시하는 등 숨은 결합을 드러냅니다.
PDF 수집: pdfModel, 한도, 폴백
슬라이드 중심이면 비전 프로필, 로그류는 텍스트 경로로 나눕니다. pdfMaxPages 절단·암호 실패는 지원이 약속할 수 있는 범위를 로그에 밝힙니다.
p95 파싱과 Apple Silicon 발열을 잽니다. 스테이징에서 대용량·손상 샘플로 지표가 안정된 뒤 프로덕션에 올립니다. 민감 문서는 등급별로 온프레·암호화 경로를 아키텍처 기록에 한 줄로 남깁니다.
텔레그램 스트리밍 기본값과 CPU 현실
HTTP 200만 보지 말고 이벤트 루프와 openclaw doctor --json을 함께 봅니다. 에지 속도 제한·청크 상관 ID로 웹훅부터 완료까지 추적합니다.
스트리밍과 롱폴링이 섞이면 경로별 버퍼 규칙을 문서화합니다. 재시도 폭풍 시 청크 시퀀스가 빠진 멱등 키는 중복 답을 만듭니다. 경계에서 중복 제거 지표를 노출합니다.
Microsoft Teams SDK: 권한, 카드, 재연결 규율
Graph 범위·비밀 순환을 TLS 런북과 같이 둡니다. 다지역은 공유 토큰 저장소나 스티키 라우팅이 없으면 한 노드 갱신이 다른 세션을 깹니다.
카드는 포털에서 먼저 검증하고, 토큰 파일 권한은 600을 벗어나면 사건으로 봅니다. 사고 시 카드 대신 수신 확인 모드로 명시적 저하를 보여줍니다. 게스트 테넌트는 파일럿 후 선언합니다.
판단 매트릭스: PDF 수집, 텔레그램 스트리밍, Teams SDK 위험
선택한 행을 방화벽·시크릿 항목 옆에 보관합니다.
| 축 | 주 이득 | 주 위험 | 첫 진단 |
|---|---|---|---|
| 네이티브 PDF + pdfModel | 슬라이드 답 | 페이지·메모리 | pdfMaxBytesMb, pdfMaxPages, 절단 로그 |
| 텔레그램 스트리밍 | 반응 UX | 프록시 버퍼 | 루프백·공개 호스트명 curl -N |
| Teams SDK | 인터랙티브 카드 | OAuth·조용한 드롭 | 포털 검증, 토큰 권한 |
| 하이브리드 모델 | 비용 | 능력 불일치 | 경로별 매트릭스 |
예: 20페이지 미만 PDF p95 12초, 활성 생성 시 청크 800ms 이내, Teams 카드 p99 3초 등 숫자 목표를 오류 예산에 넣습니다.
일곱 단계 프로덕션 체크리스트와 예시 설정 조각
비밀은 채팅에 붙이지 말고 스테이징에서 검증합니다.
# 1) PDF 가드
# agents.defaults.pdfModel: "vision-route-name"
# pdfMaxBytesMb: 12
# pdfMaxPages: 40
# 2) nginx 스타일 프록시 뒤 텔레그램 스트리밍
# proxy_buffering off;
# proxy_read_timeout 3600s;
# 3) Teams SDK 토큰 파일
# chmod 600 /var/lib/openclaw/teams/oauth.json
# 4) doctor JSON 베이스라인
# openclaw doctor --json | jq '.status'
# 5) 루프백 헬스
# curl -sS http://127.0.0.1:18789/health
# 6) 공개 스트리밍 탐침
# curl -N https://your.host.example/health
# 7) 프록시·게이트웨이 로그 공통 요청 ID
프록시가 스트리밍에 협조하지 않으면 같은 장애가 반복됩니다. 체크리스트는 런북 옆에 둡니다.
가시성, SLO, 롤백 순서
파싱 실패·청크 처리량·OAuth 갱신 카운터를 보냅니다. 롤백은 PDF 비전 끄기→스트리밍 플래그→Teams 토큰·카드 순을 기본으로 합니다.
에지와 게이트웨이를 요청 ID로 묶고, 리모트 Mac에서 비전 부하는 열·CPU 스로틀을 만듭니다. 분기 게임데이로 롤백 동작을 익힙니다.
FAQ, 상호 링크, 호스팅 리모트 Mac 트레이드오프
doctor는 건강한데 PDF 작업이 멈춥니다. 어디를 보나요?
절단 로그, 렌더 디스크, 모델 큐, 스트리밍 경로의 프록시 버퍼링을 봅니다.
텔레그램 스트리밍과 Teams가 같은 워커 풀을 써도 되나요?
가능하면 분리해 카드 폭주가 텔레그램 스레드를 고갈시키지 않게 하세요.
PDF 비전 모델을 Apple 하드웨어에서만 돌릴 수 있나요?
성능 되는 리모트 Mac에서 열·배치와 클라우드 페일오버 한도를 정하면 가능합니다.
요약: PDF 한도, 에지 스트리밍 검증, Teams OAuth를 doctor·프록시와 같은 층으로 다룹니다.
한계·선택: 공급자·정책 변화는 남습니다. 산출물·봇을 묶는 팀은 호스팅 리모트 Mac으로 인그레스를 단순화하기도 합니다. SFTPMAC은 격리 SFTP와 게이트웨이용 Mac 노드를 함께 씁니다.
OpenClaw 2026.3 PDF·채널을 안정 인그레스·파일 전달과 함께 쓰려면 SFTPMAC 플랜을 참고하세요.