사용자 LaunchAgent · 18789 프리플라이트 · 플러그인 경로 결정성 · 혼합 노드 영향 반경 압축
v2026.5.3-beta.2는 데모용 화려한 차이보다 월요일 아침에 조용히 일어나야 할 클라우드 Mac을 위한 중간 릴리스입니다. launchd는 프로세스의 부모이고 Gateway는 그 자식 중에서도 외향 얼굴입니다. 순서가 뒤집히면 헬스 엔드포인트만 먼저 녹색이 되고 반쯤 로드된 플러그인 로더가 채널에 손대는 ‘속 빈 green’이 생깁니다. beta.2는 사용자 LaunchAgent 재기동 레이스를 억제하고 짧은 시간 반복되는 launchctl kickstart와 수동 openclaw gateway가 경쟁하지 않게 스로틀과 종료 코드 처리를 맞춥니다. 이어 Gateway 웜업 순서를 고정해 18789에 BIND한 직후 실행되는 플러그인 매니페스트 읽기와 샌드박스 경계 선언이 매번 같은 로그 줄로 떨어지게 했습니다. 세 번째 축은 플러그인 경로 결정성입니다. 팀이 OPENCLAW_PLUGIN_DIR을 쓰면서도 홈 아래 기존 경로를 유지하면 같은 skill이 두 갈래로 보일 수 있습니다. beta.2는 우선 규칙을 코드와 기동 요약 모두에서 점검할 수 있게 합니다. 배경으로 혼합 Gateway나 차가운 레지스트리 이슈는 4.25 플러그인 레지스트리 복구 글, 이전 절차는 migrate·OPENCLAW_PLUGIN_DIR 검수 글이 유용합니다. launchd 전반은 launchd 안정 운영 체크리스트를 바탕으로 외향 통신은 4.27 아웃바운드 프록시 글과 맞추세요. OAuth·fetch가 아픈 팀은 5.6 복구 글을 먼저 적용하고 beta.2는 상주·플러그인 층 위생으로 두면 버전 이야기가 통합니다.
관측상 ‘가끔 느리다’, ‘플러그인이 로드된 것 같지 않다’, ‘재시작하면 낫는다’로 보이나 뿌리는 거의 순서나 경로입니다.
LaunchAgent 레이스: 베타 통로에서 개발자가 짧은 주기로 kickstart -k를 씁니다. 스로틀을 무시한 것처럼 보이는 재시작이 이어지면 자식 PID가 로그 추적을 헷갈리게 합니다.
Gateway 프리플라이트 건너뛰기: 매니페스트를 읽기 전 헬스만 응답하는 틈에 외향 채널이 초기화된 것처럼 보일 수 있습니다.
플러그인 경로 이중 노출: 레지스트리가 아직 덥지 않은 순간에 skill을 두 번 집으면 중복 실행이나 묵은 폴백이 납니다.
혼합 노드 라벨: 같은 Mac에 canary와 stable을 같이 두면 plist Label을 사람이 읽는 비용이 튑니다.
beta.2는 이를 ‘성격’이 아니라 절차로 억제합니다.
‘항상 최신 베타’는 기분 좋지만 고객 데모 직전 단일 노드에선 위험합니다.
| 전략 | 어울리는 편성 | 이점 | 주의 |
|---|---|---|---|
| A. beta.2 전 노드 | 스냅샷 운용이 가벼움 | LaunchAgent와 Gateway 로그가 맞음 | OAuth 쪽은 5.6 우선순위를 확인 |
| B. canary 한 대만 beta.2 | 메시징 본번 동거 | 플러그인 해석 차이를 먼저 봄 | plist Label 명명 규율 필요 |
| C. beta.1 고정+야간만 시험 | 변경 심사가 무거움 | 심사 보드에 설명 쉬움 | 증상을 안고 갈 수 있음 |
| D. Docker와 launchd 역할 분리 | 컨테이너 검증 병행 | 경계가 분명 | 볼륨 마운트·경로 이중화 주의 |
상시 정합성은 헬스 JSON이 아니라 기동부터 첫 채널 응답까지의 로그 열로 결정된다.
VNC를 연 채 작업하세요. 콘솔과 브라우저를 동시에 봐야 하는 구간이 있습니다.
현행 plist 내보내기: Label, ProgramArguments, 환경 변수 주입을 통째로 적고 diff 가능한 형태로 티켓에 붙입니다.
스냅샷: 클라우드 Mac은 볼륨 단위입니다. rollback 설명 책임을 충족합니다.
beta.2 바이너리 정합: CLI와 Gateway를 같은 변경 창에서 올립니다. 한쪽만 새면 로그가 모순됩니다.
환경 변수 단일화: OPENCLAW_PLUGIN_DIR을 한 곳으로 정하고 셸 프로필과 plist 이중 정의를 풉니다.
launchctl 현실 확인: print와 error를 본 뒤 kickstart합니다. 감정이 아니라 상태로 재시동합니다.
Gateway 로그 삼단 검사: BIND, 매니페스트, 첫 채널 핸드셰이크까지 줄 번호를 기록합니다.
플러그인 연습: 대표 skill 두 개만 켜고 중복 로드 경고가 없는지 봅니다.
# 변경 티켓용 (적용 직후) openclaw --version launchctl print gui/$(id -u)/com.example.openclaw.gateway | head -n 40 openclaw doctor --verbose | tee /tmp/openclaw-doctor-beta2.txt curl -sS -D - https://127.0.0.1:18789/health -o /dev/null
참고: stderr를 한데 보려면 터미널에 2>&1을 붙이세요. 터미널과 VNC 모두 같은 사용자인지 한 번 확인합니다.
주의: 베타 통로는 의미가 움직일 수 있습니다. 본번과 같은 토큰을 직접 연결하지 마세요.
| 공정 | SSH | VNC |
|---|---|---|
| 브라우저 동의와 터미널 로그 대조 | 로그 조각만 | 권장 |
| 여러 데스크톱에 흩어진 Console | 불편 | Mission Control로 한 번에 |
| TCC 재프롬프트 | 보이지 않음 | 클릭 순서가 재현 절차 |
| launchd GUI 부가 메시지 | 지연 표시 | 동시 파악 |
| 플러그인 대시 시각 확인 | 텍스트만 | 버전 열 스크린샷이 증거 |
18789는 루프백이어도 브라우저는 루프백 위에서 사람 조작이 필요한 구간이 남습니다.
Label 네임스페이스: com.team.env.service처럼 세 단으로 고정합니다. 구두 ‘그 plist’ 금지.
Mac 두 대: canary와 stable을 같은 데스크톱에 섞지 않습니다. 섞으면 포트와 WorkingDirectory를 완전 분리합니다.
doctor 보존: 베타 적용 전후 tee 로그를 첨부합니다. 5.6 Doctor와는 다른 티켓으로 섞선을 막습니다.
프록시 재확인: 기업 출구가 바뀐 날 Gateway뿐 아니라 launchd 환경에도 반영됐는지 봅니다(4.27 글).
롤백 이단계: 바이너리·plist·플러그인 디렉터리를 나눠 기록합니다.
OAuth·fetch·디스패처 통증.
읽기 →plist·로그·권한 기초.
읽기 →경로 결정성의 토대.
읽기 →launchd가 먼저 프로세스 경계를 만들기 때문입니다. kickstart 습관과 기동 순서가 어긋나면 로그상 녹색인데 속이 빈 경우가 생깁니다.
여러 루트에 같은 이름이 있어도 최종 경로가 하나로 정해지고 기동 요약에서 확인할 수 있는 상태입니다.
브라우저 동의, TCC, 여러 창의 로그 대조입니다.
5.6은 OAuth·fetch 회복이고 beta.2는 상주·플러그인 층 선행 정리입니다. 혼합 노드는 적용 순서를 문서화하세요.
v2026.5.3-beta.2는 채널 폭을 넓히기보다 노드가 오래 사는 자리표입니다. LaunchAgent, Gateway, 플러그인 셋을 같은 로그 열로 읽을 수 있게 두면 다음 베타에서도 조사 비용이 튀지 않습니다.
검증용 Apple Silicon 원격 Mac이 필요하면 VNCMac 임대를 활용하세요. 계약은 Mac 클라우드 구매 페이지, 연결 절차는 헬프 센터에서 먼저 확인하면 좋습니다.