통증 분해: 페이지가 열린다고 게이트웨이가 건강한 것은 아니다
통증 1: 버전 드리프트.전역 npm과 pnpm·오래된 tarball을 섞으면 셸의 openclaw와 launchd·systemd가 띄우는 gateway 바이너리가 달라진다. 두 --version과 which, plist·unit 실행 줄을 한 티켓에 붙이고 4.x 문서의 스냅샷 습관에 맞춘다.
통증 2: 페어링과 장치 ID.업그레이드 뒤 보안 강화로 기존 신뢰가 무효되어 pairing required 루프가 난다. 승인자가 불명확하면 재연결 경쟁이 난해해 보인다.누가 승인하는지·어떤 브라우저 프로필이 운영 기준인지 문서화하고 workspaceAccess 변경과 같은 변경표에 넣는다.
통증 3: 반쪽 리버스 프록시.allowedOrigins·WebSocket 업그레이드·TLS 중간이 꼬이면 401·403·502가 앱 버그처럼 보인다. Nginx·Caddy 운영 가이드를 먼저 밟는다.
통증 4: 웜 리로드만.일부 JSON은 뜨겁게도 되지만 페어링·플러그인 등록은 콜드 재시작이 필요할 때가 많다.상주 설치 글의 재시작 절과 맞춘다.
통증 5: 권한 경계를 끊김으로 착각.workspaceAccess·셸 도구 제한은 범용 배너에 묻힌다. 먼저 자동 수정 없이 openclaw doctor를 읽고 최소 권한 표와 맞춘다.
통증 6: 노트북 단일 호스트.수면·VPN·확장이 WebSocket을 흔든다. 상시 가동 원격 Mac으로 옮기고 OIDC 매트릭스의 Runner 동일성으로 합성 RPC를 친다.
보강:티켓에 CLI·gateway semver, doctor 요약 해시(마스킹), 마지막 성공 채널 시각, 공개 notAfter, 운영 DNS에서 RPC p95, loopback만인지 매시간 한 줄씩 적어 업그레이드 직전 마지막 건강 프레임을 남긴다. 브릿지 기간엔 CLI·감독 바이너리·프록시 이미지 세 축을 동시에 바꾸지 않는다.게이트웨이 운영·doctor 층별 순서를 임시 호스트명으로 재연하고 캡처 전 토큰을 지운다. 페어링 재시도는 로그량을 키우므로 보존 버퍼를 넓힌다.
세 층과 측정 필드
게이트웨이 운영·doctor 층별 글대로 로컬 프로세스·포트, gateway 범위 RPC, 외부 API·어댑터 순으로 본다. 층을 건너뛰면 헤더 한 줄 오류에도 바이너리를 갈아엎는다.
4.x doctor의 사용 중단 경고는 릴리스 노트 TODO로 남기고, 외부 커뮤니케이션엔 실패 층·증거·다음 단계 ETA를 적어 불필요한 재설치 압력을 줄인다.
의사결정 표
| 증상 묶음 | 우선 조치 | 효과 | 리스크 |
|---|---|---|---|
| semver 불일치 | 채널 통일, 스냅샷 후 필요 시 gateway install --force | 가짜 끊김 감소 | force 오용 시 드리프트 은닉 |
| pairing 루프 | onboard·단일 승인·오래된 브라우저 상태 삭제 | 신원 체인 회복 | 무단 승인은 감사 구멍 |
| HTTPS만 실패 | 체인·HSTS·WS·allowedOrigins | 엣지 원인 분리 | 헤더 오류 시 502 |
| doctor가 경계 지적 | workspaceAccess 조정·콜드 재시작 | 가짜 재연결 감소 | 과도 완화는 부채 |
| 노트 gateway 불안 | 24x7 원격 Mac 풀 | 변동 감소 | 예산 |
관리 RPC의 새 호스트명·터널은 CI OIDC·배포 키와 같은 표에서 검토한다.
실행 단계
# 1) 두 semver 증거
# openclaw --version
# openclaw gateway --version # 배포판 문서 따름
# 2) 공식 사다리
# openclaw status
# openclaw gateway status
# openclaw logs --help
# openclaw doctor
# 3) 정책 변경 뒤 감독 데몬 콜드 재시작
# 4) 프록시: curl -I 와 WS 클라이언트로 업그레이드 헤더 확인
출력은 비밀을 가리고 티켓화하며 linger·RPC 검증 절과 교차 확인한다.
읽기 순서
본문 다음 상주 설치 → 4.x doctor → 리버스 프록시 → 최소 권한 → 홈.
FAQ·SFTPMAC 호스팅 원격 Mac
바로 제거 재설치?
아니요. 버전·엣지 검증을 먼저 끝내고 무결성이 증명 불가할 때만 제거 경로를 검토한다.
페어링과 보안 기준이 충돌
승인 흐름을 문서화하고 workspaceAccess 변경과 같은 변경 관리에 넣는다.
커뮤니티 다운그레이드
임시 우회로만 쓰고 semver·롤백 창을 기록한다.
요약:끊김·페어링 요구는 복합 신호다.semver를 이중 기록하고 공식 사다리·TLS·콜드 재시작을 밟는다.
한계:자체 노트북은 수면·브라우저 변동이 남는다.SFTPMAC 호스팅 원격 Mac은 게이트웨이·워크스페이스·파일 전달을 한 운영면에 두어 업그레이드 증거를 맞추기 쉽다.
버전 두 값·doctor 요약·성공 채널 왕복을 릴리스 게이트로 고정한다.