OpenClaw 설치
공식 스크립트, PowerShell 설치 프로그램 또는 npm으로 openclaw CLI를 설치한 다음, 온보딩을 통해 설정 파일, gateway 토큰, 백그라운드 서비스를 생성하세요.
npm으로 설치하려면 Node.js 24.16+ 또는 26.1+가 필요합니다. 설치 스크립트를 사용하면 Node가 자동으로 설정됩니다. 최소 1 vCPU, 1 GB RAM, 디스크 공간 500 MB를 준비하세요.
macOS, Linux 또는 WSL2에서 설치 프로그램 실행
필요한 경우 스크립트가 Node(macOS에서는 Node 26, Linux에서는 Node 24 LTS)와 openclaw CLI를 설치한 뒤 온보딩 마법사를 시작합니다. 마법사 없이 설치하려면 bash 대신 bash -s -- --no-onboard로 파이프하세요.
shell curl -fsSL https://openclaw.ai/install.sh | bash또는 Windows에서 PowerShell 사용
Windows 네이티브 환경에서는 PowerShell 창에서 PowerShell 설치 프로그램을 실행하세요. 네이티브 Windows Hub 앱을 사용할 수도 있습니다. WSL2에서는 1단계의 셸 스크립트를 사용할 수 있습니다.
PowerShell iwr -useb https://openclaw.ai/install.ps1 | iex또는 npm으로 설치
Node를 직접 관리한다면 패키지를 전역으로 설치하세요. npm 12 및 11.16+에서는 --allow-scripts=openclaw가 필요합니다. npm 11.15 이하에서는 이 플래그를 생략하세요. 그런 다음 onboard --install-daemon을 실행하면 마법사가 시작되고 서비스가 설치됩니다. macOS에서는 LaunchAgent, Linux와 WSL2에서는 systemd 사용자 서비스, Windows에서는 예약 작업으로 등록됩니다.
shell npm install -g openclaw@latest --allow-scripts=openclaw openclaw onboard --install-daemon설치 확인
openclaw --version은 설치된 릴리스를 출력하고, openclaw doctor는 상태 점검을 실행하며, openclaw gateway status는 gateway 서비스의 실행 여부를 표시합니다. 버전 번호는 날짜 기반의 YYYY.M.N 형식입니다.
shell openclaw --version openclaw doctor openclaw gateway status최신 버전 유지
openclaw update를 실행하면 최신 릴리스가 설치됩니다. --channel로 stable, extended-stable, beta, dev 간에 전환하고, --dry-run으로 업데이트를 적용하지 않고 미리 확인할 수 있습니다. openclaw update status 및 openclaw update repair도 사용할 수 있습니다.
shell openclaw update openclaw update --channel beta openclaw update --dry-run
온보딩은 gateway 토큰을 생성하고 gateway가 127.0.0.1:18789에서만 수신 대기하도록 설정합니다. 채팅 채널을 연결하기 전에 보안 강화 가이드를 확인하세요.