설치 시간의 90%는 사양 + OS 차이에서 옵니다. 시작 전에 한 번 체크해주세요.
| 항목 | 권장 |
|---|---|
| RAM | 16 GB 이상 |
| 저장소 | SSD 256 GB 이상 |
| OS | macOS 14+ / Windows 11 |
~/.wslconfig 파일을 만들어 [wsl2]
memory=3GB 를 추가하세요. 그래야 Windows + Chrome + WSL이 다 같이 돌아갑니다.
Homebrew는 Mac용 패키지 관리자입니다. 터미널을 열고(Spotlight에서 "터미널" 검색) 아래 명령어를 붙여넣으세요.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
설치 완료 후 터미널을 껐다 켜거나, 아래 명령어를 실행하세요.
eval "$(/opt/homebrew/bin/brew shellenv)"
오픈클로 실행에 필요한 Node.js를 설치합니다.
brew install node
설치 확인:
node --version
v18 이상의 버전이 표시되면 성공입니다.
아래 명령어 한 줄로 오픈클로를 설치합니다.
curl -fsSL https://openclaw.ai/install.sh | bash
설치 확인:
openclaw --version
오픈클로 초기 설정 마법사를 실행합니다.
openclaw onboard
아래 "온보딩 설정 가이드"를 참고하며 진행하세요.
네이티브 PowerShell에서는 ESM 경로 오류가 발생합니다. 아래 순서대로 WSL2를 먼저 설치한 뒤, Ubuntu 안에서 오픈클로를 설치합니다.
상세 가이드: nupik.kr/wsl →
시작 메뉴에서 "PowerShell"을 검색 → "관리자 권한으로 실행" → 아래 명령어 실행:
wsl --install
재부팅 후 Ubuntu가 자동으로 열리며, 사용자 이름과 비밀번호를 설정합니다.
wsl만 입력하면 됩니다.
Ubuntu 터미널에서 아래 명령어를 한 줄씩 순서대로 실행합니다.
# nvm 설치
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
# nvm 활성화
source ~/.bashrc
# Node.js 22 설치 (OpenClaw 최소 요구: v22.14.0)
nvm install 22
설치 확인:
node -v
v22 이상의 버전이 표시되면 성공입니다.
Ubuntu 터미널에서 아래 명령어를 실행합니다.
npm install -g openclaw
설치 확인:
openclaw --version
오픈클로 초기 설정 마법사를 실행합니다.
openclaw onboard
아래 "온보딩 설정 가이드"를 참고하며 진행하세요.
온보딩 설정 가이드
openclaw onboard 실행 시 나타나는 각 화면별 추천 선택입니다. 그대로 따라하시면 됩니다.
트러블슈팅
설치 중 자주 발생하는 오류와 해결 방법입니다.
"command not found: brew" 오류 (Mac)
Homebrew 설치 후 경로가 인식되지 않는 경우입니다.
eval "$(/opt/homebrew/bin/brew shellenv)"
"command not found: node" 오류
Node.js 설치 후 경로가 인식되지 않는 경우입니다.
"permission denied" 오류 (Mac)
설치 스크립트 실행 권한이 없는 경우입니다.
sudo를 붙여보세요. Mac 로그인 비밀번호를 입력해야 합니다.
sudo curl -fsSL https://openclaw.ai/install.sh | bash
"실행 정책" 관련 오류 (Windows)
PowerShell의 스크립트 실행 정책이 제한되어 있는 경우입니다.
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
OAuth 로그인 창이 뜨지 않는 경우
브라우저가 자동으로 열리지 않는 경우입니다.
설치가 중간에 멈추는 경우
네트워크 문제 또는 타임아웃일 수 있습니다.
설치가 안 될 때 (Plan B)
위의 방법으로 설치가 되지 않더라도 걱정하지 마세요. 아래 대안을 참고해주세요.
Plan B-1: 세미나 당일 현장 지원
세미나 시작 15분 전부터 설치 도우미가 대기합니다. 노트북을 가져오시면 함께 설치를 도와드립니다.
Plan B-2: 사전 원격 지원 요청
세미나 전에 미리 도움이 필요하시면 이메일로 연락해주세요. 화면 공유를 통해 원격으로 설치를 도와드립니다.
Plan B-3: 회사 보안 정책으로 설치 불가 시
회사 노트북의 보안 정책으로 프로그램 설치가 완전히 차단된 경우입니다.
Plan B-4: 인터넷 연결이 불안정한 경우
설치 과정에서 안정적인 인터넷 연결이 필요합니다.
Plan B-5: Windows에서 설치 충돌 오류가 발생할 경우
Windows PowerShell에서 ERR_UNSUPPORTED_ESM_URL_SCHEME 오류가 발생하는 경우입니다. Windows 네이티브 경로(C:\Users\...)를 ESM 로더가 인식하지 못해서 생기는 문제입니다.
Step 1. 기존 Windows 설치 완전 삭제
기존에 PowerShell에서 오픈클로를 설치했다면, WSL2 환경과 충돌할 수 있으므로 먼저 제거합니다.
npm uninstall -g openclaw clawhub
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
where.exe openclaw
where.exe openclaw 실행 시 아무것도 안 나오면 삭제 성공입니다.
Step 2. WSL2 + Ubuntu 설치
PowerShell(관리자)에서 아래 명령어를 실행한 후 PC를 재부팅합니다.
wsl --install
재부팅 후 PowerShell에서 Ubuntu를 설치합니다.
wsl --install -d Ubuntu
wsl만 입력하면 됩니다.
Step 3. Node.js 설치 (Ubuntu 터미널에서)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install --lts
Step 4. 오픈클로 설치 및 설정
npm install -g openclaw
openclaw onboard