회의 경로 · 결정 매트릭스 · 8단계 런북 · VNC 검수
라이브 미팅에 OpenClaw를 붙이는 운영팀은 채팅 채널과 다른 실패 모드를 맞닥뜨린다. 오디오는 듀플렉스여야 하고 PSTN 참가자에게 안정적인 다이얼인이 필요하며, 회의실 소리를 듣는 어시스턴트에게 API 키를 브라우저 탭에 넣고 싶지 않다.OpenClaw v2026.5.4는 Google Meet 인그레스(캘린더 인지 참가·룸 오디오 캡처), Twilio 다이얼인(SecretRef PSTN 레그), Gateway 호스팅 Gemini 실시간 음성 브리지를 한 묶음으로 내며, v2026.4.26 브라우저 Talk과 같은 Live 전송군으로 mux한다. 본문은 여섯 가지 번호 통증, 전송 결정 매트릭스, 변경 티켓에 붙일 8단계 런북, 인용 가능한 네 결론, 임대 Apple Silicon Mac용 20분 VNC 검수 그리드를 준다. Gateway 공개 접근·HTTPS 리버스 프록시, 다채널 롤아웃 순서를 교차 읽고, 브리지 기선 통과 후 v2026.5.7 증분 업그레이드로 이어가 음성 인그레스와 채널 fan-out·배포 체인 드리프트 충돌을 피한다.
회의 연동은 조용히 실패한다. Gateway 로그는 정상인데 참가자에게 소리가 없거나, PSTN은 들리지만 Meet 참가자는 못 듣는다. 아래 여섯 항목은 SSH만 쓰고 Chromium 사이트 설정·macOS 마이크 개인정보를 열지 않는 임대 macOS 노드에서 반복되는 유형이다.
Meet OAuth와 도메인 정책: 관리자가 OAuth 클라이언트의 캘린더 읽기·자동 참가를 제한한다. Gateway 오류 없이 「동의 화면에서 멈춤」처럼 보일 수 있다. Google Admin 감사와 redirect URI 목록을 맞춰야 한다.
브라우저 캡처 vs 헤드리스 환상: Meet 오디오 수집은 Chromium 프로필과 올바른 HTTPS 오리진에 의존한다. 헤드리스 Linux는 macOS TCC를 대신 누를 수 없다. 루프백 해킹은 빗살 필터와 쓸 수 없는 전사를 만든다.
Twilio 자격 증명 분산: SID·API 키·번호 webhook이 env에 흩어지면 「전화는 울리지만 브리지는 media를 못 받음」——콜백 URL이 지난주 터널 호스트를 가리키는 전형.
브리지 세션 충돌: 같은 Meet에 owner가 둘이면 에코, 중복 도구 호출, 채널 아카이브와 어긋난 전사가 동시에 난다. 음성 기선 동결 전 다채널 fan-out에서 특히 흔하다.
리버스 프록시 WebSocket 드리프트: 장시간 듀플렉스 오디오는 브라우저·Gateway·Live 상류 사이의 올바른 Upgrade와 유휴 타임아웃이 필요하다. REST용 TLS 종단은 채팅 스모크가 건드리지 않는 브리지를 끊는다.
공유 임대의 증거 공백: 컴플라이언스는 「누가 마이크 허용을 눌렀는지」를 Gateway session id와 맞춘다. SSH 텍스트만으로는 부족하다. launchd와 같은 macOS 사용자로 VNC 목격과 listener 표보내기가 필요하다.
이 통증을 마감이 아니라 아키텍처 관문으로 본다. 건너뛰면 「Google 할당량」과 「모델이 작다」 사이를 오가는 주간 티켓이 되고 PSTN과 Meet이 한 session id에 mux되지 않는다.
사고 브리지 전에 표를 본다. Gemini SKU를 급히 올리지 말라. 행은 인그레스(오디오 유입)와 추론(텍스트로 무엇을 하는가)을 나눈다.
| 요구 | 5.4 우선 | mux 없이 혼용 금지 | 첫 VNC 확인 |
|---|---|---|---|
| 예약 Meet+화면 공유 | Meet 인그레스+단일 브리지 | 같은 방에서 브라우저 Talk 탭 병행 | Meet 오리진용 Chromium 마이크/사이트 권한 |
| PSTN만 참가 | Twilio 다이얼인 레그 | 발신자마다 별도 Gateway | Twilio 디버거 in-progress와 CallSid 일치 |
| 데스크 개발자 음성 시험 | 브라우저 Talk(4.26) | 동일 머신에 Meet 봇 참가 | 마이크 owner 하나; 활성 상태 오디오 장치 |
| 회의 후 비동기 요약 | 채널 전사+TTS | 브리지 무기한 상주 | 브리지 해체 로그; cron 상태 |
| 공개 webhook | Gateway 앞 HTTPS 리버스 프록시 | 18789 인터넷 직노출 | TLS 호스트명=Twilio webhook 호스트 |
| 통화 중 IM fan-out | 브리지 기선 후 다채널 | Meet 스모크 전 전 채널 | channels list vs 활성 브리지 owner |
이 표는 다채널 가이드와 맞물린다. 텍스트는 지휘 통제에 좋지만 브리지가 살아 있을 때 둘째 오디오 owner가 되면 안 된다. Twilio용 Gateway 공개 시 운영 콘솔과 같은 Host/인증서 규율을 재사용하고 Twilio 음성 URL 없이 서브도메인 HTTP를 만들지 마라.
live room마다 하나의 bridge session id——Meet·PSTN·Gemini 상류는 공유해야 한다. 그렇지 않으면 지능이 아니라 에코를 고친다.
세 평면으로 생각한다. 인그레스: Meet 커넥터가 캘린더(또는 meet URL)를 구독하고 제어 브라우저로 룸 오디오를 Gateway에. Twilio는 PSTN/SIP를 정규화해 같은 브리지의 다른 레그로. 브리지: Gateway가 세션 수명, trace id, SecretRef, 상류 스로틀 백프레셔. 에이전트: 도구·스킬·채널 전사는 직교——음성은 듀플렉스로 Slack/Telegram 구조화 명령.
v2026.4.26 브라우저 Talk 대비 Meet 인그레스는 일정·참가자 정책을 더한다. 봇은 조직 동의 참가자이지 로컬 탭 실험이 아니다. 다채널 대비 음성 브리지는 시간 경계가 있고 지터에 민감하다. IM 재시도를 오디오 프레임에 쓰지 마라. Gemini 실시간 음성 브리지는 Talk과 같은 Live군이나 mux된 PCM/Opus 레그에서 공급——Gateway가 상류 토큰을 협상해 비밀은 Local Storage에 없다.
임대 원격 Mac에서 실무 닻은 여전히 대화형 macOS 사용자 하나가 launchd·Chromium·마이크 TCC를 갖는 것. 「Gateway는 A, 브라우저는 B」는 Meet은 연결인데 브리지는 무음인 분열 캐시를 재현한다.
순서대로 실행. 앞은 버전·URL 고정. 중간은 인그레스 검증. 끝은 관측성 후 다채널 fan-out.
동결·백업: openclaw --version, node 절대 경로, OPENCLAW_HOME, Gateway listener, 임대 id, launchd 라벨 기록. Meet/Twilio 설정(비밀 마스킹)을 변경 티켓에.
v2026.5.4 업그레이드·doctor: openclaw doctor 실행. Meet 전 4.26 relay 키 정리. 설정 트리 롤백 tarball 보관.
Workspace OAuth(VNC 필수): Gateway 사용자로 Chromium 동의. 도메인 제한 시 Admin에서 client id 허용.
Twilio SecretRef·webhook: SID·토큰은 SecretRef. 음성 상태는 HTTPS 리버스 프록시 호스트. 임시 터널 금지. VPC 밖에서 TLS 검증.
단일 브리지 프로필: Meet·Twilio를 bridgeSessionId 템플릿으로 공유. 유휴 해체(예: 마지막 PSTN 종료 후 120초) 문서화.
랩 Meet 스모크: 헤드셋 둘+다이얼인 하나로 시험 Meet. Gateway 로그에 브리지 owner 하나, Meet/Twilio trace id 일치.
Gemini 상류 프로브: 브리지로 짧은 듀플렉스 프롬프트. Gateway 메트릭으로 첫 바이트·왕복. 동일 호스트 4.26 Talk 기선 비교.
다채널 fan-out: 음성 기선 통과 후만 다채널 롤아웃 순서로 Telegram/Slack이 같은 방에 둘째 브리지를 만들지 않게.
voiceBridge:
owner: gateway
geminiLive:
region: us-central1
traceHeader: X-OpenClaw-Bridge-Trace
meet:
calendarId: primary
joinWindowMinutes: 15
twilio:
dialInNumber: "+1XXXXXXXXXX"
statusCallback: "https://gateway.example.com/twilio/voice/status"
mux:
bridgeSessionTemplate: "meet-${eventId}"
maxPstnLegs: 4
idleTeardownSeconds: 120
참고: 키는 예시. openclaw configure에 동등 블록이 있을 수 있다. YAML은 리뷰용. 릴리스 노트 확인 없이 붙여넣지 마라.
openclaw --version openclaw doctor openclaw gateway status openclaw secrets audit lsof -nP -iTCP -sTCP:LISTEN | rg -i "openclaw|18789" || true openclaw channels list
경고: 브리지 mux·WebSocket 업그레이드 제외 전 「Gemini 할당량」을 근본 원인으로 쓰지 마라——할당량 UI는 듀플렉스에서 정중한 거짓말.
같은 변경에서 SSH 자동화와 VNC 목격을 병행. 표는 단일 운영자용. 스크린샷을 변경 기록에.
| 확인 | VNC(Gateway 동일 사용자) | SSH | 통과 |
|---|---|---|---|
| 버전 | Gateway UI=CLI | openclaw --version | 5.4.x 일치 |
| Meet 마이크 동의 | Chromium+시스템 설정 | 대체 불가 | 경로·바이너리 일치 |
| Twilio webhook 도달 | 선택 브라우저 | 공개 호스트 curl -I | TLS 유효; 2xx |
| 브리지 trace 정렬 | trace 헤더 필터 | Gateway 로그 grep | 단일 session id |
| 듀플렉스 스모크 | SLA 내 왕복 청취 | 메트릭 | 단방향 없음 |
| 해체 | Meet 탭 정상 종료 | 유휴 타이머 | 고아 PSTN 없음 |
이어 v2026.5.7로 갈 계획이면 이 그리드 JSON·로그를 음성 기선 번들로 보관. 5.7 배포 체인은 브리지 검수 대체가 아니다.
Linux에서 아웃바운드만 돌려도 Meet·Twilio 인그레스는 macOS 앵커에 둔다. Linux는 webhook·배치에 강하지만 마이크·OAuth 증거 사슬은 닫지 못한다.
훈련 A—프록시 페일오버: 브리지 중 Nginx/Caddy reload, Twilio가 둘째 브리지 없이 상태 재시도.훈련 B—부분 PSTN 손실: Meet 유지 중 한 레그 드롭, mux가 제거하거나 degraded 로그.
Meet 화면 공유 시작 시 에이전트 기대를 문서화: 슬라이드 낭독 방지로 브리지 음소거하는 팀도, 공유를 비전 도구에 넣는 팀도 있다. 5.4 브리지는 제품 정책을 대신하지 않는다.
마지막으로 보존 정렬: 음성 전사는 IM보다 민감할 수 있다. 외부 다이얼인 전 SecretRef 감사·리걸 홀드에 브리지 설정을 맞춰라.
HTTPS·포트·Twilio 콜백 일관성.
읽기 →음성 기선 통과 후 IM fan-out.
읽기 →브리지 검수 후 증분 체크리스트.
읽기 →예——5.4 설계 포인트. live room마다 owner 하나, Gemini 상류 전 PSTN mux. 같은 Meet에 owner 둘은 에코·전사 분열.
아니요. Workspace OAuth, Chromium, macOS 마이크 TCC는 VNC와 같은 대화형 사용자. SSH는 listener·로그에 여전히 필수.
4.26은 로컬 탭 Google Live 최적화. 5.4는 캘린더 Meet·Twilio PSTN·Gateway 브리지 세션 의미.
Meet·Twilio 범위면 먼저 5.4 브리지 검수. 5.7 배포 체인·channels CLI는 증분으로, 음성 기선 건너뛰지 마라.
OpenClaw v2026.5.4는 회의 오디오를 Gateway 1급 관심사로 만든다. Meet·Twilio는 인그레스, Gemini Live는 듀플렉스 추론. 비밀·프록시 타임아웃·세션 해체는 변경 프로세스가 쥔다. SSH만 쓰는 팀은 권한 드리프트·Meet UI 가짜 녹색으로 주를 잃는다.
자체 Mac은 수면·업데이트·감가를 진다. 소형 노트북은 Meet·PSTN mux·전사 동시에 질식한다. 감사 가능 GUI 세션 임대 원격 Mac은 이미지·가동을 사업자에, 브리지 정책·SecretRef는 손에——중간 끊김 MTTR은 보통 짧다.
하드웨어 자본을 덜 묶고 Gateway와 같은 macOS 사용자로 6절 검수를 끝내려면 VNCMac 클라우드 Mac: 아래 버튼 구매 페이지, 홈에서 플랜 비교 후 다음 브리지 변경.