렌탈 Mac mini에서의 OpenClaw 설정 버전 관리와 GitOps(2026)
많은 팀이 데스크톱급 자동화에 가장 잘 맞는 기판으로 macOS를 쓰기 때문에 OpenClaw를 전용 Mac mini M4(HK, JP, KR, SG, US)에서 돌립니다. 그런데 첫 설치가 성공한 뒤에도 남는 실패 모드는 더 조용합니다: 설정 드리프트입니다. 금요일에 누군가 게이트웨이 라우트를 손보고 diff를 남기지 않으면, 월요일 장애 리뷰에서는 추적되지 않은 JSON 편집 대신 「클라우드 업체 탓」이 됩니다. OpenClaw의 선언적 표면을 Git 브랜치·태그·승격 게이트와 함께 인프라 코드처럼 다루면, 200노드 쿠버네티스 플릿인 척하지 않고도 렌탈 mini에 기대하던 롤백 스토리를 얻을 수 있습니다.
이 2026 가이드에서는 무인 mini에 GitOps가 맞는 이유, 저장소에 둘 디렉터리와 디스크 전용 영역, 4환경 매트릭스(노트북, 스테이징 mini, 프로덕션 mini, 웜 스페어), 7단계 부트스트랩, 그리고 LaunchAgent 복구와 짝을 이루는 롤백 훈련을 설명합니다. 시크릿은 Keychain 가이드에 두고, Git에는 의도만 담고 베어러 토큰은 넣지 않습니다.
바이너리가 기본값을 실어 오는데도 OpenClaw 설정을 버전 관리하는 이유
기본값은 0일 차에 도움이 되지만, 엔지니어 세 명이 mini 하나를 쓰는 60일 차에는 부족합니다. 버전 관리는 보안 검토자에게 감사 추적을, 리전 간 diff 가능한 승격 경로를, MCP 허용 목록이나 웹훅 경로가 부하 아래 바뀔 때의 타임머신을 줍니다.
- 컴플라이언스: 「4월 3일에 무엇이 바뀌었나요?」라는 질문에 Git이 몇 초 만에 답합니다.
- 멀티 리전 대칭: 호스트명을 제외하고는
prod-hk와prod-sg브랜치를 맞춰 둡니다. - 스케줄과 짝: LaunchAgent 작업은 환경 변수를 읽습니다—Git은 그 변수가 어떤 스냅샷과 맞아야 하는지를 문서화합니다.
파일이 사는 곳: 저장소 vs 런타임 vs 시크릿
OpenClaw는 macOS에서 흔히 ~/.openclaw/ 아래 사용자 범위 레이아웃에 운영 상태를 둡니다. 모든 바이트가 Git에 들어갈 필요는 없습니다. 선별한 조각—게이트웨이 리스너 블록, MCP 서버 매니페스트, 로그 레벨, 기능 플래그—만 커밋하세요. 캐시, 기기 페어링 블롭, 내려받은 모델, 한 호스트에만 맞는 절대 경로(템플릿하지 않는 한)는 제외합니다.
{{REGION}}이나 {{MINI_HOSTNAME}} 자리 표시자를 두고, SSH로 돌리는 작은 배포 스크립트로 렌더링하세요—같은 커밋이 JP와 US로 승격될 때 수동 찾아바꾸기가 필요 없습니다.
4환경 승격 표
| 표면 | Git 브랜치 모델 | 검증 게이트 |
|---|---|---|
| 엔지니어 노트북(드라이런) | feature/* | openclaw doctor + 단위 픽스처 |
| 스테이징 mini | develop | 웹훅 리플레이 + MCP 스모크 목록 |
| 프로덕션 mini | main + 시맨틱 버전 태그 | 2인 검토 + 유지보수 창 |
| 웜 스페어 mini | 프로덕션과 동일 태그 | 월간 자동 동기 작업 |
7단계 GitOps 부트스트랩
- 비공개 저장소를 만듭니다—README에 배포가 허용된 mini 계정을 정확히 적습니다.
.gitignore를 추가합니다—토큰, plist보내기, 크래시 로그를 제외합니다.- 알려진 양호한
openclaw doctor실행 직후 라이브 게이트웨이 조각을 스냅샷하고v1.0.0-baseline으로 태그합니다. - pull 스크립트를 연결합니다—저장소 → 라이브 설정 디렉터리로
rsync --checksum을 쓰고, mini에서 작업 트리가 더러우면 실행을 거부하게 합니다. - LaunchAgent와 통합합니다—PATH와
TMPDIR가 트러블슈팅 기대와 일치하게 합니다. - 승격을 SIEM에 기록합니다—커밋 SHA, 운영자 SSH 주체, 리전을 함께 남깁니다.
- 아래 롤백 훈련으로 분기별 리허설을 합니다.
# .gitignore 발췌 예시
**/tokens.json
**/*.pem
**/Library/Logs/OpenClaw/**
.DS_Store
롤백 훈련: 10분 안에 되돌릴 수 있음을 증명하세요
테이블탑 연습을 일정에 넣습니다—무해하지만 잘못된 로그 레벨을 의도적으로 배포하고 지연 영향을 기록한 뒤, 이전 태그를 git checkout하고 pull 스크립트를 다시 돌리고 openclaw doctor를 실행한 다음, 복구 글에 나온 대로 launchctl kickstart -k로 게이트웨이를 재시작합니다. 한 유지보수 창 안에 끝내지 못하면 GitOps 이야기는 아직 소설입니다.
bootout을 동시에 하지 마세요—구조용 복구 셸을 쥔 두 번째 운영자가 있을 때만, 게이트웨이 재시작 가이드의 권고와 같습니다.
웹훅, MCP, 가격으로의 다리
HTTP 인그레스는 웹훅 강화와, 도구 표면은 MCP 설정과, 동시 실행 상한은 병렬 에이전트 글과 맞춥니다. 거버넌스가 단단해지면 가격 페이지로 리전을 맞추고, 저장소 README에는 헬프 센터 링크를 붙여 사람이 묻는 길을 정합니다.
FAQ
OpenClaw 홈 디렉터리 전체를 Git에 두어야 하나요? 아니요—선별한 조각만 커밋하고 캐시, 페어링된 기기 메타데이터, 토큰은 무시합니다. LaunchAgent EnvironmentVariables가 체크인 스냅샷과 맞아야 한다고 문서화해 launchd와 Git이 조용히 어긋나지 않게 하세요.
잘못된 승격 뒤에 어떻게 롤백하나요? 마지막 주석 태그를 체크아웃하고 파일을 라이브 설정 경로에 다시 맞춘 뒤 openclaw doctor를 실행하고, 게이트웨이 복구 글의 안전한 kickstart 순서로 LaunchAgent를 재시작합니다—가능하면 두 번째 SSH 세션에서 하세요.
GitOps가 API 키의 Keychain 저장을 대체하나요? 아니요—Git에는 구조만 두고 시크릿은 Keychain이나 볼트에 둡니다. CI가 실수로 .env를 커밋하지 않도록 시크릿 글을 따르세요.
Git으로 추적하는 자동화에 ProxyMac Mac mini가 여전히 이기는 이유
Apple Silicon 전용 HK / JP / KR / SG / US 호스트는 게이트웨이 프로세스와 Git 작업에 예측 가능한 CPU를 주고 이웃 소음이 적습니다. ProxyMac으로 빌리면 법무가 이미 승인한 지리에 인프라 커밋을 고정하고, 증거를 가격 옆에 붙인 뒤 자동화 프로그램이 끝나면 호스트를 회수할 수 있으며, 접근과 과금 질문의 정식 입구는 도움말로 둡니다.
