docker-setup, .env·openclaw.json 설정, 기동·검증, CI 연동(GitHub Actions·스크립트 호출)까지 단계별로 정리했습니다. 따라 하면 동일 환경에서 재현할 수 있습니다.
사전 조건 및 환경
원격 Mac에 Docker 설치·리소스 충분 여부를 확인하세요.
| 항목 | 권장 |
|---|---|
| OS | macOS 12+(Monterey 이상). Apple Silicon·Intel. |
| Docker | Docker Desktop 또는 Engine + Compose v2. docker --version·docker compose version 확인. |
| 메모리 | 호스트 8GB RAM 이상. OpenClaw+CI 동시 시 16GB 권장. |
| 디스크 | 이미지·볼륨 20GB 이상. 모델 캐시 시 추가. |
선택: Git(클론), SSH/VNC(원격 설정).
Docker 배포 단계
아래 순서대로 진행하면 재현 가능한 배포가 가능합니다.
클론. OpenClaw 저장소를 Mac에 클론. 예: git clone ... && cd openclaw. CI에서 쓸 태그·커밋 지정.
docker-setup. docker-setup 또는 setup.sh가 있으면 루트에서 ./docker-setup 실행. 이미지 풀·네트워크·볼륨 생성 포함.
.env. .env.example → .env 복사 후 API 키·게이트웨이 URL·모델명·포트 설정. 시크릿은 버전 관리 제외.
openclaw.json. 모델 엔드포인트·타임아웃·게이트웨이 옵션을 환경에 맞게 조정.
기동·검증. docker compose up -d 후 헬스/상태 엔드포인트 또는 openclaw status·doctor로 확인.
게이트웨이 및 모델 설정
.env에 게이트웨이 URL·API 키를, openclaw.json에 모델 ID·프로바이더·타임아웃을 넣어 OpenClaw가 LLM·게이트웨이에 접근하도록 합니다. 예: OPENCLAW_GATEWAY_URL, 요청에 쓰는 모델명/ID, 일시 오류 시 CI 실패를 막기 위한 재시도·타임아웃 값. 수정 후 docker compose down && docker compose up -d로 재시작하고 검증 단계를 다시 실행하세요.
CI에서 OpenClaw 호출
OpenClaw 기동 후 CI는 HTTP 또는 CLI로 호출합니다.
Mac에 SSH하는 job(또는 해당 Mac의 self-hosted runner) 추가. job에서 openclaw 또는 curl로 API 호출. 호스트·인증은 GitHub Secrets에 저장.
Mac에 접근 가능한 러너에서 openclaw 또는 curl -X POST .../run 호출. 엔드포인트·키는 .env 또는 환경 변수로 통일.
권장: 체크아웃 → 의존성 설치(또는 OpenClaw 클라이언트 이미지) → OpenClaw 사전 풀/작업 → 빌드·테스트. Self-hosted runner면 Mac에 OpenClaw CLI 설치 후 Docker 서비스 URL 지정.
흔한 오류 및 점검
흔한 증상과 대응 요약.
| 증상 | 대응 |
|---|---|
| 컨테이너 종료·OOM | Docker 메모리 한도·호스트 RAM 증설. 병렬 워커 감소. |
| connection refused | .env·openclaw.json URL·포트·게이트웨이 기동·컨테이너 네트워크 확인. |
| CI 호출 타임아웃 | job 타임아웃·재시도 추가. Mac·네트워크 지연 확인. |
| 권한·경로 오류 | 볼륨·마운트 소유권. CI와 동일 사용자로 docker-setup. |
정리 및 다음 단계
정리하면 사전 조건(Mac·Docker·메모리/디스크) → 클론·docker-setup → .env·openclaw.json → 기동·검증 → CI 연동(GitHub Actions·스크립트) 순서로 재현할 수 있습니다. OpenClaw와 CI를 노트북 공유·스팟 인스턴스 없이 안정적으로 돌리려면 전용 원격 Mac(예: Mac Mini M4) SSH/VNC 대여를 권장합니다. 고정된 환경과 예측 가능한 성능을 얻을 수 있습니다. 블로그·홈·요금·구매(로그인 불필요)에서 MacPull 원격 Mac 노드를 선택해 OpenClaw·CI를 안정적으로 운영해 보세요.