AI 자동화
2026년 4월 7일
2026 클라우드 Mac: OpenClaw install.sh vs npm 전역——선택, 검증, 업그레이드
MacLogin AI Automation Team
2026년 4월 7일
약 8분
OpenClaw에는 여러 설치 경로가 있습니다. Apple Silicon 클라우드 Mac에서는 재현 가능한 업그레이드와 단일 게이트웨이 바이너리 출처, Runbook과 맞는 로그가 중요합니다.
먼저 배포 가이드, 게이트웨이 데몬 문제 해결, Node 전제 조건을 읽고 프로덕션 게이트웨이를 변경하세요.
install.sh가 유리할 때
- 공식 문서 기본 경로에 맞추고 싶을 때.
- 운영자 교대가 잦아 PATH 수정을 줄이고 싶을 때.
- launchd 템플릿과 위치를 맞출 때.
npm -g가 유리할 때
- nvm/asdf로 Node 메이저를 고정한 경우.
- 여러 CLI 메이저 병행 검증이 필요할 때.
- npm audit이 필수인 보안 프로세스.
비교표
| 항목 | install.sh | npm -g |
|---|---|---|
| PATH 리스크 | 낮음 | 높음 |
| 업그레이드 | 스크립트 재실행 | npm update -g |
| 복구 | 상위 문서와 일치 | launchd의 node 확인 |
팁: 같은 prefix에 무작정 혼용하지 말고 하나를 선택해 CMDB에 기록.
검증 체크리스트
node -v를 plist 기대와 대조.- 비로그인 SSH에서 which 확인.
- 노트북 터널 전 클라우드 Mac에서 헬스 체크.
- launchd 재시작 시 로그 tail.
고아 바이너리 없는 업그레이드
이전 경로 기록 후 오래된 npm 패키지 정리하고 재설치. 게이트웨이 트러블슈팅과 배포 가이드 참고.
FAQ
구조화 FAQ와 동일 취지의 요약.
install.sh와 npm 혼용? prefix를 분리하고 문서화할 때만.
MacLogin이 Node 고정? 임대 내 런타임은 사용자 책임.
업그레이드 후 터널 끊김? LocalForward와 루프백 리슨 재확인.
