OpenClaw Docker 설치 2026: NAS·홈서버·클라우드 AI 에이전트 운영

이 글에서 다루는 내용: Docker와 Docker Compose를 이용해 OpenClaw를 어떤 환경에서도 일관되게 배포하는 방법을 설명합니다. 시놀로지(Synology), 큐냅(QNAP) NAS, 홈서버(미니 PC), AWS/GCP/Azure 클라우드까지 하나의 설정으로 모든 환경에 배포할 수 있습니다.

Docker 방식의 장점

Docker는 OpenClaw를 배포하는 가장 강력하고 유연한 방법입니다. "한 번 작성하면 어디서든 실행된다"는 Docker의 철학처럼, 동일한 설정 파일로 NAS, 홈서버, 클라우드 어디에서나 동일하게 작동합니다.

Docker 방식 장점

환경 독립적 (OS 무관)
원클릭 업데이트/롤백
자동 재시작 정책
데이터 볼륨으로 설정 보존
여러 인스턴스 동시 실행

지원 환경

시놀로지 NAS (DSM 7.x)
큐냅 NAS (QTS 5.x)
미니 PC 홈서버
AWS/GCP/Azure
Hetzner/DigitalOcean VPS

Docker 설치하기

Ubuntu/Debian Linux

# Docker 공식 설치 스크립트
curl -fsSL https://get.docker.com | bash
sudo usermod -aG docker $USER
newgrp docker

# Docker Compose v2 설치
sudo apt-get install -y docker-compose-plugin

# 버전 확인
docker --version
docker compose version

macOS

# Homebrew로 Docker Desktop 설치
brew install --cask docker

# 또는 docker.com에서 Docker Desktop DMG 다운로드

Windows

docker.com에서 Docker Desktop for Windows를 설치합니다. WSL2 백엔드를 사용하는 것을 권장합니다.

winget install Docker.DockerDesktop

Docker Compose로 OpenClaw 배포

Docker Compose를 사용하면 설정 파일 하나로 OpenClaw를 쉽게 배포하고 관리할 수 있습니다.

프로젝트 폴더 생성

mkdir -p ~/openclaw-docker && cd ~/openclaw-docker
mkdir -p config data

환경변수 파일 (.env) 생성

API 키와 설정을 분리하여 보안을 강화합니다:

cat > .env << 'EOF'
# AI 모델 API 키 (하나 이상 입력)
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxx
OPENAI_API_KEY=sk-xxxxxxxxxxxx

# 텔레그램 봇 설정
TELEGRAM_BOT_TOKEN=your_telegram_bot_token
TELEGRAM_ALLOWED_IDS=your_telegram_user_id

# OpenClaw 설정
OPENCLAW_AGENT_NAME=Jarvis
OPENCLAW_PORT=18789
EOF

chmod 600 .env  # 보안 설정

docker-compose.yml 작성

cat > docker-compose.yml << 'EOF'
version: '3.9'

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    env_file: .env
    volumes:
      - ./config:/root/.openclaw
      - ./data:/workspace
    ports:
      - "18789:18789"
    networks:
      - openclaw-network
    healthcheck:
      test: ["CMD", "openclaw", "doctor"]
      interval: 30s
      timeout: 10s
      retries: 3

networks:
  openclaw-network:
    driver: bridge
EOF

컨테이너 시작

# 백그라운드로 시작
docker compose up -d

# 로그 확인
docker compose logs -f openclaw

# 상태 확인
docker compose ps

온보딩 (첫 설정)

# 컨테이너 내부에서 온보딩 실행
docker compose exec openclaw openclaw onboard

시놀로지(Synology) NAS에 설치하기

가정에 시놀로지 NAS가 있다면 이미 최고의 OpenClaw 서버를 가지고 있는 겁니다. 24시간 저전력으로 실행되며 여러분의 파일에 직접 접근할 수 있습니다.

🖥️ 시놀로지 Container Manager로 설치

Container Manager 설치

패키지 센터 → Container Manager 설치 (DSM 7.x 기준). 이전 버전은 Docker 패키지를 설치하세요.

SSH로 NAS 접속

DSM에서 SSH 활성화 후 터미널에서 접속: ssh admin@NAS_IP

