설치 가이드
OpenClaw를 설치하는 방법을 단계별로 안내합니다.
시스템 요구사항
설치 전에 다음 요구사항을 확인하세요:
| 항목 | 최소 요구사항 |
|---|---|
| 운영체제 | Linux, macOS, Windows 10+ |
| Node.js | v22.0.0 이상 |
| RAM | 최소 512MB (권장 2GB) |
| 디스크 | 최소 1GB 여유 공간 |
| 네트워크 | 인터넷 연결 필요 |
설치 방법
Desktop App 설치
가장 쉬운 방법입니다 - GUI 제공
1단계: 다운로드
openclaw.ai/download에서 운영체제에 맞는 설치 파일을 다운로드하세요.
| 운영체제 | 파일 형식 |
|---|---|
| Windows | .msi 또는 .exe |
| macOS | .dmg |
| Linux | .AppImage 또는 .deb |
2단계: 설치
# macOS의 경우
open OpenClaw.dmg
# → Applications 폴더로 드래그
# Linux의 경우 (AppImage)
chmod +x OpenClaw.AppImage
./OpenClaw.AppImage
3단계: 초기 설정
앱 실행 후 설정 마법사를 통해 API 키와 채널을 설정합니다.
Docker로 설치
서버 환경에 적합한 방법입니다
1단계: Docker 이미지 가져오기
docker pull openclaw/gateway:latest
2단계: 설정 파일 준비
mkdir -p ~/.openclaw
cat > ~/.openclaw/openclaw.json << 'EOF'
{
"agents": {
"defaults": {
"model": "claude-sonnet-4-20250514"
}
},
"channels": {
"telegram": {
"enabled": true,
"botToken": "YOUR_TELEGRAM_BOT_TOKEN"
}
}
}
EOF
3단계: 컨테이너 실행
docker run -d \
--name openclaw-gateway \
-p 3000:3000 \
-v ~/.openclaw:/app/.openclaw \
-e ANTHROPIC_API_KEY="sk-ant-..." \
openclaw/gateway:latest
Docker Compose 사용 (권장)
# docker-compose.yml
version: '3.8'
services:
openclaw:
image: openclaw/gateway:latest
ports:
- "3000:3000"
volumes:
- ~/.openclaw:/app/.openclaw
environment:
- ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
- TELEGRAM_BOT_TOKEN=${TELEGRAM_BOT_TOKEN}
restart: unless-stopped
# 실행
docker-compose up -d
CLI로 설치
개발자에게 적합한 방법입니다
1단계: Node.js 설치 확인
node --version # v22.0.0 이상 필요
npm --version
2단계: OpenClaw CLI 설치
# npm으로 전역 설치
npm install -g @openclaw/cli
# 또는 설치 스크립트 사용 (권장)
curl -fsSL https://install.openclaw.ai | sh
3단계: 설치 확인
openclaw --version
# 출력: openclaw/1.x.x linux-x64 node-v22.x.x
4단계: 초기 설정
# 설정 마법사 실행
openclaw config init
# API 키 설정
openclaw config set models.providers.anthropic.apiKey "sk-ant-..."
# 채널 설정 (예: Telegram)
openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.botToken "123456:ABC..."
5단계: Gateway 시작
openclaw gateway start
설치 후 확인
설치가 완료되면 다음을 확인하세요:
# 1. Gateway 상태 확인
openclaw gateway status
# 2. 설정 파일 확인
openclaw config get
# 3. 채널 연결 테스트
openclaw channel test --type telegram
정상 출력 예시:
Gateway Status: Running
PID: 12345
Uptime: 0 minutes
Channels: 1 active (Telegram)
문제 해결
"command not found: openclaw" 오류
# PATH에 npm 전역 설치 경로 추가
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Node.js 버전이 낮은 경우
# nvm으로 Node.js 업그레이드
nvm install 22
nvm use 22
포트 충돌 오류
# 다른 포트 사용
openclaw gateway start --port 3001
다음 단계: