01. 세 가지 페인: 업그레이드 후 채널 «소실», 미사용 SDK 디스크, pnpm/peer 스캔
02. full core vs 선택 채널 플러그인: v2026.5.12 결정 매트릭스
03. 7단계: 동결 → 백업 업그레이드 → plugins install → channels → Telegram → doctor → 증거
04. 트리아지: 증상 → 우선 조치 → 오작동
05. 데이터 3건·오해와 1~3일 렌탈 일정
06. 헤드리스 Linux vs 일일 Mac

01. 세 가지 페인: 업그레이드 후 채널 «소실», 미사용 SDK 디스크, pnpm/peer 스캔

1) 5.12 이후 WhatsApp/Slack이 «고장»처럼 보임: 릴리스 노트는 WhatsApp, Slack, Amazon Bedrock, Anthropic Vertex 등을 core 런타임 의존에서 분리하고 ClawHub/npm 플러그인으로 선택 설치합니다. openclaw.json에 channels.slack이 남아 있어도 플러그인이 없으면 Gateway 도구 표면에 inbound/outbound 핸들러가 없습니다. «설정 존재»와 «installed + enabled + runtime 스캔 통과»를 Runbook에서 별도 게이트로 분리하세요.

2) 디스크·CI 이미지가 쓰지 않는 채널 SDK로 부풀어 오름: Lean core는 실제로 쓰는 프로바이더·채널만 가져옵니다. 예전 «전부 포함» 글로벌 레이어를 bake하면 AWS SDK·Baileys 등으로 수백 MB가 남습니다. ClawPack 공급망과 병행할 때는 기억이 아니라 plugins list와 manifest 해시로 감사합니다.

3) pnpm 11, peer, 설치 시 보안 스캔: 5.12는 pnpm 11 지원, 서드파티 peer 보존, 플러그인 소유 runtime 진입점 스캔을 강조합니다. 스캔 WARN에 npm install -g --force를 반복하면 managed 플러그인 루트가 깨집니다. openclaw plugins와 openclaw doctor, 5.7 update 위생을 우선하세요.

02. full core vs 선택 채널 플러그인: v2026.5.12 결정 매트릭스

능력면(5.12)	통과 신호	일일 macOS 증거
WhatsApp 플러그인	`plugins list`에 whatsapp enabled; Baileys registry 해석	전후 `channels status --channel whatsapp` JSON(마스킹)
Slack 플러그인	설치 후 Gateway 재시작; 잘못된 redirect에도 미디어 fetch 유지	5.12 보안 pass scope 기록
Bedrock / Vertex	미설치 시 core에 AWS cone 없음; 설치 후 provider 모델 표시	`du` core만 vs +Bedrock 차이
Telegram 그룹	단일 계정 명시적 빈 `groups: {}`가 전체 그룹 트래픽을 떨어뜨리지 않음(5.12 수정)	업그레이드 전후 그룹 프로브 로그 각 1건
Node 런타임	Node 24 권장(또는 ≥22.19)	Runbook 헤더에 `node -v`

03. 7단계: 동결 → 백업 업그레이드 → plugins install → channels → Telegram → doctor → 증거

기준선 동결: openclaw --version, plugins list, channels list --all, 로드된 openclaw.json 경로.
백업·업그레이드: 설정 스냅샷 후 v2026.5.12. stdout·종료 코드 보관.
실제 채널만 설치: «전부 설치»는 Lean core를 무효화. 플러그인마다 Gateway 재시작.
channels·plugins 교차 검증: configured/enabled 양면 일치.
Telegram groupPolicy 회귀: 단일 계정 명시적 빈 groups: {} 사용 시 루트 channels.telegram.groups 확인.
doctor·디스크 예산: runtime 스캔 WARN 해소; managed 루트 크기 변화 측정.
증거·삭제: 로그 마스킹; 렌탈 호스트 데모 token·Slack signing secret 삭제.

openclaw --version
openclaw plugins list 2>&1 | tee /tmp/oc512-plugins-before.txt
openclaw update
openclaw plugins install <plugin-id>
openclaw gateway restart
openclaw doctor 2>&1 | tee /tmp/oc512-doctor.txt

디스크 여유 15 GB 미만이면 «업그레이드 + 다중 플러그인 + 재시작» 병행 시 pnpm 재시도가 늘어납니다. 캐시를 먼저 정리하고, 대역폭은 FAQ를 참고하세요.

04. 트리아지: 증상 → 우선 조치 → 오작동

증상	우선 조치	오작동
Slack 설정 있으나 Slack 도구 없음	Slack 플러그인 install; Gateway 재시작	밤새 모델 라우트만 수정
install이 스캔으로 거부	플러그인 진입 경로 확인; 5.12 바이너리 검증	글로벌 npm --force
Telegram 그룹 무음	명시적 빈 `groups: {}` 의미 확인	맹목적 `groupPolicy: open`

05. 데이터 3건·오해와 1~3일 렌탈 일정

데이터 1: GitHub 릴리스 v2026.5.12는 2026-05-14 배포. WhatsApp/Slack/Bedrock/Vertex 외부화 문서화.
데이터 2: 문서는 Node 24 권장. M4 렌탈에서 CLI+Control UI 수용은 2~4시간 집중 창에 자주 맞음.
데이터 3: 단·이중 채널 환경에서 레거시 full core 대비 의존 트리 30~55% 축소 사례(이력에 따라 변동).

1일차: 기준선+업그레이드+플러그인 1개. 2일차: 두 번째 채널 또는 Bedrock+Telegram 프로브. 3일차: 롤백 연습·비밀 삭제.

06. 헤드리스 Linux vs 일일 Mac

VPS는 Gateway 가동 비용이 낮지만, 플러그인 로그·브라우저 ClawHub·Keychain deploy key를 분산하면 숨은 비용이 큽니다. 짧은 네이티브 macOS 렌탈은 plugins list, channels status, Control UI를 한 증거선으로 맞춰 본 전환 전 Runbook을 남깁니다.

컨테이너·SSH는 단기 검증에 적합합니다. 1~3일 내 인수인계 Runbook이 필요하면 일일 Mac이 운영 시간 면에서 유리한 경우가 많습니다. 요금 안내와 FAQ를 확인하세요. Linux만으로도 가능하지만 GUI·CLI를 한 타임라인에 맞추는 부채가 남기 쉬우며, Apple 데스크톱 인접 재현성을 우선하는 팀은 단기 네이티브 macOS가 되돌림을 줄입니다.

2026 OpenClaw v2026.5.12 모듈형 설치 완전 가이드:
WhatsApp/Slack/Bedrock 선택 채널 플러그인, Lean core 마이그레이션 및 `openclaw plugins` 수용(일일 macOS 격리)

목차