설치 가이드

OpenClaw를 설치하는 방법을 단계별로 안내합니다.

시스템 요구사항

설치 전에 다음 요구사항을 확인하세요:

설치 방법

Desktop App 설치

가장 쉬운 방법입니다 - GUI 제공

1단계: 다운로드

openclaw.ai/download에서 운영체제에 맞는 설치 파일을 다운로드하세요.

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

다음 단계:

• 기본 개념 - Gateway, Session, Agent 이해
• 첫 메시지 - 첫 번째 메시지 보내기