--- title: "Docker Compose로 OpenClaw 실행하기 · DotsAgent" description: "Docker Compose로 OpenClaw를 실행하세요. 설정 스크립트, 대시보드, 영구 데이터 저장 및 업데이트 방법을 안내합니다. 로컬에서 이미지를 빌드하려면 RAM이 6 GB 이상 필요합니다. 사전 빌드 이미지를 사용하면 이 과정을 생략할 수 있습니다." url: https://dotsagent.io/ko/openclaw/docker --- OpenClaw 가이드 · 4단계 # Docker에서 OpenClaw 실행하기 소스에서 빌드하거나 사전 빌드된 ghcr.io/openclaw/openclaw 이미지를 가져와 게이트웨이와 CLI를 Docker Compose 서비스로 실행합니다. Git과 Compose가 포함된 Docker가 필요합니다. 이미지를 로컬에서 빌드하려면 RAM이 최소 6 GB 필요하므로, 사양이 낮은 호스트에서는 사전 빌드 이미지를 사용하세요. 1. 저장소를 clone하고 설정 스크립트 실행하기 저장소의 설정 스크립트가 Compose 서비스를 준비합니다. 로컬 빌드를 건너뛰려면 스크립트를 실행하기 전에 OPENCLAW_IMAGE=ghcr.io/openclaw/openclaw:latest를 export하세요. Docker Hub에도 openclaw/openclaw라는 이름으로 미러 이미지가 게시되어 있습니다. shell`git clone https://github.com/openclaw/openclaw.git cd openclaw ./scripts/docker/setup.sh` 2. 대시보드 열기 이 명령은 대시보드 명령을 위해 CLI 컨테이너를 한 번 실행합니다. --no-open은 컨테이너 안에서 브라우저를 실행하지 않도록 합니다. 다른 CLI 명령도 같은 방식으로 실행할 수 있습니다. 예: docker compose run --rm openclaw-cli channels add --channel telegram --token "". shell`docker compose run --rm openclaw-cli dashboard --no-open` 3. 데이터 유지 및 호스트 사양 설정하기 openclaw.json과 에이전트 작업공간을 포함한 OpenClaw 상태 데이터는 이름이 지정된 볼륨이나 bind mount에 저장하세요. 그래야 컨테이너를 다시 빌드하거나 업데이트해도 데이터가 유지됩니다. 직접 이미지를 빌드한다면 RAM을 최소 6 GB 할당하세요. 사전 빌드 이미지와 클라우드 모델을 사용하면 게이트웨이는 1 GB부터 실행할 수 있습니다. 컨테이너 내부에서 gateway.bind의 auto는 0.0.0.0으로 해석되므로 토큰 인증을 계속 사용하세요. 4. 컨테이너 업데이트하기 게이트웨이와 CLI 서비스의 새 이미지를 모두 가져온 다음 게이트웨이만 다시 생성하세요. 설정과 작업공간은 볼륨에 그대로 유지됩니다. shell`docker compose pull openclaw-gateway openclaw-cli docker compose up -d openclaw-gateway` 게이트웨이는 컨테이너 내부에서 0.0.0.0을 수신하므로, 18789:18789와 같이 포트를 매핑하면 모든 호스트 인터페이스에 포트가 공개됩니다. 대신 127.0.0.1:18789:18789로 매핑하세요. ## 더 많은 OpenClaw 가이드 [OpenClaw 설치](https://dotsagent.io/ko/openclaw/install) [VPS에서 OpenClaw 실행](https://dotsagent.io/ko/openclaw/vps) [Raspberry Pi에서 OpenClaw 실행하기](https://dotsagent.io/ko/openclaw/raspberry-pi) [모델을 OpenClaw에 연결](https://dotsagent.io/ko/openclaw/models) [OpenClaw를 Telegram에 연결](https://dotsagent.io/ko/openclaw/telegram) [OpenClaw gateway 보안 강화하기](https://dotsagent.io/ko/openclaw/hardening) [OpenClaw 원격 접속](https://dotsagent.io/ko/openclaw/remote-access) ## 출처 1. [docs.openclaw.ai](https://docs.openclaw.ai/install/docker)/install/docker AI 에이전트를 만드는 개발자를 위한 독립적인 참고 자료입니다. 여기에 언급된 어떤 업체와도 제휴 관계가 없습니다. © 2026 DotsAgent · 정보 확인일: 2026년 10월 1일