Docker에서 OpenClaw 실행하기

소스에서 빌드하거나 사전 빌드된 ghcr.io/openclaw/openclaw 이미지를 가져와 게이트웨이와 CLI를 Docker Compose 서비스로 실행합니다.

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 "<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

더 많은 OpenClaw 가이드