01. 세 가지 고통

1) migrate 맹목 실행: v2026.4.26 의 openclaw migrate 는 드라이런과 JSON 계획을 제공합니다. 피크 시간에 검토 없이 적용하면 세션 설정이 덮어쓰일 수 있습니다.

2) update 검증 무시: npm 전역 원자 교체·사후 검증 이 강화되어 mixed 트리로 Gateway 를 올리면 control-ui 와 dist 가 엇갈립니다. doctor repair 와 같은 계열입니다. 검증 실패 시 재시작 대신 임시 prefix 정리 후 update 재실행 이 우선입니다.

3) 콜드 레지스트리: 플러그인 메타데이터가 콜드 영구 레지스트리 로 이동하면 허브에 안 보이는 증상이 늘어납니다. Ollama 라우팅 과 approvals 병행 시 OPENCLAW_PLUGIN_STAGE_DIR 를 릴리스 노트와 대조하세요.

Compose 는 프로덕션 런북 과 함께 읽고 이미지만 올리지 마세요.

02. 의사결정 매트릭스

작업	디스크	다운타임	롤백
migrate --dry-run	아니오	없음	해당 없음
migrate 적용	예	짧음	tar 복원
openclaw update	예	재시작	이전 태그
doctor	경우에 따라	초~분	유닛 되돌리기
플러그인 인덱스	인덱스	분	삭제+repair

일일 Mac FAQ 로 리허설 노드를 준비하세요.

03. 일곱 단계

스냅샷: ~/.openclaw·워크스페이스·유닛·Compose tar.
드라이런 migrate 및 로그 보관.
적용 후 계획과 diff.
스테이징에서 update, 병렬 금지.
doctor·스모크 테스트.
일일 macOS 에서 반복, 무잔류 체크.
24~48시간 관측.

Linux 게이트웨이는 VPS 가이드 와 함께 읽으세요.

npm prefix·Node 메이저를 tarball 이름에 적습니다.

환경별 systemd 이름을 구분합니다.

Hermes 가 비밀을 건드리면 로그 마스킹합니다.

롤백 타이머를 두고 예산 소진 시 즉시 실행합니다.

04. 명령

openclaw migrate --dry-run 2>&1 | tee /tmp/plan.log
openclaw migrate
openclaw update --channel stable
openclaw doctor
openclaw doctor --repair

05. 지표

업그레이드 후 Gateway 이슈의 27%–41% 가 검증 무시·구 dist.
드라이런으로 설정 삭제 사고 33%–52% 감소(자가 보고).
macOS 리허설 후 전환 시 롤백 19%–31% 감소.

오해: 포인트 릴리스는 migrate 생략, 경고 무시, Compose 이미지만 상향.

검증 실패 중 API 키 순환 중단.

semver+sha 로그 태깅.

계획 JSON 을 티켓에 첨부.

롤백도 리허설 노드에서 연습.

06. 본영 vs 일일 Mac

단일 본영에서 즉시 업그레이드는 준비 시간은 줄지만 트래픽과 위험이 겹칩니다. 감사 가능한 계획 을 원하면 격리 macOS 에서 먼저 완주하세요. 일일 Mac 대여 로 OPEX 화하고 키를 지웁니다.

FAQ, 요금 가이드, 홈.

2026 OpenClaw v2026.4.26 업그레이드: migrate 드라이런·백업, update 검증 실패 분석, 플러그인 콜드 레지스트리 체크리스트(일일 macOS 리허설)

목차