2026-04-17 헤드리스 임대 클라우드 Mac에서 OpenClaw onboard 및 install-daemon

OpenClaw 2026 npm 배포는 CLI 우선을 강조합니다: 전역 설치, openclaw onboard, LaunchAgents로 게이트웨이를 구성합니다. SSH만 있는 임대 Apple Silicon Mac에서는 GUI 가정 프롬프트, 누락된 환경 변수, 뒤처진 Node가 발목을 잡습니다. 2026-04-17 가이드는 전제, 고정 설치, 데몬 생성, HK/JP/KR/SG/US 검증을 다룹니다. 이후 업그레이드·롤백, launchd 시크릿, 헬스 프로브를 읽고 webhook을 노출하세요.

첫 성공 시 openclaw --version, node -v, 생성된 LaunchAgent label을 CMDB에 기록하면 이후 장애 시 기대값과 즉시 비교할 수 있습니다. 여러 운영자가 같은 호스트를 쓰면 API 키 회전 책임(누가 생성·주입·검증하는지)을 문서화하세요.

전제: 계정, 포트, 정책

• 아웃바운드 HTTPS — 모델/채널 엔드포인트 도달성을 문서화.
• 로컬 바인딩 — 기본 127.0.0.1:18789; 공개는 nginx와.
• 사용자 컨텍스트 — CI/운영자와 동일 POSIX 사용자로 설치.

Node 고정(22 LTS vs 24)

최근 빌드는 Node 24 권장, Node 22.16+ 바닥선. fnm/nvm/pkg를 쓰더라도 IaC로 버전을 고정하고 node -v/npm -v를 아티팩트에 포함하세요.

node -v && npm -v && which node

SSH와 비대화

API 키를 먼저 export. 같은 셸에서 openclaw onboard를 실행하거나 0400 dotfile을 source. semver에 맞는 --yes류 플래그를 확인하세요.

CLI 설치(드리프트 방지)

프로덕션은 2026.4.x 같은 명시 버전. 첫 호스트만 @latest로 두지 마세요.

npm install -g openclaw@2026.4.15

openclaw onboard --install-daemon

모델 선택, 워크스페이스 기본값, 데몬 설치를 진행합니다. ACL이 필요하면 먼저 ~/.openclaw를 소유권에 맞게 만드세요. 완료 후 ~/Library/LaunchAgents plist(예 ai.openclaw.gateway, 버전마다 다름)를 확인합니다.

신호	정상	비정상
종료 코드	0 + 요약	비영·EACCES
파일	plist+로그	LaunchAgents 누락
포트	curl 성공	오래된 프로세스 충돌

launchd 검증·중복

launchctl bootstrap gui/$UID … 패턴으로 부트스트랩 후 즉시 openclaw doctor. 중복 복구 참고. unload 없이 재 onboard하면 plist가 쌓입니다.

헬스·로그·nginx 순서

준비 프로브로 127.0.0.1이 HTTP 200이 될 때까지 대기 후 nginx TLS 종료. 첫 핸드셰이크는 ~/.openclaw/logs(OPENCLAW_STATE_DIR에 따라 다름)를 tail.

관련·플릿 스케일

첫 노드가 안정되면 요금으로 보조 리전에 복제. 한 대에 야간 Xcode와 상시 AI를 몰아넣지 마세요. 메시는 Tailscale. 컨테이너는 Docker vs 네이티브.

Teams comparing terminal agents: see our Codex CLI vs Claude Code M4 벤치마크 (임대 빌더에서 Terminal-Bench 77.3% 대 65.4%).

FAQ

질문	답
tmux에서 onboard?	가능 — 환경 블록을 동일하게 로드.
18789 충돌?	구 게이트웨이 중지·plist unload·doctor·nginx upstream 기록.
Docker가 쉬움?	트레이드오프. 비교 참고. 본문은 npm 네이티브.

결론:Node·npm semver를 고정하고, SSH 전에 비밀을 export, 한 번 깨끗이 데몬 설치, doctor+curl 검증 후 하드닝.