2026 헤드리스 클라우드 Mac에서 OpenClaw 온보딩과 install-daemon: MacLogin Apple Silicon 게이트웨이를 위한 SSH 우선 구성

대부분의 MacLogin 고객은 데이터센터로 날아가지 않습니다—홍콩·도쿄·서울·싱가포르·미국에서 Apple Silicon mini를 프로비저닝하고 곧바로 SSH로 자동화 스택을 설치합니다. OpenClaw의 2026 온보딩 흐름은 최신 Node 런타임, 일부 채널에 대한 선택적 macOS GUI 권한, 로그아웃 후에도 살아남는 LaunchAgent 게이트웨이를 가정합니다. 이 가이드는 그 단계를 전부 SSH로 수행하면서도 감사 가능한 산출물을 남기는 방법을 보여 줍니다. 설치 경로 비교, 기본 TCP 리스너 가정, 6단계 헤드리스 런북, 변경 관리용 doctor 출력 확보까지 다룹니다.

교차 링크: 설치 스크립트 vs npm 전역, Node 전제 조건, 게이트웨이 데몬 문제 해결, doctor 진단. 사람이 읽는 온보딩은 도움말, 리전 선택은 요금, GUI 의존 항목은 나중에 VNC로 검증하세요.

클라우드 Mac 게이트웨이에서 헤드리스 온보딩이 기본인 이유

• 속도—팀은 리스 활성화 후 몇 분 안에 게이트웨이를 켜 두고 싶어 하며, KVM 장비 배송을 기다리지 않습니다.
• 반복 가능성—감사인이 무슨 일이 있었는지 물을 때, 복사 안전한 SSH 기록이 즉흥 Screen Sharing 녹화보다 낫습니다.
• 격리—MacLogin 노드는 하드웨어 단일 테넌트여도, 개인 Apple ID에 의존하지 않는 스크립트 설치가 이득입니다.

베이스라인 요구사항, 포트, 수치 목표

상류 문서는 계속 Node.js 22 이상을 권장합니다. 내부 런북에는 최소 22.14.0을 고정해 모든 리전이 동일 ABI로 재빌드하게 하세요. 게이트웨이는 흔히 TCP 18789를 수신합니다—방화벽 티켓에는 sshd의 22와 함께 기재합니다. 가벼운 워크로드에는 RAM 8 GB, 스킬이 네이티브 헬퍼를 동시에 컴파일하면 16 GB를 할당하세요.

curl 설치기 vs 고정 npm 전역

curl 설치기는 macOS에서의 첫 성공을 최적화하고, npm 전역은 이미 tarball을 내부 미러링하는 팀에 맞습니다. 어느 쪽도 이후 openclaw doctor를 없애지 못합니다—doctor는 헬스 체크 런북의 프로덕션 전환 검사와 동일한 게이트로 취급하세요.

온보딩 프롬프트와 launchd를 통한 install-daemon

비밀번호 프롬프트와 TTY 민감 단계에는 ssh -t를 사용하세요. 온보딩 후 문서화된 라벨(커뮤니티 글에서는 ai.openclaw.gateway가 흔함)로 LaunchAgent를 등록하고, SSH 로그아웃 전에 launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway가 깨끗한 상태 코드를 반환하는지 확인하세요.

doctor 검증 매트릭스

doctor 신호	건강한 기대	헤드리스 교정	오너
게이트웨이 HTTP 프로브	localhost:18789에서 HTTP 200	루프백 방화벽을 열고 에이전트 재시작	SRE 1차
공급자 인증	토큰 범위 검증됨	systemd 호환 셸 프로필에서 환경 변수 재보내기	플랫폼 보안
디스크 권한	작업 공간 경로 쓰기 가능	chmod 777 없이 POSIX ACL 수정	리스 관리자

6단계 헤드리스 런북

1. 사전 점검 node -v와 Xcode 무거운 스킬을 위한 여유 디스크 > 30 GB.
2. CLI 설치 승인된 경로(curl 또는 npm) 사용.
3. 비밀보내기 월드 읽기 가능한 dotfile 밖에 모드 0600의 root 소유 파일로.
4. 실행 PTY로 openclaw onboard를 돌리고 로그 확보.
5. 데몬 설치 및 launchd 등록 검증.
6. 성공 선언 전 JSON doctor 출력을 변경 티켓에 게시.

콘솔에 아무도 닿을 수 없을 때의 실패 모드

PTY 누락은 공급자 프롬프트에서 조용히 멈춥니다. 비로그인 셸에서 잘못된 $PATH는 npm 전역을 깨뜨립니다. 관리자 이관 후 잘못된 UID에 묶인 LaunchAgent는 유령 프로세스를 만듭니다—id -u가 ~/.openclaw 소유 계정과 일치하는지 항상 확인하세요.

FAQ

게이트웨이를 SSH로 터널링할 수 있나요? 예—SSH 터널 설정 패턴을 따르세요.

cron과 공존하나요? cron+launchd 순서를 읽은 뒤 스케줄하세요.

웹훅은? TLS 종료는 리버스 프록시 가이드에 두세요.

실용적인 OpenClaw 게이트웨이 호스트로서의 Mac mini M4

M4의 통합 메모리 아키텍처는 Node와 네이티브 툴체인을 같은 전력 범위에 두어, 멀티 스킬 팬아웃 중 게이트웨이가 스파이크할 때 중요합니다. MacLogin의 HK·JP·KR·SG·US 메트로 베어 메탈 리스는 과구독 VM과 달리 CPU가 예측 가능해 doctor 타이밍이 주간 단위로 비교 가능합니다—자동 헬스 체크의 지연 회귀에 대한 알림에 핵심입니다.

mini를 임대하면 CapEx 부담을 줄이면서 Keychain, codesign, Apple 공증 CLI 등 Linux 컨테이너 안에서는 억지스러운 macOS 전용 동작을 유지해 OpenClaw 도구 생태계가 자연스럽게 느껴지게 합니다.