01install.sh vs npm -g: OpenClaw 설치 경로 비교표
어느 경로든 node -v가 메이저 24인지 먼저 확인하세요. 공유 예산 원격 Mac에서는 재현성이 우선입니다.
| 축 | 공식 install.sh | npm install -g | 예산 팀 힌트 |
|---|---|---|---|
| 재현성 | 스크립트+digest | lock 습관 의존 | 학생 임대는 install.sh |
| Node 24 | 조기 중단 | nvm 24.x면 OK | PATH 혼선 금지 |
| 256GB 디스크 | 글로벌 슬림 | npm 캐시 스파이크 | 실패 후 ~/.npm 정리 |
| 업그레이드 | curl 재실행 | npm -g update | 스프린트당 한 경로 |
02openclaw onboard --install-daemon 수락 검수
게이트웨이가 살아 있어야 Skills를 올립니다. 실패 시 다음 단계로 넘어가지 마세요.
- 사전:
node -v→ v24.x,which openclaw단일 경로 - 온보딩:
openclaw onboard --install-daemon후 LaunchAgent loaded - 게이트웨이:
openclaw gateway statusonline·포트 일치 - 닥터:
openclaw doctor종료 코드 0, stderr 아카이브 - 토큰:워크스페이스 범위 키만, 교실용 키 재사용 금지
~/.openclaw 경로를 문서화하고 프로덕션 토큰은 스파이크 종료와 함께 폐기하세요.03Skills 콜드 스타트: M4 16GB 디스크·메모리 피크 임계
df -h /와 Activity Monitor로 대표 Skill 번들 한 번만 측정해도 실패 원인이 드러납니다.
| 신호 | 16GB·256GB 중단 | 업그레이드 단서 |
|---|---|---|
| 디스크 여유 | 콜드 import 중 35% 미만 | 스토리지 매트릭스 |
| RSS | GUI 닫아도 12GB 초과 지속 | VNC 끄고 헤드리스만 |
| 캐시 | 쓰기 가능 약 45GB+ | Skill 벤더 디렉터리 정리 |
안정 후 Transporter 실무는 미서부 웹훅 실전 글을 이어서 보세요.
04미서부 vs 아태: vuzcloud 노드 선택
설치 경로는 지리를 고치지 않습니다. 모델 API·웹훅·git이 북미면 미서부, 리뷰어가 한국·일본 중심이면 아태로 SSH 체감을 맞추세요.
아태·미서부 RTT 매트릭스에서 실제 호출 엔드포인트 셋을 샘플하세요.
05예산 OpenClaw 스파이크를 망치는 리스크
- Node 드리프트:Homebrew 22와 nvm 24 공존 → onboard 성공 후 gateway 크래시
- 이중 글로벌:install.sh+npm -g로
openclaw두 개 → doctor는 엉뚱한 바이너리 통과 - 디스크 절벽:로그는 정상인데 여유 공간만 고갈 → 진짜 SLO는 free space
06SSH부터 첫 Skill까지 다섯 단계 런북
①SSH 후 node -v로 24 고정 ②표에서 install.sh 또는 npm -g 하나만 선택 ③onboard --install-daemon·status·doctor 캡처 ④Skill 한 묶음 콜드 스타트·피크 기록 ⑤검증 끝나면 요금으로 일·주 전환 검토
인용 한:Node 24는 하한, 공유 임대 기본값은 install.sh.
인용 둘:256GB SSD에서 여유 35% 미만이면 Skills import 중단.
인용 셋:같은 오후에 install.sh와 npm -g를 섞지 않는다.
07gateway status·doctor 자주 나는 오류 FAQ
onboard 직후 offline:doctor 재실행, 데몬 reload, listen 포트·토큰 워크스페이스 일치 확인.
Node mismatch:which node·which openclaw가 nvm 24 아래인지 확인.
npm EACCES:공유 호스트에서 sudo 금지, install.sh 우선 또는 사용자 prefix npm global.