OpenClaw형 게이트웨이를 원격·상시 Mac에 두면 장애 다수는 launchd 이탈·남은 리스너·같은 Label plist 경쟁에서 납니다. doctor·상태·로그를 SSH마다 같은 순서로 맞추는 2026 실무서입니다. 경로·비대화형 PATH부터 보려면 2026 OpenClaw 원격 Mac 배포 실무: 설치 경로 대조, Docker와 로컬 상주, 흔한 오류와 워크플로 사례, 러너·에이전트까지는 2026 OpenClaw 손에 익는 배포·자동화 통합: 크로스플랫폼 에이전트 오프라인·실행 권한, GitHub Actions 다중 러너 실전과 함께 보세요.
1. plist를 건드리기 전에 doctor·상태·로그를 맞춘다
Doctor는 관리 포트·토큰 경로·데이터 디렉터리처럼 바이너리가 아는 설정을 묻습니다. SSH에서는 plist와 동일한 PATH로(bash -lc 등) 돌리세요. 상태는 HTTP·gRPC 헬스와 TLS, 호스트 기준 업스트림입니다. 로그는 doctor 통과인데 상태만 흔들릴 때 증거를 남깁니다. ~/Library/Logs/OpenClawGateway 등 전용 경로와 로테이션을 권합니다.
2. 무인 Mac에서 게이트웨이를 물게 하는 launchd 함정
LaunchAgent는 로그인 이후, LaunchDaemon은 GUI 이전 root입니다. 재부팅 후에도 사용자 없이 살려면 보통 /Library/LaunchDaemons와 root 소유 바이너리가 안전합니다. WorkingDirectory·절대 ProgramArguments·표준 출력/에러 경로·ThrottleInterval을 채우고, launchctl print와 log show --predicate 'subsystem == "com.apple.launchd"'로 즉시 종료 원인을 봅니다. doctor가 네트워크까지 못 가면 PATH·권한·샌드박스를 의심하세요.
GUI 비밀 때문에 사용자 에이전트에 묶인다면 로그인 요구·화면 공유·강제 로그아웃 시 영향을 문서화하고, plist 주석과 저장소에 동일 시맨틱 버전을 맞춰 원격 “현장 수정”이 diff에 남게 하세요.
3. 포트 바인딩: “address already in use”가 두 서비스일 때
lsof -nP -iTCP:<port> -sTCP:LISTEN으로 PID를 보고 launchctl print gui/$uid 또는 launchctl print system의 Label과 맞춥니다. plist PID가 아니면 unload 후 경로를 고치고 고아만 종료하세요. 같은 호스트에 셀프 호스티드 러너가 있으면 killall은 자제합니다. Docker Desktop이 호스트 포트를 쓰면 VM이 먼저 잡으므로 포트를 분리하거나 게이트웨이를 베어 macOS에 두세요.
4. 이중 LaunchAgent: 중복 Label과 설치 스크립트
같은 Label plist가 두 폴더에 있으면 재부팅마다 승자가 바뀝니다. find /Library/LaunchAgents ~/Library/LaunchAgents /Library/LaunchDaemons -name '*.plist'로 인벤토리를 뽑고 권위 plist 하나만 남기세요. Ventura+에서는 bootout/bootstrap 순서를 런북에 적고, 잘못된 사용자 bootstrap은 TCC 실패로 이어집니다.
5. 원격 상주 Mac 티켓에 그대로 붙여 넣는 체크리스트
- AC에서 디스크 슬립 해제, 디스플레이 슬립 시 Wi‑Fi 단절 여부.
- 네트워크 시간 — 시각 몇 분만 어긋나도 TLS가 실패합니다.
- 디스크 85% 전 알림(캐시·첨부로 ENOSPC 방지).
- 토큰 교체 후 job 재시작·로그에 새 자격 증명 흔적 확인.
- 공개 경로로
curl스모크(localhost만 보지 않기).
상시 게이트웨이는 Mac mini급 호스트에 얹기 쉽다
헬스가 흔들리면 온콜이 바로 늘어납니다. Mac mini(Apple Silicon)는 단일 스레드와 낮은 유휴 전력을 같이 주고, Unix·Homebrew·macOS Gatekeeper·SIP·FileVault로 무인 노드 설명이 단순해집니다. 용량을 늘리기 전 Macstripe 홈에서 기종을 비교해 보세요.
이 핸드북을 조용한 베이스에서 돌리려면 Mac mini M4가 현실적인 출발점입니다. 전용 원격 노드를 알아볼 때는 Macstripe 홈 페이지에서 리전과 구성을 확인하세요.
