1
Homebrew 설치
Homebrew는 Mac용 패키지 관리자입니다. 터미널을 열고(Spotlight에서 "터미널" 검색) 아래 명령어를 붙여넣으세요.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Tip: 설치 중 비밀번호를 묻는 화면이 나오면 Mac 로그인 비밀번호를 입력하세요. 입력 시 화면에 표시되지 않지만 정상입니다.
설치 완료 후 터미널을 껐다 켜거나, 아래 명령어를 실행하세요.
eval "$(/opt/homebrew/bin/brew shellenv)"
2
Node.js 설치
오픈클로 실행에 필요한 Node.js를 설치합니다.
brew install node
설치 확인:
node --version
확인:
v18 이상의 버전이 표시되면 성공입니다.
3
오픈클로 설치
아래 명령어 한 줄로 오픈클로를 설치합니다.
curl -fsSL https://openclaw.ai/install.sh | bash
설치 확인:
openclaw --version
4
온보딩 실행
오픈클로 초기 설정 마법사를 실행합니다.
openclaw onboard
아래 "온보딩 설정 가이드"를 참고하며 진행하세요.
1
PowerShell 관리자 모드 실행
시작 메뉴에서 "PowerShell"을 검색한 뒤, "관리자 권한으로 실행"을 클릭하세요.
Tip: 일반 PowerShell이 아닌 "관리자 권한으로 실행"을 선택해야 합니다. 파란색 화면이 나타나면 "예"를 클릭하세요.
2
Node.js 설치
Windows 패키지 관리자(winget)를 사용해 Node.js를 설치합니다.
winget install OpenJS.NodeJS.LTS
설치 후 PowerShell을 껐다 다시 열고 아래 명령어로 확인하세요.
node --version
확인:
v18 이상의 버전이 표시되면 성공입니다.
3
오픈클로 설치
PowerShell에서 아래 명령어를 실행합니다.
irm https://openclaw.ai/install.ps1 | iex
참고: "실행 정책" 관련 오류가 나오면, 먼저 아래 명령어를 실행한 후 다시 시도하세요.
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
설치 확인:
openclaw --version
4
온보딩 실행
오픈클로 초기 설정 마법사를 실행합니다.
openclaw onboard
아래 "온보딩 설정 가이드"를 참고하며 진행하세요.
온보딩 설정 가이드
openclaw onboard 실행 시 나타나는 각 화면별 추천 선택입니다. 그대로 따라하시면 됩니다.
Security Warning
Yes, I trust this project
프로젝트 신뢰 확인 - "Yes"를 선택하세요
Setup Mode
QuickStart
빠른 시작 모드를 선택합니다
Model / Auth
OpenAI Codex OAuth
별도 API 키 없이 OAuth 로그인으로 사용 가능 (추천)
Default Model
gpt-5.3-codex-spark
기본 AI 모델 - 가장 안정적인 모델입니다
Channel
Telegram
2회차 세미나에서 텔레그램 봇을 만들 예정입니다
Search Provider
DuckDuckGo
별도 API 키 없이 바로 사용 가능한 검색 엔진
Skills
추천 8개 전부 선택
기본 제공 스킬을 모두 활성화합니다. 나중에 변경 가능합니다.
Package Manager
npm
Node.js와 함께 설치된 기본 패키지 관리자
Hooks
4개 전부 활성화
자동화 훅을 모두 켜두세요. 3회차 워크숍에서 활용합니다.
Hatch
TUI (Terminal UI)
터미널 기반 인터페이스 - 가장 직관적인 옵션
API Key 질문들
전부 No
API 키 설정은 지금 하지 않아도 됩니다. OAuth로 충분합니다.
트러블슈팅
설치 중 자주 발생하는 오류와 해결 방법입니다.
"command not found: brew" 오류 (Mac)
Homebrew 설치 후 경로가 인식되지 않는 경우입니다.
해결: 터미널을 완전히 닫았다가 다시 열거나, 아래 명령어를 실행하세요.
eval "$(/opt/homebrew/bin/brew shellenv)"
"command not found: node" 오류
Node.js 설치 후 경로가 인식되지 않는 경우입니다.
해결: 터미널(또는 PowerShell)을 완전히 닫았다가 다시 여세요. Windows의 경우 PC를 재시작하면 확실합니다.
"permission denied" 오류 (Mac)
설치 스크립트 실행 권한이 없는 경우입니다.
해결: 명령어 앞에
sudo를 붙여보세요. Mac 로그인 비밀번호를 입력해야 합니다.
sudo curl -fsSL https://openclaw.ai/install.sh | bash
"실행 정책" 관련 오류 (Windows)
PowerShell의 스크립트 실행 정책이 제한되어 있는 경우입니다.
해결: 관리자 권한 PowerShell에서 아래 명령어를 먼저 실행하세요.
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
OAuth 로그인 창이 뜨지 않는 경우
브라우저가 자동으로 열리지 않는 경우입니다.
해결: 터미널에 표시된 URL을 직접 복사해서 브라우저에 붙여넣으세요. 기본 브라우저가 Chrome 또는 Safari인지 확인하세요.
설치가 중간에 멈추는 경우
네트워크 문제 또는 타임아웃일 수 있습니다.
해결: Wi-Fi 연결을 확인하고, 터미널을 닫은 후 처음부터 다시 시도하세요. VPN이 켜져 있다면 꺼보세요.
도움이 필요하신가요? 세미나 당일에 강사가 직접 도와드립니다. 미리 설치하지 못하셔도 걱정하지 마세요.