제로에서 AI 어시스턴트까지 5분 안에
플랫폼을 선택하고 따라해 보세요. 금방 AI와 대화할 수 있습니다.
macOS에 설치하기
가장 빠른 시작 방법. Node.js 18+ 필요.
OpenClaw 설치
npm install -g openclaw설정 마법사 실행
API 키 설정 및 기본 설정을 안내해 드립니다.
openclaw initGateway 시작
Gateway는 모든 연결을 처리하는 OpenClaw의 백그라운드 서비스입니다.
openclaw gateway start안녕하세요!
openclaw chat "Hello! What can you do?"Windows에 설치하기
OpenClaw는 WSL2(권장) 또는 네이티브 Node.js를 통해 Windows에서 잘 작동합니다.
WSL2 설정 (권장)
WSL2가 설치되어 있지 않은 경우, PowerShell을 관리자 권한으로 열고 실행하세요:
wsl --install설치 후 컴퓨터를 재시작하세요.
WSL에 Node.js 설치
WSL 터미널(Ubuntu)을 열고 Node.js를 설치하세요:
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejsOpenClaw 설치
npm install -g openclaw초기화 및 시작
openclaw init
openclaw gateway start
openclaw chat "Hello!"Linux에 설치하기
Node.js 18+가 있는 모든 배포판에서 작동합니다. 서버에 안성맞춤!
Node.js 설치 (필요시)
"comment"># Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
"comment"># Arch
sudo pacman -S nodejs npmOpenClaw 설치
npm install -g openclaw초기화 및 시작
openclaw init
openclaw gateway start테스트
openclaw chat "Hello! What can you do?"Docker로 설치하기
격리 및 쉬운 배포에 좋습니다. Docker가 실행되는 어디서나 작동합니다.
이미지 가져오기
docker pull openclaw/openclaw:latest설정 마법사 실행
docker run -it \
-v openclaw-config:/home/openclaw/.openclaw \
openclaw/openclaw:latest initGateway 시작
docker run -d \
--name openclaw \
--restart unless-stopped \
-v openclaw-config:/home/openclaw/.openclaw \
openclaw/openclaw:latest gateway start채팅
docker exec -it openclaw openclaw chat "Hello!"클라우드에 배포
항상 켜져 있는 원클릭 배포.
API 키 발급
OpenClaw는 선호하는 AI 제공업체의 API 키가 필요합니다.
문제 해결
일반적인 문제와 해결 방법.
Command not found: openclaw
Make sure npm's global bin directory is in your PATH. Try:
npm config get prefixAdd the returned path + /bin to your shell's PATH variable.
Gateway won't start
Check if the port is already in use. The gateway runs on port 3000 by default.
lsof -i :3000 # macOS/Linux
netstat -ano | findstr :3000 # WindowsYou can also try restarting: openclaw gateway restart
API key not working
Verify your API key is correctly set:
openclaw config showMake sure there are no extra spaces. You can reset it with openclaw init.
WhatsApp QR code not appearing
The WhatsApp QR code is shown in the terminal. Make sure you run the command in a terminal that supports QR display. If issues persist, see the official WhatsApp docs.
아직 막혀 계신가요?
🎉 모든 준비가 완료되었습니다!
OpenClaw가 실행되고 있으니 다음 단계를 진행하세요: