반복되는 세 가지 설치 통증
증상은 “대시보드가 어제까지 됐다”처럼 나오고, install.sh·npm·pnpm·Docker 공통으로 세 패턴으로 묶입니다.
1) 운영자 간 경로 불일치. 스크립트·전역 CLI·포크 Compose가 섞이면 설정·캐시·자격 위치가 달라져, 장애 시 어떤 디렉터리를 백업할지·어떤 유닛이 띄웠는지 합의가 없습니다.
2) 데이터 계약 없는 업그레이드. 설정·캐시·토큰·자산을 앞으로 가져가지 않으면 유실처럼 보이고, 스냅샷 없는 롤백은 스키마 불일치를 낳습니다. 데이터 디렉터리는 1급 마이그레이션 대상입니다.
3) 분류 사다리 생략. 재설치 전에 프로세스·포트, 게이트웨이 HTTP, openclaw doctor, 최소 재현 로그 순을 밟아야 합니다. Node 버전·잠금·다이제스트·설정 tarball을 남기면 회귀 분석이 빨라집니다.
경로 선택 표
아키텍처 리뷰에도 씁니다. 경로만 다를 뿐 위험 패턴은 비슷합니다.
| 경로 | 적합 | 위험 | 통제 |
|---|---|---|---|
| install.sh | 첫 성공·데모·온보딩 | 스크립트 변경 불투명 | 체크섬·로그·설정 스냅샷 |
| npm·pnpm | 빠른 반복·CI | 전역/로컬 혼동·Node 드리프트 | Node 고정·전용 계정·잠금 파일 |
| Compose | 운영 동일성 | 마운트·태그 드리프트 | 이름 볼륨·다이제스트 |
비슷하면 파일 경계가 분명한 쪽을 택하세요. 운영과 개인 계정을 섞지 마세요.
install.sh
스크립트는 한 줄로 편하지만 체크섬·비밀·프록시는 운영자 책임입니다. 공유 배스천에서는 프로필·전역 설치 구간을 먼저 읽으세요. SHA-256과 전사 로그를 남기고, 끝나자마자 openclaw doctor와 18789(또는 팀 표준) HTTP 프로브를 실행합니다. 리스닝이 없으면 실행 사용자와 감독 프로세스 사용자가 같은지 확인하세요.
npm·pnpm
전역과 로컬·Node 버전을 문서로 고정하세요. pnpm은 디스크에 유리하고 npm은 익숙함에 유리합니다. 전용 Unix 계정으로 돌리고, 미러·타임아웃은 런북에 적습니다. which openclaw 확인 후 doctor, 금지 조직은 안정적인 npx/스크립트 래퍼를 쓰세요.
Docker Compose
YAML로 재현성을 얻고 실패는 마운트·UID 불일치로 이동합니다. 볼륨을 문서·백업에 이름 붙이고 .env는 비밀 플레이북으로 다룹니다. 필요 포트만 노출하고 TLS는 프록시에서, RAM 여유 약 1.5GiB, unless-stopped로 복구하세요. 컨테이너에서도 status·doctor·로그 순을 동일하게 적용하고 헬스 프로브를 LB와 맞춥니다.
분류 순서 예시
openclaw status
curl -sS -m 5 http://127.0.0.1:18789/health || echo "gateway probe failed"
openclaw doctor
openclaw health --json > /tmp/openclaw-health-$(date +%Y%m%d%H%M).json
openclaw logs --follow
프록시 뒤면 포트만 바꾸고 순서는 유지합니다.
업그레이드·롤백·분류
설정·환경·비밀 금고의 채널 토큰·비싼 캐시를 tarball로 남기고 다이제스트나 잠금과 짝을 맞춥니다. 스테이징에서 doctor·헬스 JSON을 다시 찍은 뒤 승격하세요. 롤백은 아티팩트 복원과 이전 태그·버전 재시작이며, 스키마 마이그레이션이 있으면 다운그레이드 전 노트를 읽습니다.
장애는 status→게이트웨이 HTTP→doctor→로그입니다. 로컬 타임스탬프를 맞춘 뒤 프로바이더 상태를 봅니다. 게이트웨이 글과 같은 층 구분입니다.
- npm ci 정지: 미러·MTU·CPU 스로틀을 먼저.
- doctor 통과·채널 침묵: 브리지·토큰.
- Compose 마운트: 경로 diff 후 데이터 터치.
요약: 세 경로는 속도·인체공학·재현성을 바꾸며, 백업·고정·분류가 계약일 때만 안전합니다. 절전 노트북·개인 계정 혼용은 패키징과 무관하게 자주 깨집니다.
SFTPMAC: 호스팅 원격 Mac은 전원·Apple 도구·SFTP/rsync 흐름 옆 게이트웨이에 적합해 절전·권한 드리프트를 줄입니다.
해커톤?
install.sh나 부작용 적은 npm 스크립트와 설정 스냅샷.
규제 운영?
다이제스트 Compose·금고 비밀·볼륨 백업.
env 바꿀 때 doctor?
네, 로그만 보는 것보다 낫습니다.
파일 동기 옆 안정 Mac이 필요하면 SFTPMAC 요금제로 기준선을 잡으세요.