coollabsio/openclaw

해결하는 문제

OpenClaw 에이전트 게이트웨이를 프로덕션 환경에서 실행하는 것은 번거롭습니다. 리버스 프록시, 웹 인터페이스, 브라우저 세션 공유 방법, 영구 스토리지, 그리고 안전한 샌드박스 환경이 필요하기 때문입니다. 이 프로젝트는 이 모든 것을 단일 Docker 이미지와 compose 파일로 패키징하여, 게이트웨이를 빠르게 실행하고 브라우저나 Mac 앱을 페어링하며 업데이트 후에도 데이터를 유지할 수 있도록 합니다.

작동 방식

이 이미지는 환경 변수를 읽고 openclaw.json 설정을 작성하며 doctor --fix를 실행하고, 8080 포트에서 nginx를 리버스 프록시로 시작하며, 게이트웨이 프로세스(내부적으로 18789 포트 리슨)를 실행하는 엔트리포인트 스크립트를 부팅합니다. nginx는 UI 및 WebSocket에 대한 HTTP 기본 인증을 처리하고, 인증 없이 /healthz를 전달합니다. /data의 영구 볼륨은 설정, 채팅 기록, 페어링된 장치 및 작업 공간을 저장합니다. docker compose로 시작할 수 있는 선택적 브라우저 사이드카(CDP + VNC)를 사용하면 OAuth/2FA가 필요한 사이트에 로그인할 수 있으며, 게이트웨이는 CDP를 통해 해당 세션을 재사용합니다. 도구 실행은 호스트 Docker 소켓을 마운트하여 게이트웨이가 형제 컨테이너를 생성하도록 함으로써 샌드박스화할 수 있습니다. README는 이것이 컨테이너에 호스트의 root 권한을 부여한다는 점을 명확히 경고합니다.

대상 사용자

OpenClaw AI 에이전트 게이트웨이를 자체 호스팅하려는 모든 사용자. 간단한 docker run을 통한 단일 컨테이너 구성, 브라우저 사이드카와 webhook이 포함된 전체 docker compose 설정, 또는 Coolify 배포 등 어떤 방식이든 가능합니다. 또한 연결할 원격 게이트웨이가 필요한 OpenClaw Mac 앱 사용자에게도 적합합니다.

주요 특징

• 최소 설정을 위한 단일 컨테이너 docker run; docker compose를 통해 브라우저 사이드카 및 webhook 훅 추가 가능.
• 기본 인증, 상태 확인 엔드포인트, 구성 가능한 허용 오리진을 갖춘 nginx 리버스 프록시.
• 다양한 AI 제공업체(Anthropic, OpenAI, Gemini, DeepSeek 등)를 위한 환경 변수 구성 및 자동 기본 모델 선택.
• 영구 /data 볼륨을 통해 컨테이너 재생성 후에도 자격 증명, 페어링, 기록 및 작업 공간 유지.
• 최초 로그인 장치 승인: openclaw devices list 및 openclaw devices approve를 통해 브라우저나 Mac 앱 승인.
• 도구 실행용 형제 컨테이너를 실행하기 위한 선택적 Docker 소켓 샌드박스화(보안 영향에 대한 명확한 경고 포함).
• GitHub Actions를 통한 자동 이미지 빌드 및 Docker Hub로의 새 버전 게시, Coolify에서의 간편한 업데이트 경로.