이 글은 로컬 Mac 또는 MacCloud 전용 물리 인스턴스에 OpenClaw를 올리는 엔지니어를 위한 것입니다. 실행 → 장기 실행 → 클라우드와 정렬 순서로 설명하며, 명령과 버전은 사용 중인 OpenClaw 릴리스 노트를 따르고 여기서는 macOS에 맞는 기준선을 제시합니다.
1. 대상과 목표
CLI를 상주시키면서 가끔 GUI로 분석해야 한다면 macOS가 가장 매끄럽습니다. 공식 문서를 한 줄씩 옮기기보다 경로, 권한, 데몬을 한 번에 정리해 「로컬에서는 되는데 SSH에서는 실패」를 줄이는 것이 목표입니다.
2. 환경과 아키텍처
현재 안정판 macOS와 Xcode Command Line Tools(xcode-select --install)를 준비하세요. Apple Silicon에서는 바이너리가 arm64인지, 팀의 Rosetta 정책과 맞는지 확인합니다. 아키텍처 혼용은 크래시나 dyld 오류로 자주 나타납니다.
3. CLI 설치와 PATH
실행 파일이나 패키지 관리자 경로를 ~/.zshrc 또는 ~/.bash_profile에 넣고 현재 세션에서 source로 검증합니다. 권한 상승이 필요한 전역 디렉터리는 피하세요. 전용 베어메탈에서 보안 경계를 직접 짊어지는 경우가 아니면 운영 부담이 커집니다.
4. 개인정보 보호, 자동화, 헤드리스
다른 앱 제어나 넓은 디스크 접근이 필요하면 시스템 설정 → 개인정보 보호 및 보안에서 전체 디스크 접근, 자동화 등을 최소한으로 허용합니다. 순수 SSH 헤드리스에는 launchd를 권장합니다. WorkingDirectory, 표준 출력 로그, 적절한 ThrottleInterval을 명시해 비정상 재시작이 CPU를 잡아먹지 않게 하세요.
5. MacCloud 인스턴스와 연동
클라우드에서 같은 단계를 반복할 때 콘솔에서 네트워크와 보안 그룹을 확인하세요. 비밀키를 저장소에 넣지 마세요. 배스천이나 단기 자격 증명을 사용합니다. 클라우드 실무는 시리즈의 MacCloud에서 OpenClaw 실행을 참고하세요.
6. 출시 전 체크리스트
- 로컬과 클라우드의 macOS / CPU 아키텍처 조합이 같은가요?
which openclaw(또는 동등)이 로그인 셸과 비대화형 SSH에서 같나요?- launchd와 수동 시작 모두 깔끔히 종료되고 로그에 재시작 루프가 없나요?
- 개인정보 권한을 첫 프롬프트에서 최소로 잡아 무인 실행이 대화상자에 막히지 않나요?
설치는 첫 단계일 뿐입니다. 파이프라인이나 스케줄에 넣을 때 GitHub Actions 연동과 자동화 오케스트레이션을 읽어 트리거, 시크릿, 관측 가능성을 맞추세요.
