OpenClaw 2026.5.x는 외부 플러그인을 npm 그래프에 더 단단히 묶습니다. 셸은 새 채널인데 launchd는 옛 node_modules를 보는 이중 루트가 흔합니다. 아래는 대화형·데몬이 같은 PATH·npm prefix·바이너리 해시를 낼 때만 재현됩니다. plugins.entries·minGatewayVersion 정렬은
ClawHub·workspace·Gateway audit 런북을, 컨테이너·doctor 연동은
Docker/Podman·doctor 튜토리얼과 함께 두면 맥락이 이어집니다.
1. 2026.5.x 이행과 npm만 남기는 스위치
업그레이드 전 openclaw version·npm ls --depth=0·plugins.entries 스냅샷을 티켓에 붙입니다. 전환은 prefix 하나: 구 shim·pnpm/yarn 전역·타 사용자 캐시를 문서화한 뒤 제거합니다. plist PATH 앞에 새 bin만 두고 NODE_PATH 우회는 금지. CI 로그 첫 줄에 whoami·echo $HOME·which openclaw로 “데스크톱만 성공”을 조기에 잡습니다.
npm root -g·같은 OpenClaw 바이너리 해시를 출력할 것. 한쪽만 맞으면 로그에 “간헐 성공”만 남고 원인 추적이 늦어집니다.2. brew·글로벌·Docker에 남은 노후 레이어 벗기기
brew 잔재, 오래된 /usr/local, Compose 볼륨 속 구 node_modules가 ABI 드리프트를 만듭니다. 볼륨 사용 여부 확인 후 prune, 호스트는 doctor 고아 경로만 남깁니다. 재부팅 뒤 동일 시나리오를 한 번 더 밟습니다.
3. stable이 막힐 때 beta 채널 fallback
stable에 핫픽스가 없을 때만 beta dist-tag·해시를 런북에 고정합니다. “최신” 금지, 검증 빌드 하나만. PR에 stable 복귀 체크리스트를 넣어 롤백 창을 짧게 유지합니다.
4. gateway probe로 배포 합격선 고정
UI 대신 프로브 한 줄: 루프백·내부 DNS·SSH 터널에서 같은 curl(타임아웃·헤더·코드). 실패 시 직전 Compose 다이제스트로 롤백. 스크립트를 CI에도 복사합니다.
5. doctor 출력과 설정 JSON 1:1 대조
doctor가 로더·트랜스포트·비밀을 한 번에 스캔합니다. 경고 무시 배포는 2026.5.x에서 부분 로드를 드러내기 쉽습니다. openclaw.json과 doctor 요약을 diff하고 경고 0일 때만 태그 승격.
- Gateway·CLI·플러그인 패밀리의 시맨틱이 문서에 적힌 최소 버전과 일치.
- 프로브·doctor 로그를 같은 티켓에 첨부해 재현 경로를 한 줄로 남김.
- 원격 노드에는 빌드 캐시만 두고 비밀은 SecretRef 경로로 분리.
6. 원격 고메모리 Mac에 무거운 플러그인 작업만 보내기
노트북은 편집·프로브만, 고메모리 Mac에 네이티브 빌드·대형 번들·병렬 테스트를 큐로 넘깁니다. 게이트웨이는 얇게, RAM 피크 작업만 원격으로 보내 스왑 경쟁을 줄입니다. 리전·RAM은 Macstripe 홈에서 고릅니다.
npm·플러그인 빌드를 macOS·Mac mini에 두면 좋은 이유
플러그인 빌드는 통합 메모리·NVMe에 민감합니다. Mac mini M4는 저전력·저소음으로 네이티브 컴파일에 적고, macOS는 launchd·서명·Gatekeeper·SIP·FileVault로 무인 운영이 수월합니다. npm·probe·doctor 런북을 옮기려면 사양을 먼저 고정하세요. Macstripe 홈에서 리전·메모리를 고르면 원격 분산과 같은 패턴을 검증대에도 빠르게 맞출 수 있고, 이후 2026.5.x 패치의 정리 비용도 줄어듭니다. 지금 Mac mini M4 기준을 잡아 두는 것을 권합니다.
