설치 - OpenClaw 실전 가이드 beta

OpenClaw는 Node.js 기반의 로컬 AI 에이전트 플랫폼입니다. 설치는 5분이면 충분합니다.

필수 조건

요구사항	최소 버전	권장
Node.js	v22+	v25+
npm	v9+	최신
OS	macOS / Linux	macOS (Apple Silicon)
API 키	Anthropic Claude	Claude Opus 4 권장

Windows는 WSL2 환경에서 사용 가능하지만, macOS/Linux를 강력히 권장합니다.

설치 방법

npm으로 설치

npm install -g openclaw@latest

설치 확인

openclaw --version
# OpenClaw v2026.x.x

온보딩 마법사 실행

openclaw onboard

마법사가 단계별로 안내합니다:

AI 모델 선택 (Anthropic Claude 권장)
API 키 입력
채널 연동 설정
워크스페이스 초기화

Gateway 시작

openclaw gateway start

API 키 설정

Anthropic Claude
OpenAI

# .env 또는 설정 파일에
ANTHROPIC_API_KEY=sk-ant-xxxxx

# 또는 CLI로
openclaw config set anthropic.apiKey "sk-ant-xxxxx"

Claude Opus 4가 가장 뛰어난 성능을 보입니다. Sonnet은 빠르고 저렴한 대안입니다.

OPENAI_API_KEY=sk-xxxxx
openclaw config set openai.apiKey "sk-xxxxx"

워크스페이스 구조

설치 후 생성되는 기본 구조:

~/.openclaw/           # 또는 커스텀 경로
├── AGENTS.md          # AI 행동 규칙
├── SOUL.md            # AI 성격 정의
├── USER.md            # 사용자 프로필
├── MEMORY.md          # 장기 기억
├── HEARTBEAT.md       # 하트비트 체크리스트
├── TOOLS.md           # 도구 로컬 설정
├── memory/            # 일일 노트
│   └── 2026-01-15.md
├── skills/            # 설치된 스킬
└── config.yaml        # 설정 파일

Gateway 데몬 관리

openclaw gateway status    # 상태 확인
openclaw gateway start     # 시작
openclaw gateway stop      # 중지
openclaw gateway restart   # 재시작

Gateway는 포트 18789에서 실행됩니다. http://127.0.0.1:18789에서 웹 대시보드에 접근할 수 있습니다.

자동 시작 설정

컴퓨터 부팅 시 자동 실행:

# macOS
openclaw onboard --install-daemon

# Linux (systemd)
openclaw daemon install

문제 해결

# 진단 도구
openclaw doctor

# 로그 확인
tail -f /tmp/openclaw-gateway.log

openclaw not found 에러가 나면 PATH 설정을 확인하세요:

export PATH="$PATH:$(npm config get prefix)/bin"

Overview

Part 1: AI 에이전트와 생활하기

Part 2: 설치 & 첫 설정

설치

필수 조건

설치 방법

API 키 설정

워크스페이스 구조

Gateway 데몬 관리

자동 시작 설정

문제 해결

​필수 조건

​설치 방법

​API 키 설정

​워크스페이스 구조

​Gateway 데몬 관리

​자동 시작 설정

​문제 해결

필수 조건

설치 방법

API 키 설정

워크스페이스 구조

Gateway 데몬 관리

자동 시작 설정

문제 해결