docker-compose.yml 업로드 및 실행

위의 docker-compose.yml 파일을 NAS의 적절한 폴더에 저장하고 docker compose up -d 실행

Container Manager에서 확인

DSM 웹 UI의 Container Manager에서 openclaw 컨테이너 상태를 확인하고 로그를 모니터링합니다.

⚠️ 시놀로지 ARM 프로세서 기반 NAS(DS220+, DS720+ 등)도 지원합니다. 단, 고성능 모델(DS923+, DS1522+ 이상) 권장.

큐냅(QNAP) NAS에 설치하기

📦 큐냅 Container Station 활용

큐냅 NAS에서는 Container Station 앱을 통해 Docker 컨테이너를 관리합니다.

설치 순서

1. App Center → Container Station 설치
2. Container Station 실행 → Create → docker-compose.yml 업로드
3. 환경변수(.env 파일) 설정
4. 컨테이너 시작 및 모니터링

# 또는 SSH로 접속 후 CLI 방식
ssh admin@QNAP_IP
cd /share/Container/openclaw
docker compose up -d

Docker 컨테이너 관리 명령어 모음

🛠️ 자주 사용하는 Docker Compose 명령어

# 컨테이너 시작/중지/재시작
docker compose up -d          # 백그라운드 시작
docker compose down           # 중지 및 제거
docker compose restart        # 재시작

# 로그 확인
docker compose logs -f        # 실시간 로그
docker compose logs --tail=50 # 최근 50줄

# 컨테이너 내부 접속
docker compose exec openclaw bash

# OpenClaw 업데이트 (최신 이미지로)
docker compose pull
docker compose up -d --force-recreate

# 상태 확인
docker compose ps
docker stats openclaw          # 리소스 사용량

# 설정 파일 확인
docker compose config

# 완전 정리 (데이터 포함)
docker compose down -v

Watchtower로 자동 업데이트 설정

Watchtower는 Docker 이미지가 업데이트될 때 자동으로 컨테이너를 재시작해주는 도구입니다. OpenClaw의 새 버전이 출시되면 자동으로 업데이트됩니다.

🔄 Watchtower 추가 설정

docker-compose.yml에 Watchtower 서비스를 추가합니다:

  watchtower:
    image: containrrr/watchtower
    container_name: watchtower
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - WATCHTOWER_POLL_INTERVAL=86400    # 24시간마다 확인
      - WATCHTOWER_CLEANUP=true           # 구버전 이미지 자동 삭제
      - WATCHTOWER_INCLUDE_STOPPED=false
    command: openclaw  # openclaw 컨테이너만 감시

다중 인스턴스 실행 (고급)

Docker의 가장 강력한 장점 중 하나는 여러 OpenClaw 인스턴스를 동시에 실행할 수 있다는 것입니다. 업무용, 개인용, 테스트용 등 목적에 따라 다른 설정의 AI 비서를 운영할 수 있습니다.

🤖 2개의 OpenClaw 동시 실행 예시

version: '3.9'
services:
  # 업무용 Claude 기반 AI 비서
  openclaw-work:
    image: openclaw/openclaw:latest
    container_name: openclaw-work
    restart: unless-stopped
    environment:
      - ANTHROPIC_API_KEY=${WORK_API_KEY}
      - TELEGRAM_BOT_TOKEN=${WORK_BOT_TOKEN}
    volumes:
      - ./work-config:/root/.openclaw
    ports:
      - "18789:18789"

  # 개인용 로컬 LLM 기반 AI 비서
  openclaw-personal:
    image: openclaw/openclaw:latest
    container_name: openclaw-personal
    restart: unless-stopped
    environment:
      - OLLAMA_BASE_URL=http://host.docker.internal:11434
      - TELEGRAM_BOT_TOKEN=${PERSONAL_BOT_TOKEN}
    volumes:
      - ./personal-config:/root/.openclaw
    ports:
      - "18790:18789"  # 다른 포트 사용

Docker 자주 발생하는 문제 & 해결법

🔴 컨테이너가 계속 재시작됩니다 (CrashLoopBackOff)

