세 분기 · 표 · 구 단계 런북 · VNC · 로그 순서
v2026.4.26은 Talk 계열에 브라우저 호스트 경로를 더합니다: Google Live 스타일 transport로 이중 방향 음성을 연결하고 Gateway가 세션 고정·토큰 스코프·릴레이 의미를 묶습니다. 이는 Talk Mode + MLX(로컬 추론·마이크 UX, MLX 런북)와도 Gemini TTS(읽기 출력, TTS 점검)와도 openclaw migrate(4.26 migrate)와도 다른 티켓입니다. 본문은 경계, 증상 매트릭스, doctor→브라우저 스모크까지 구 단계, 티켓용 네 문장, 18789와 역방향 프록시 정합, VNC 그래픽 세션에서의 권한 체인을 정리합니다. HTTPS 리버스 프록시, 브라우저 MCP, Docker 공식 Compose와 교차 확인해 컨테이너의 localhost와 데스크톱 세션을 혼동하지 않도록 합니다.
운영 관점에서는 확장 프로그램·기업 프록시·TLS 인스펙션 장비가 동시에 개입하면 증상만 보고 모델 할당량을 올리는 오판이 반복됩니다. 브라우저 프로필을 깨끗이 분리해 장시간 duplex 연결을 유지할 수 있는지, 그리고 게이트웨이 로그의 세션 식별자가 네트워크 패널의 WebSocket 프레임과 같은 검색어로 묶이는지부터 확인하세요. 장애 교대 중에는 스크린샷 한 장보다 타임라인이 정렬된 로그 묶음이 훨씬 빠르게 책임 경계를 좁힙니다.
Gateway는 여전히 오케스트레이터입니다: 탭은 정직한 프런트이며 Local Storage에 키를 넣지 않습니다. Relay 공개 호스트명은 TLS SAN과 일치해야 ICE 후반 단계에서 브라우저 콜백이 실패하지 않습니다.
브라우저 Talk + Google Live transport: 클라우드 이중 세션을 Gateway 컨텍스트에 태웁니다.
Talk Mode MLX: 로컬 추론·마이크 UX 중심.
Gemini TTS: 브리핑·요약 출력에 적합.
Gateway 릴레이: 홉 간 trace/session 공백 금지.
VNC: TCC(마이크·자동화·필요 시 화면)에서 SSH가 대신 클릭할 수 없는 부분을 메웁니다.
스택을 고르고 나서 레이턴시를 논의합니다.
| 증상 | 먼저 | 다음 | 오인 |
|---|---|---|---|
| 마이크 프롬프트 없음 | 사이트 권한·시스템 입력·게이트웨이 동일 사용자 | 가상 오디오·테넌트 이미지 | 리전/API부터 변경 |
| 연결 후 단절·첫 바이트 지연 | 프록시 유휴·WSS 미통과 | 상류 Live RTT | 모델 SKU만 상향 |
| 게이트웨이만 세션 표시 | CORS/CSP/base href | TLS 가로채기·확장 | 코어만 장애라 단정 |
| 특정 사용자만 | 키·샌드박스 매핑 | 채널별 워크스페이스 | 네트워크 우연으로 치부 |
표의 「다음」 열은 리버스 프록시 타임아웃과 WebSocket 헤더 절에서 함께 읽습니다.
버전 고정: CLI·게이트웨이 태그 기록.
백업: state·~/.openclaw tarball.
doctor: 포트·SAN 조기 노출.
Gateway 베이스라인: 18789 헬스 후 DNS/WSS.
브라우저 Talk 활성화: 리전 문서화.
SecretRef: 평문 금지.
시크릿 스모크: 마이크·세션 ID 우선.
릴레이 정합: 브라우저→게이트웨이→상류 trace 일치.
롤백 리허설: 텍스트/TTS 스위치와 KPI.
앵커① 관측은 항상 18789부터.앵커② 약 2분 안에 피드백이 없으면 브리지 의심.앵커③ 시크릿 두 번(콜드/웜).
gateway:
browserTalk:
enabled: true
realtimeTransport: google-live
relay:
bindLocal: "127.0.0.1"
advertisePublicHost: "agent.example.com"
cors:
allowedOrigins:
- "https://agent.example.com"
secretsRef:
googleLiveApiKey: "secretref:prod/google-live/key"운영 스키마에 맞춰 조정합니다. mixed content는 마이크 진단을 왜곡합니다.
launchd 사용자 에이전트로 게이트웨이 정렬.
시스템 설정 마이크에서 Chromium 허용 후 사이트 권한.
자동화 필요 시 MCP 문서와 충돌 점검.
화면 녹화는 단기 상관용만.
동시에 게이트웨이 오류·브라우저 무음·쿼터 경고가 뜨면 DevTools WS → Gateway JSON → 프록시 upstream → 과금 순으로 스크린샷과 함께 수집합니다.
국경을 넘는 회선에서는 브라우저에서 게이트웨이까지의 RTT와 게이트웨이에서 상류 Live ingress 까지의 RTT를 분리 표기해야 합니다. 두 구간 중 하나만 튀어도 체감은 비슷하지만 조치는 완전히 다릅니다. 프록시 계층에서 idle timeout 이나 half-close 정책이 글로벌하게 적용되어 있다면 지역별 할당량 조정만으로는 재발합니다.
08동일 마이크 경로 경합 금지.
Upgrade·Host·체인·mixed content 우선.
불충분 — VNC 세션 필요.
디렉터리 고정 후 브라우저 릴레이 목표 경로 정렬.
브라우저 실시간 Talk는 동일 출처·TLS·릴레이·마이크 체인에 예민합니다. 소음을 걷어낸 뒤에야 프롬프트 튜닝이 의미 있습니다. 장애 보고 시에는 브라우저 빌드 번호와 게이트웨이 버전 문자열을 한 줄로 묶어 타임라인에 넣고, DevTools 네트워크 패널에서 선택한 요청의 요청 ID나 세션 해시가 게이트웨이 로그와 교차 검색되는지까지 확인해야 같은 패턴 재발 시 재현 단계가 단축됩니다.
운영자에게 유용한 정보는 길고 거창한 요약보다 짧은 명령 출력 스니펫과 재현 순서 번호 목록입니다. 릴레이 노드를 교체했거나 리버스 프록시 업스트림 헬스 체크 간격을 바꿨다면 그 변경점과 증상 발생 시각을 같은 블록에 적어두면 다른 지역 회선과 비교하기 쉽습니다.
마지막으로 장시간 세션에서는 브라우저 프로세스 메모리 상한과 게이트웨이 소켓 재사용 정책이 함께 묶여 나타나기도 하므로 단순 재시작 타이밍만 조정해서 넘어가면 다음 배포에서 같은 패턴이 반복됩니다. 재연결 간격 로그까지 한 줄만 더 붙여두면 원인 분리가 빨라집니다.
장비·야간 패치까지 모두 안고 가기보다 VNCMac처럼 Apple Silicon 원격 Mac을 빌려 같은 세션에서 검증하는 편이 변경 추적에 유리합니다.