렌탈 Mac mini에서의 OpenClaw 게이트웨이 재시작: LaunchAgent 함정과 2026년 안전 복구
OpenClaw 게이트웨이는 홍콩·일본·한국·싱가포르·미국에 둔 렌탈 Mac mini M4에서 채팅 채널, 도구 호출, 모델 백엔드를 잇는 장수명 프로세스입니다. 운영자는 인증서 순환, 토큰 갱신, 멈춘 채널 어댑터, macOS 업데이트 후 등에 재시작합니다——그런데 launchctl bootout이 유일한 감독 경로를 없애 갑자기 «헤드리스»가 되기도 합니다. 이 2026 플레이북은 게이트웨이 재시작이 단발 CLI와 어떻게 다른지, 네 열 위험 매트릭스, 자멸을 피하는 안전 복구 순서를 설명합니다. 설치 및 배포, 배포 문제 해결, LaunchAgent 스케줄링과 함께 써서 매 bounce 뒤에도 PATH, TMPDIR, 비밀이 맞춰지게 하세요.
2025–2026 커뮤니티 스레드는 반복되는 macOS 주제를 짚습니다: 같은 에이전트 세션이 명령을 냈는데 LaunchAgent를 내리는 게이트웨이 재시작 흐름으로 launchd에 깨끗한 재부트 스토리가 없어지는 것입니다. 상류 버그 번호를 복제할 필요는 없습니다——재시작 순서를 운영 데이터로 취급하고, 무인 금속에서 launchd 그래프를 바꾸기 전에 항상 두 번째 제어 평면(추가 SSH, 대역 외 VNC, 공급자 콘솔)을 확보하세요.
노트북보다 클라우드 mini에서 게이트웨이 재시작이 더 위험한 이유
노트북은 메뉴 막대 아이콘이 죽으면 사람을 깨웁니다. ProxyMac mini는 랙에 있고 로컬 좌석이 없을 수 있어 게이트웨이는 자동화의 뇌이자 페어링 승인을 듣는 유일한 프로세스입니다. 체크리스트 없이 재시작하면 채널 허용 목록을 조용히 떨어뜨리거나 진행 중인 도구 핸들을 잃거나 MCP 설정의 stdio 자식과 엇갈립니다.
- 단일 테넌트 기대: 고객은 CPU가 자신 것이라 가정——소통 없는 플랩은 Sev-1이 될 수 있습니다.
- GUI 인접 권한: 재시작 뒤 TCC 프롬프트가 원격에서 다시 안 뜰 수 있음——사전에 TCC 순서를 밟으세요.
- 디스크의 비밀: 같은 창에서 토큰을 돌리기 전에 키체인 강화에 따라 잠금 해제 경로를 검증하세요.
위험 매트릭스: 조치 → 영향 범위 → 탐지 → 완화
| 조치 | 영향 범위 | 탐지 | 완화 |
|---|---|---|---|
감독 세션 안에서 openclaw gateway restart | 재실행 완료 전에 프로세스가 종료 | SSH 채널 닫힘; webhook 대기 정체 | 보조 SSH; 라벨 확인 후 launchctl kickstart -k gui/$(id -u)/… 패턴 선호 |
| plist를 ~/Library와 /Library 사이로 이동 | status CLI가 도메인에 대해 거짓 | openclaw status와 launchctl print 불일치 | 도메인 모델 하나 고르고 runbook에 경로 기록 |
| EnvironmentVariables 편집 후 reload 안 함 | 낡은 PATH → MCP 바이너리 없음 | 도구 호출 ENOENT | 한 번만 bootout/bootstrap 쌍 후 soak 테스트 |
| 동시 업그레이드 + 재시작 | semver 설정 혼합 | doctor 경고 | 직렬화: 먼저 업그레이드 후 재시작; openclaw doctor 출력 저장 |
안전 복구 순서(먼저 대화형, 다음 무인)
- 두 번째 SSH 세션을 연다(또는 VNC 도움말에 따라 화면 공유)한 뒤
launchd를 만진다. - 상태 확보:
openclaw status, 게이트웨이 로그, 채널 페어링 목록——티켓에 첨부. - 알려진 LaunchAgent 라벨에는 kickstart -k 선호, 트래픽이 흐르는 동안 bootout 루프를 반복하지 않는다.
- plist ProgramArguments가 bootstrap에서 검증한 것과 같은 venv 또는 전역 설치를 가리키는지 확인.
- doctor 재실행과 최소 채널 프로브로 녹색 선언 전 검증.
- 로그가 서로 다른 날 두 번 깨끗한 재시작을 보일 때만 무인으로 승격——LaunchAgent 체크리스트를 따른다.
재시작 후 환경과 설정의 일치
게이트웨이 프로세스는 좁은 환경만 상속합니다. 대화형 셸은 nvm, pyenv, direnv 훅을 끌어오지만 LaunchAgents에는 없습니다. 재시작마다 LaunchAgent 컨텍스트의 printenv를 로그인 셸과 diff하고 MCP 서버 경로를 맞추세요.
로그 분류: 먼저 grep할 것
재시작 타임스탬프 근처의 게이트웨이 stderr부터 시작하고, 서브시스템 필터를 켰다면 통합 로그로 넓힙니다. HTTP 트리거가 있으면 인바운드 webhook 재시도와 상관시키세요——429 폭풍은 게이트웨이 크래시처럼 보여도 아닐 수 있습니다.
설치, MCP, webhook, 생산 워크플로로의 다리
게이트웨이 복구는 첫 설치, 생산 워크플로, 병렬 에이전트 한도 사이에 있습니다. 문서가 흩어져 있으면 내부 wiki에 모으고 재무가 신뢰하는 것과 같은 도움말 센터 앵커를 쓰세요. 재시작 전 게이트웨이 설정을 Git로 승격·태깅하는 절차는 OpenClaw 설정 버전 관리와 GitOps(2026)를 함께 두면 launchctl kickstart가 조용히 바뀐 JSON 대신 검증된 매니페스트를 재생합니다.
FAQ
gateway restart 후 서비스가 계속 down인 이유? 공격적 unload 경로 + 단일 채널 제어——kickstart 패턴과 두 번째 세션.
~/Library vs /Library? 기본은 사용자별 LaunchAgents; 데몬은 소유권과 상태 의미를 바꿈——하나 고르기.
무인 스케줄? 복구 후 스케줄링 글 체크리스트로 PATH/TMPDIR 재검증.
게이트웨이 재시작을 단련하기에 ProxyMac Mac mini가 맞는 이유
항상 켜진 베어메탈, 안정된 macOS 사용자 세션, MCP 자식을 위한 예측 가능한 CPU, 통합하는 채팅 API 옆 HK / JP / KR / SG / US 배치가 필요합니다. ProxyMac은 일회용 mini에서 재시작 훈련을 반복하고 명령을 요금 옆에 남기며 플레이북이 성숙한 뒤 호스트를 퇴역시킬 수 있게 합니다——노트북의 단일 LaunchAgent 그래프를 위험에 빠뜨리지 않고도요.
