OpenClaw: Gemini 2.5 + Docker 완벽 배포 가이드

[cite_start]이 가이드는 Windows 환경에서 직접 실행(Native)하며 설정을 완료한 뒤, 발생할 수 있는 권한 오류(Permission Denied)를 해결하여 Docker에 최종 배포하는 과정을 담고 있습니다. [cite: 1, 6, 230, 235]

---

1. 로컬 환경 준비 (Windows)

[cite_start]Docker에 올리기 전, Windows에서 직접 실행하여 기본 설정 파일(.openclaw)을 생성해야 합니다. [cite: 4, 193]

1. [cite_start]필수 설치: Git, Node.js 22버전 이상, Docker Desktop을 설치합니다. [cite: 2, 3, 5]
2. [cite_start]작업 폴더 생성: C:\OpenClawWorkspace 폴더를 생성합니다. [cite: 7]
3. 소스 다운로드 및 이동:

   cd C:\OpenClawWorkspace
   git clone [https://github.com/openclaw/openclaw.git](https://github.com/openclaw/openclaw.git)
   cd openclaw
   ``` [cite: 8, 9, 10]

4. 종속성 설치:

   npm install -g pnpm
   pnpm install
   ``` [cite: 228]

---

2. Onboarding (모델 및 슬랙 설정)

[cite_start]터미널에서 직접 봇을 실행하며 Gemini API와 Slack을 연동합니다. [cite: 52, 100]

1. [cite_start]온보딩 실행: npx openclaw onboard를 입력합니다. [cite: 229]
2. 모델 설정:
   • [cite_start]Provider: Google 선택 [cite: 50]
   • [cite_start]API Key: Google AI Studio에서 발급받은 키 입력 [cite: 56, 75]
   • [cite_start]Model: google/gemini-2.5-flash 선택 (최신 모델 권장) [cite: 87, 96]
3. 슬랙 설정:
   • [cite_start]Slack (Socket Mode) 선택 [cite: 100, 110]
   • [cite_start]슬랙 API 콘솔에서 발급받은 Bot Token(xoxb)과 App Token(xapp) 입력 [cite: 180, 182, 183]

---

3. Docker 배포 (권한 문제 해결 핵심)

[cite_start]Windows에서 생성된 설정을 Docker 이미지 내부로 박제(Build)하여 리눅스 권한 충돌을 방지합니다. [cite: 232, 235]

1. 설정 파일 복사: Windows 사용자 폴더의 설정을 작업 폴더로 가져옵니다.

   xcopy /e /i C:\Users\admin\.openclaw C:\OpenClawWorkspace\openclaw\.openclaw
   [cite_start]``` [cite: 231, 232]

2. Dockerfile 수정: Dockerfile의 USER node 직전 라인에 아래 내용을 추가합니다.

   # 설정 파일 복사 및 소유권 부여 (Permission Denied 방지)
   COPY --chown=node:node .openclaw /home/node/.openclaw

3. 이미지 빌드 및 실행

docker build -t openclaw-app-final .
docker run -d --name openclaw-bot openclaw-app-final node scripts/run-node.mjs gateway --allow-unconfigured
``` [cite: 232, 235]

4. 주요 시행착오 및 해결 (Troubleshooting)

❌ 에러: EPERM: operation not permitted

원인: Docker 볼륨 기능(-v)으로 Windows 폴더를 직접 연결 시, 리눅스 내부 권한(chmod) 변경이 불가능함.

해결: 빌드 시 COPY --chown=node:node를 사용하여 파일 제어권을 Docker 내부 node 사용자에게 완전히 넘겨줌.

❌ 에러: access not configured (슬랙 메시지)

원인: 봇 사용 승인이 필요함.

해결: 슬랙이 출력한 페어링 코드를 복사하여 아래 명령어 입력:

DOS
docker exec openclaw-bot npx openclaw pairing approve slack [페어링코드]

## 5. 최종 확인

docker ps를 입력하여 openclaw-bot 컨테이너의 상태가 Up인지 확인합니다.  이제 터미널을 꺼도 봇은 24시간 작동합니다!