--- title: "macOS, Linux, Windows에 OpenClaw 설치하기 · DotsAgent" description: "공식 스크립트, PowerShell 또는 npm으로 OpenClaw를 설치하고 온보딩을 실행하세요. openclaw doctor로 설치를 확인하고 stable, beta, dev 업데이트 채널을 전환할 수 있습니다." url: https://dotsagent.io/ko/openclaw/install --- OpenClaw 가이드 · 5단계 # OpenClaw 설치 공식 스크립트, PowerShell 설치 프로그램 또는 npm으로 openclaw CLI를 설치한 다음, 온보딩을 통해 설정 파일, gateway 토큰, 백그라운드 서비스를 생성하세요. npm으로 설치하려면 Node.js 24.16+ 또는 26.1+가 필요합니다. 설치 스크립트를 사용하면 Node가 자동으로 설정됩니다. 최소 1 vCPU, 1 GB RAM, 디스크 공간 500 MB를 준비하세요. 1. 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` 2. 또는 Windows에서 PowerShell 사용 Windows 네이티브 환경에서는 PowerShell 창에서 PowerShell 설치 프로그램을 실행하세요. 네이티브 Windows Hub 앱을 사용할 수도 있습니다. WSL2에서는 1단계의 셸 스크립트를 사용할 수 있습니다. PowerShell`iwr -useb https://openclaw.ai/install.ps1 | iex` 3. 또는 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` 4. 설치 확인 openclaw --version은 설치된 릴리스를 출력하고, openclaw doctor는 상태 점검을 실행하며, openclaw gateway status는 gateway 서비스의 실행 여부를 표시합니다. 버전 번호는 날짜 기반의 YYYY.M.N 형식입니다. shell`openclaw --version openclaw doctor openclaw gateway status` 5. 최신 버전 유지 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에서만 수신 대기하도록 설정합니다. 채팅 채널을 연결하기 전에 보안 강화 가이드를 확인하세요. ## 더 많은 OpenClaw 가이드 [VPS에서 OpenClaw 실행](https://dotsagent.io/ko/openclaw/vps) [Docker에서 OpenClaw 실행하기](https://dotsagent.io/ko/openclaw/docker) [Raspberry Pi에서 OpenClaw 실행하기](https://dotsagent.io/ko/openclaw/raspberry-pi) [모델을 OpenClaw에 연결](https://dotsagent.io/ko/openclaw/models) [OpenClaw를 Telegram에 연결](https://dotsagent.io/ko/openclaw/telegram) [OpenClaw gateway 보안 강화하기](https://dotsagent.io/ko/openclaw/hardening) [OpenClaw 원격 접속](https://dotsagent.io/ko/openclaw/remote-access) ## 출처 1. [docs.openclaw.ai](https://docs.openclaw.ai/install)/install 2. [docs.openclaw.ai](https://docs.openclaw.ai/install/updating)/install/updating AI 에이전트를 만드는 개발자를 위한 독립적인 참고 자료입니다. 여기에 언급된 어떤 업체와도 제휴 관계가 없습니다. © 2026 DotsAgent · 정보 확인일: 2026년 10월 1일