OpenClaw 설치 방법 — Windows, Mac, Linux 전체 설치 가이드

OpenClaw 설치는 약 5분이 소요됩니다. Node.js 22+, Git, 8GB RAM이 필요합니다. 가장 빠른 방법은 npm install -g openclaw@latest 명령어 하나를 실행한 후 설정 마법사를 진행하는 것입니다. 또는 MyClaw.ai 매니지드 호스팅을 사용하면 설치 과정을 완전히 건너뛸 수 있습니다.

OpenClaw 설치 전 필요한 것

OpenClaw를 컴퓨터에 설치하기 전에 다음 요구 사항을 확인하세요:

요구 사항최소권장RAM8GB16GB저장 공간10GB20GBNode.jsv22v22+ (최신 LTS)운영체제Win 10 (WSL2) / macOS 12 / Ubuntu 20.04최신 안정 버전

옵션 1: 매니지드 호스팅으로 설치 건너뛰기

설치가 번거로우신가요? MyClaw.ai는 완전 매니지드 OpenClaw 호스팅을 제공합니다 — 설정 없이 몇 초 만에 인스턴스가 준비됩니다:

• 즉시 설정 — 설치 불필요, 구성 불필요, 터미널 명령어 불필요
• 항상 실행 — 컴퓨터를 켜두지 않아도 연중무휴 가동
• 자동 업데이트 — 항상 최신 OpenClaw 버전 실행

MyClaw.ai 시작하기 →

---

옵션 2: OpenClaw 셀프 호스팅

셀프 호스팅에는 두 가지 방법이 있습니다: 권장 글로벌 설치 (가장 쉬움) 또는 소스에서 빌드 (개발자용).

권장: 글로벌 설치

모든 플랫폼에서 OpenClaw를 가장 빠르게 실행하는 방법입니다:

npm install -g openclaw@latest
openclaw onboard --install-daemon

설정 마법사가 게이트웨이, 워크스페이스, 채널, 스킬 구성을 안내합니다. --install-daemon 플래그는 백그라운드 서비스(macOS의 launchd, Linux의 systemd)를 설정하여 OpenClaw가 지속적으로 실행되도록 합니다.

설정 후 설치를 확인합니다:

openclaw doctor

---

대안: 소스에서 빌드

완전한 제어를 원하거나 OpenClaw에 기여하고 싶다면 소스에서 빌드할 수 있습니다. 아래의 플랫폼별 가이드를 따르세요.

Windows에 OpenClaw 설치

Windows에서 OpenClaw를 실행할 때는 WSL2를 강력히 권장합니다. 먼저 WSL2를 설치한 후 아래 Linux 지침을 따르세요.

그래도 Windows에서 네이티브로 실행하려면:

1단계: 사전 요구 사항 설치

1. Node.js v22+ 다운로드 (LTS 버전)
2. Git for Windows 다운로드
3. pnpm 설치 — OpenClaw의 권장 패키지 매니저
4. 설치 후 터미널 재시작

설치를 확인합니다:

node --version   # v22 이상이어야 합니다
git --version
pnpm --version

2단계: OpenClaw 저장소 복제

PowerShell 또는 명령 프롬프트를 열고 실행합니다:

git clone https://github.com/openclaw/openclaw.git
cd openclaw

3단계: 설치 및 빌드

pnpm install
pnpm ui:build
pnpm build

이 명령어는 필요한 모든 패키지를 다운로드하고 프로젝트를 빌드합니다.

4단계: 설정 마법사 실행

pnpm openclaw onboard --install-daemon

마법사가 AI 모델, 채널, 워크스페이스 설정을 포함한 OpenClaw 구성을 안내합니다.

macOS에 OpenClaw 설치

1단계: 사전 요구 사항 설치

Homebrew를 사용하는 것이 가장 쉽습니다:

# 필요시 Homebrew 설치
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Node.js와 Git 설치
brew install node git

# pnpm 설치
brew install pnpm

2단계: 복제 및 빌드

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

3단계: 설정 마법사 실행

pnpm openclaw onboard --install-daemon

이 명령어는 launchd 서비스를 설정하여 OpenClaw가 백그라운드에서 자동으로 실행되도록 합니다.

macOS 권한 설정

OpenClaw는 화면 녹화 및 음성 기능을 위해 접근성 권한을 요청할 수 있습니다. 메시지가 표시되면 다음으로 이동하세요:

시스템 설정 > 개인 정보 보호 및 보안 > 손쉬운 사용

터미널 애플리케이션을 허용 목록에 추가하세요.

Linux(Ubuntu/Debian)에 OpenClaw 설치

1단계: 사전 요구 사항 설치

# 패키지 매니저 업데이트
sudo apt update

# NodeSource를 통해 Node.js 22 설치
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Git 설치
sudo apt install -y git

# pnpm 설치
npm install -g pnpm

2단계: 복제 및 빌드

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

3단계: 설정 마법사 실행

pnpm openclaw onboard --install-daemon

이 명령어는 systemd 사용자 서비스를 설정하여 OpenClaw가 백그라운드에서 지속적으로 실행되도록 합니다.

일반적인 설치 문제 해결

"pnpm install"이 권한 오류로 실패

Linux/macOS에서는 pnpm이나 npm에 sudo를 사용하지 마세요. 대신 권한을 수정하세요:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

"Node 버전이 지원되지 않습니다" 오류

OpenClaw는 Node.js 22 이상이 필요합니다:

node --version

버전이 오래된 경우 nodejs.org에서 최신 버전을 다운로드하거나 nvm을 사용하여 버전을 관리하세요:

nvm install 22
nvm use 22

포트가 이미 사용 중

다른 애플리케이션이 동일한 포트를 사용하고 있습니다. 다음 중 하나를 시도하세요:

• 충돌하는 애플리케이션 중지
• 다른 포트 지정: openclaw gateway --port 18790

네이티브 종속성 누락

Linux에서는 추가 빌드 도구가 필요할 수 있습니다:

sudo apt install build-essential

진단 도구 실행

OpenClaw에는 구성을 확인하는 내장 진단 명령이 포함되어 있습니다:

openclaw doctor

설치 확인

OpenClaw를 설치한 후 진단 도구를 실행하여 모든 것이 작동하는지 확인합니다:

openclaw doctor

그런 다음 간단한 에이전트 명령으로 테스트합니다:

openclaw agent --message "안녕하세요, 작동하고 있나요?"

OpenClaw가 응답하면 설치가 완료된 것입니다.

OpenClaw 업데이트

OpenClaw 설치를 최신 버전으로 업데이트하려면:

글로벌 설치의 경우:

openclaw update --channel stable

소스에서 빌드한 경우:

cd openclaw
git pull origin main
pnpm install
pnpm ui:build
pnpm build

다음 단계

OpenClaw가 설치되었으니:

• 시작하기 가이드를 읽고 기본 사용법을 배우세요
• OpenClaw란 무엇인가에 대해 자세히 알아보세요
• 24시간 실행을 위한 OpenClaw 호스팅 옵션을 살펴보세요