docker compose logs openclaw로 에러 메시지를 확인합니다. 주로 API 키가 올바르지 않거나, .env 파일이 없거나, 포트 충돌이 원인입니다. 포트 18789가 이미 사용 중이라면 다른 포트로 변경하세요.

🟡 시놀로지 NAS에서 이미지 pull 실패

Docker Hub 접근이 차단된 경우 발생합니다. VPN07을 NAS에 설정하거나, 미러 레지스트리를 사용합니다. DSM 설정에서 프록시를 설정하는 방법도 있습니다.

🔵 볼륨 마운트 후 권한 오류

config 폴더의 권한을 올바르게 설정합니다: sudo chown -R 1000:1000 ./config ./data. 또는 docker-compose.yml에서 user: "1000:1000"을 명시합니다.

🟢 컨테이너 내부에서 API 연결 실패

Docker 네트워크 DNS 설정 문제일 수 있습니다. docker-compose.yml에 dns: [8.8.8.8, 1.1.1.1]을 추가해보세요. 또는 VPN07을 호스트 시스템에 설치하고 컨테이너가 호스트 네트워크를 사용하도록 설정합니다.

Docker + VPN07 조합으로 최적의 AI 인프라

Docker 컨테이너 내의 OpenClaw도 해외 AI API와 지속적으로 통신합니다. 특히 NAS나 홈서버에서 운영할 때 안정적인 해외 연결이 필수입니다. VPN07을 호스트 또는 라우터 레벨에서 설정하면 모든 컨테이너가 자동으로 안정적인 연결을 사용합니다.

🥇

VPN07

9.8/10

950Mbps

실측 속도

20ms

API 지연

70+

국가

$1.5/월

월정액

✅ 1000Mbps 기가급 회선 · IEPL 전용선 · 10년 이상 안정적 운영 · 30일 환불 보장

🥈 B VPN 서비스

7.0/10

속도: 270Mbps

지연: 82ms

가격: $6.99/월

🥉 C VPN 서비스

6.1/10

속도: 130Mbps

지연: 145ms

가격: $5.99/월

자주 묻는 질문 (FAQ)

Q. Docker 이미지를 직접 빌드해야 하나요?

아니요. OpenClaw 공식 Docker 이미지를 Docker Hub에서 바로 pull할 수 있습니다. docker pull openclaw/openclaw:latest 명령어로 최신 버전을 가져옵니다. 소스에서 빌드하고 싶다면 GitHub에서 Dockerfile을 받아 직접 빌드할 수도 있습니다.

Q. 컨테이너를 재시작하면 설정이 초기화되나요?

볼륨 마운트를 올바르게 설정했다면 초기화되지 않습니다. ./config:/root/.openclaw 마운트를 통해 OpenClaw의 모든 설정, 메모리, 스킬이 로컬 디스크에 영구적으로 저장됩니다. 컨테이너를 삭제하고 다시 시작해도 동일한 상태로 복구됩니다.

Q. 시놀로지 NAS의 최소 사양은 어떻게 되나요?

RAM 4GB 이상의 시놀로지 NAS를 권장합니다. DS220+, DS720+, DS923+ 등 Intel 또는 AMD 프로세서가 탑재된 모델이 최적입니다. ARM 기반 모델(DS218, DS420j 등)도 실행은 되지만 성능이 제한적입니다. 로컬 LLM 모델 실행 없이 API 모드로만 사용한다면 최소 사양으로도 충분합니다.

Q. OpenClaw 업데이트 방법은?

Watchtower를 사용하면 자동으로 업데이트됩니다. 수동으로 업데이트하려면 docker compose pull && docker compose up -d --force-recreate 명령어를 실행하면 됩니다. 기존 설정과 데이터는 볼륨에 보존되어 업데이트 후에도 그대로 유지됩니다.

Q. OpenClaw Docker 이미지는 얼마나 큰가요?

기본 이미지는 약 500MB~1GB 수준입니다. 처음 pull 시 시간이 다소 걸리지만 이후에는 레이어 캐싱으로 업데이트가 빠릅니다. 로컬 LLM 모델은 별도로 마운트하므로 이미지 크기에 영향을 주지 않습니다.

VPN07 - 홈서버·NAS AI 에이전트 전용 VPN

Docker AI 인프라 최적화 1000Mbps 기가급 IEPL 전용선