2026년 장애의 상당수는 이색 컴파일이 아니라같은 이름의 바이너리가 둘,launchd가 옛 접두사를 가리키는 일, 여섯 메트로에서게이트웨이 순서가 뒤틀린 일입니다. 언제openclaw update로 충분한지, 언제install.sh를 태그로 재실행할지,npm -g와 소스가 PATH에서 싸울 때 증상·정리, 롤백 순서,openclaw health로 그레이 승인하는 법을 압축해 담았습니다.
1. 게이트웨이를 건드리기 전에 업그레이드 척추를 정하라
역할마다 릴리스 채널 하나입니다. 워크스테이션은 신뢰 접두사에서openclaw update가 보통이고, 서버·상주 게이트웨이는 태그 기준install.sh로 레이아웃을 문서와 맞춘 뒤 데몬과같은 사용자로openclaw doctor를 다시 돌립니다. npm과 main 클론을 섞으면 터미널과 비대화형 SSH의--version이 갈라집니다. 더 알아보기: Skills·작업 공간·온보딩·권한 FAQ
2. npm 전역 옆의 소스 체크아웃: 전형 통증과 처방
PATH 순서가 범인입니다: Homebrew,~/.npm-global/bin,target/release가 겹치면 플래그 불일치·MODULE_NOT_FOUND·스키마 버전 불일치가 납니다. 기기 클래스마다 npm또는소스 하나만 두고 서비스 PATH에서 다른 쪽을 빼십시오.openclaw.json은 사용자당 하나로 묶습니다. 더 알아보기: 화이트리스트·스폰·maxSpawnDepth FAQ
3. 티켓에 붙여 넣을 롤백 체크리스트
올리기 전 스냅샷:태그·npm 버전,plist/Compose,설정 tarball,구 health입니다. 롤백은 새 유닛 중지 → plist 경로 복원 → 이전 바이너리·이미지 태그 → 설정 → 구 유닛 → health 대조 순입니다. 인증 오류가 남으면 셸 환경 드리프트를 먼저 보십시오.
- 리전별 로그에
--version·doctor·health를 날짜와 함께 저장합니다. - 캐너리 health 연속 두 번 성공 전까지 DNS 가중치를 얼립니다.
- NVMe 여유를 확인합니다. 가득 찬 디스크는 TLS처럼 보입니다.
4. 트래픽을 올리기 전 openclaw health가 증명해야 할 것
openclaw health는 스모크 산출물입니다. 승격 전에CLI·게이트웨이 빌드 ID,Provider 지연,디스크·launchd를 캡처하고, 대화형과 데몬같은 사용자에서 두 번 돌려 전사본이 같아야 합니다.
- 가린 health 출력을 변경 티켓에 붙입니다.
- 고정 합성 프롬프트로 오류율을 전후 비교합니다.
5. 다지역 Mac mini M4 그레이 게이트웨이와 단계적 승격
메트로마다M4 전용 호스트에 캐너리를 두고 소량 트래픽 후openclaw health가 기준선과 맞을 때만 DNS·Tailscale을 승격합니다. 동일 바이너리도 리전 RTT가 다릅니다. 모델 라우팅은 별 축으로 한 번에 하나만 바꿉니다. 더 알아보기: 모델·openclaw.json·인증 FAQ 더 알아보기: Docker Compose 배포·트러블슈팅 2026
vpszap 클라우드에서는 업그레이드가 재현 가능하게 남습니다
게이트웨이가가상화 없는 물리 Mac mini M4에 앉고 CPU·SSD가 전부 전용이며, 약5분에SSH·VNC가 열리면 위 체크가 단순해집니다.일·주·월·분기 과금과장기 약정 없음은 캐너리를 짧게 쓰는 팀에 맞고, 다지역 저지연은 도쿄에서 install.sh를 리허설한 뒤 미동 프로덕션을 건드리는 식의 전략이 됩니다.
하드웨어부터 맞추려면 vpszap 클라우드 Mac mini 홈에서 사용자·러너와 같은 리전을 고르십시오.