Openclaw Docker 설치 및 Gemini 연동 & 디스코드 봇 설정

참고 자료: https://blog.leenit.kr/install-openclaw-with-docker/

요즘 핫한 OpenClaw, Docker로 5분 만에 시작하기

OpenClaw는 개인용 AI 어시스턴트 플랫폼으로, WhatsApp, Telegram, Slack, Discord 등 다양한 메시징 플랫폼과 통합되어 작동합니다.

GitHub에서 빠르게 성장하고 있는 오픈소스 프로젝트입니다.

 

이 글에선 OpenClaw를 Docker로 설치하는 방법을 작성합니다.

윈도우로 진행하며 환경은 WSL2 버전을 권장합니다.

1. Docker Desktop 설치

공식 웹사이트에서 다운로드 합니다.

 

2. Docker Compose 확인

docker compose version

3. 디스크 공간 확보

• Docker 이미지와 로그를 위한 최소 5GB 이상의 여유 공간 필요
• 권장: 10GB 이상

4. 레포지토리 클론

# OpenClaw 리포지토리 클론
git clone https://github.com/openclaw/openclaw.git
cd openclaw

 

5. 자동 설치 스크립트 실행

./docker-setup.sh

이 스크립트는 다음 작업을 자동으로 수행합니다

1. Gateway 이미지 빌드
2. 온보딩 마법사 실행
3. 프로바이더 설정 힌트 출력
4. Docker Compose를 통한 Gateway 시작
5. Gateway 토큰 생성 및 .env 파일에 저장

6. Openclaw 설정

온보딩 마법사가 자동으로 실행될 겁니다.

알맞는 설정을 하고 연결 LLM은 Google을 선택 후 API 키를 넣어주세요.

 

7. Openclaw URL 접속

OpenClaw gateway가 실행 되며 토큰이 포함된 URL로 접속하면 다음과 같은 화면이 뜰겁니다.

해결 방법

docker compose run --rm openclaw-cli devices list
docker compose run --rm openclaw-cli devices approve --latest

 

토큰을 잊어버렸다면?

docker compose run --rm openclaw-cli dashboard --no-open

 

접속 성공 화면

 

자주 쓰는 명령어

# Gateway 시작
docker compose up -d openclaw-gateway

# Gateway 중지
docker compose stop openclaw-gateway

# Gateway 재시작
docker compose restart openclaw-gateway

# 모든 컨테이너 중지
docker compose down

# 로그 실시간 확인
docker compose logs -f openclaw-gateway

# CLI 명령어 실행
docker compose run --rm openclaw-cli [command]