2026년 ClawHub 도입 팀이 흔히 섞는 세 겉면: Gateway가 보는 openclaw skills, 레지스트리용 ClawHub CLI, 런타임 플러그인 엔트리입니다. 루트·환경 변수·doctor 헤딩이 갈라지면 데스크톱 CLI는 “설치됨”인데 launchd 서비스 계정 HOME에는 비어 스킬만 있고 도구 없음 플레이크가 납니다. 루트 정렬 → workspace 스킬 우선 → 채널 전 minGatewayVersion → 잘못된 플러그인 패밀리를 넣었다 뺀 재현 순서를 정리합니다. 감사·백업·혼합 설치는
SecretRef·backup·doctor·상주 Gateway 튜토리얼과 함께 보세요.
2026.3.x Docker·HTTP 플러그인·doctor 참고.
1. openclaw skills와 ClawHub CLI: 설치기는 둘, 계약은 하나
openclaw skills는 Gateway가 믿는 목록·오버라이드·깨진 링크의 권위 뷰입니다. ClawHub CLI는 tarball을 자기 캐시에 푸는 레지스트리 클라이언트입니다. HOME·PATH가 갈라지면 재현이 깨지므로 호스트마다 설치 루트 한 곳을 문서화하고, 셸·unit에 같은 PATH·토큰을 넣으며, CI에서는 whoami·echo $HOME·설정 경로를 로그 첫 줄에 남기세요.
openclaw skills에 없으면 Gateway는 신뢰하지 않습니다. ClawHub 출력과 무관합니다.2. workspace 스킬 우선: 섀도잉·머지·「저장소 A에서만 됨」
워크스페이스 로컬 스킬은 저장소에 동작을 고정할 때 씁니다. 보통 workspace → 사용자 → 전역 순이나, 사용자 트리에 남은 메타가 꼬이면 예외가 납니다. Git의 workspace 매니페스트를 기준으로 백업 뒤 고아 캐시를 지우고 Gateway를 재시작하세요. 이슈 전에는 매니페스트만 diff하고 .env 샘플은 비밀 누출 없이 다룹니다.
3. minGatewayVersion: 채널·플러그인 전에 실패 빠르게
“릴리스 X 이후 API를 기대한다”는 계약입니다. 이상적으로는 뒤처진 바이너리에서 시맨틱 메시지로 부분 로드 없이 멈춥니다. 그런데 brew·npm·구 바이너리 Docker 마운트가 섞이면 CLI만 새고 데몬은 구버전입니다. unit 경로에서 openclaw version을 찍어 문서에 고정하고, 필드를 올릴 때 Gateway 이미지·병을 같이 올리세요. 롤백 태그·이전 Compose 다이제스트를 런북에 남깁니다.
4. 플러그인 패밀리 오설치 재현
패밀리마다 HTTP·미들웨어·선택 네이티브가 묶입니다. 비슷한 이름의 포크 슬러그나 2026.4.x 라우트 접두 변경이 흔한 원인입니다. openclaw.json 스냅샷 → VM에 오패밀리만 설치 → doctor로 충돌·중복 라우트 캡처 → Gateway 버전 고정 채 엔트리만 바꿔 증상 소멸을 인과로 남깁니다. 훈련 뒤 웹훅 비밀을 복구해 감사 로그를 유지하세요.
launchd/Compose에 Gateway 바이너리 경로 하나,which openclaw이중 없음.- 배포 시맨틱 ≥ 스킬이 요구하는
minGatewayVersion; 새 트랜스포트 켤 때 둘 다 올림. plugins.entries는 명시 경로만, 글롭으로 두 패밀리 금지.
5. 원격 고메모리 Mac: 버전 핀과 보안 audit 루프
상주 Gateway는 고메모리 전용 Mac에 두어 Xcode·러너와 RAM 대역을 나눕니다. Node·OpenClaw·스킬 다이제스트를 openclaw.json 옆 락파일에 고정하고, 스테이징 plist를 운영과 동일하게 맞춘 뒤 doctor 후 승격합니다. 주간: 토큰 가린 설정보내기, plugins.entries와 허용 목록 대조, 출처 필드·로그를 티켓에 붙입니다. 스킬 범프 주기에 배포 키 회전을 맞추면 침해 창이 짧아집니다.
macOS·Mac mini급 하드웨어가 이 제어 평면에 맞는 이유
Gateway는 코어보다 안정 메모리·발열·디스크가 중요합니다. Apple Silicon Mac mini는 NVMe·통합 메모리로 MCP·HTTP를 동시에 돌리고, macOS는 launchd·서명·수면을 기본 제공합니다. Gatekeeper·SIP·FileVault로 무인 리스크를 낮추고 대기 전력도 유리합니다. 고메모리 원격 노드는 Macstripe 홈에서 리전·RAM을 맞추면 됩니다. 핀·감사 기준은 Mac mini M4로 잡고, 홈에서 사양을 비교한 뒤 구성을 옮기면 이 런북을 그대로 이어 가기 쉽습니다.
