OpenClaw
시작하기8 분 소요

OpenClaw 빠른 시작: 30분 만에 처음부터 작동까지

모델 키 준비부터 첫 번째 응답 수신까지, 설치, 구성, 상태 확인 및 일반적인 시작 실패 해결 방법을 다룹니다.

O

OpenClaw Guides

Tutorial Authors

1. 사전 요구 사항

OpenClaw를 설치하기 전에 시스템이 다음 요구 사항을 충족하는지 확인하세요:

  • Node.js 22 이상 (LTS 권장)
  • npm 또는 pnpm 패키지 관리자
  • 안정적인 인터넷 연결

Node.js 버전 확인:

bash
node --version
# v22.x.x 이상이 출력되어야 합니다

2. 한 줄 설치

터미널을 열고 실행:

bash
curl -fsSL https://openclaw.ai/install.sh | bash

설치 스크립트가 자동으로 시스템 환경을 감지하고 모든 구성을 완료합니다.

대안: npm 사용

npm을 직접 사용하려면:

bash
# OpenClaw를 전역으로 설치
npm install -g openclaw@latest

# 온보딩 마법사 시작
openclaw onboard

3. 초기 구성

설치 후 구성 마법사 실행:

bash
openclaw onboard

마법사가 다음을 안내합니다:

  1. API 키 설정 - Anthropic API 키 입력
  2. 기본 모델 선택 - Claude 3.5 Haiku, Claude 3.5 Sonnet 또는 Claude Sonnet 4 중 선택
  3. 채팅 플랫폼 연결 - WhatsApp, Telegram 또는 Discord 연결

4. Gateway 서비스 시작

OpenClaw Gateway 실행:

bash
openclaw gateway start

다음과 같은 출력이 표시됩니다:

🦞 OpenClaw Gateway v1.0.0
✓ Model provider connected
✓ Gateway listening on http://127.0.0.1:18789
✓ Ready to receive messages

5. 설치 확인

서비스 상태 확인:

bash
openclaw status

모든 것이 정상적으로 작동하면 다음이 표시됩니다:

Gateway: Running ✓
Model: Connected ✓
Channels: 0 active

문제 해결

포트가 이미 사용 중

EADDRINUSE 오류가 표시되면:

bash
# 포트 3000을 사용 중인 프로세스 확인
lsof -i :18789

# 프로세스를 종료하거나 다른 포트 사용
openclaw gateway start --port 18790

API 키 문제

401 Unauthorized가 표시되면:

bash
# API 키 재구성
openclaw config set api-key

다음 단계