Windows에 OpenClaw 설치하는 방법

Q: WSL 없이 Windows에 OpenClaw를 설치할 수 있나요?

예. OpenClaw는 Windows에서 바로 실행되는 기본 PowerShell 설치 프로그램을 제공합니다. PowerShell을 열고 `iwr -useb https://openclaw.ai/install.ps1 | iex`를 실행해 설치하세요. 이 방법은 단계가 더 적지만, systemd 서비스 관리 같은 일부 기능은 Linux 환경에서 더 잘 작동합니다. 일상적으로 로컬에서 사용한다면 OpenClaw WSL2가 여전히 권장되는 옵션입니다. Kimi Claw는 로컬 설치가 필요 없는 또 다른 선택지입니다.

Q: Windows에서 OpenClaw를 실행할 때 PowerShell보다 WSL2를 권장하는 이유는 무엇인가요?

WSL2에서 OpenClaw를 실행하면 완전한 Linux 환경을 사용할 수 있어 백그라운드 서비스(systemd 기반), 셸 스크립팅, npm 패키지 빌드 같은 기능이 더 일관되게 동작합니다. PowerShell 설치 프로그램은 더 빠르게 설정할 수 있지만 Linux 호환성이 낮은 제한적인 환경에서 실행됩니다. 이런 설정 차이를 신경 쓰지 않고 Windows에서 OpenClaw의 모든 기능을 사용하고 싶다면, Kimi Claw를 통해 로컬 설정 없이 브라우저에서 OpenClaw를 실행할 수 있습니다.

Q: Windows에서 "openclaw is not recognized" 오류를 어떻게 해결하나요?

이 오류는 npm 전역 bin 디렉터리가 시스템 PATH에 없다는 뜻입니다. PowerShell에서 `npm config get prefix`를 실행해 npm prefix를 확인한 뒤, 해당 경로를 Windows 환경 변수에 추가하세요. 변경 후 PowerShell을 다시 시작해야 합니다. 이는 OpenClaw Windows 설치에서 가장 자주 보고되는 문제 중 하나이며 로컬 설치에만 해당됩니다.

Q: Windows PC가 꺼져 있거나 절전 모드일 때도 OpenClaw가 계속 실행되나요?

아니요. OpenClaw를 로컬에 설치하면 컴퓨터가 종료되거나 절전 모드로 들어갈 때 agent도 중지됩니다. Windows가 절전 모드로 전환되면 WSL2도 일시 중단되므로 그동안 예약 작업과 백그라운드 서비스가 실행되지 않습니다. 컴퓨터를 계속 켜 두지 않고도 OpenClaw를 24시간 사용할 수 있게 하려면, Kimi Claw가 항상 온라인 상태를 유지하는 클라우드 서버에서 agent를 실행해 줍니다.

Q: OpenClaw는 Windows에서 작동하나요?

예. OpenClaw는 기본 PowerShell 설치 프로그램 또는 WSL2를 통해 Windows에서 실행됩니다. OpenClaw WSL2는 `systemd` 백그라운드 서비스와 기본 Linux 셸 도구를 포함한 전체 기능을 지원하므로 권장되는 로컬 방식입니다. Windows 10과 Windows 11을 모두 지원합니다. 로컬 설정을 건너뛰고 싶은 사용자는 Kimi Claw를 통해 클라우드 서버에서 OpenClaw를 실행하고 어떤 브라우저에서든 접속할 수 있습니다.

PowerShell 또는 WSL2를 사용해 Windows에 OpenClaw를 설치하세요. 이 가이드는 각 방법이 어떻게 작동하는지 설명해 필요에 맞는 설정을 선택할 수 있도록 도와줍니다. 더 간단한 방법을 원한다면 Kimi Claw로 수동 설정 없이 클라우드에서 agent를 실행할 수도 있습니다.

Kimi Claw 사용해 보기

14분 읽기2026-06-16

OpenClaw는 AI 워크플로를 구축하는 강력한 도구이지만, Windows에서 설정하는 과정은 초보자에게 혼란스러울 수 있습니다. 이 가이드는 주요 설치 방법을 차근차근 안내해 빠르게 시작할 수 있도록 도와줍니다.

OpenClaw Windows 설치: 3가지 방법 비교

단계를 살펴보기 전에 Windows에 OpenClaw를 설치하는 세 가지 방법을 간단히 정리해 보겠습니다. 각 방법은 설정 시간, 기능 범위, 기술 요구 사항 면에서 서로 다른 장단점이 있습니다.

	PowerShell	WSL2	Kimi Claw(온라인)
작동 방식	명령줄을 통한 Windows 기본 설치 프로그램	Windows 안의 완전한 Linux 환경	로컬 설정 없이 OpenClaw를 실행할 수 있는 온라인 도구
설정 난이도	낮음~보통, 명령 실행과 설정 단계 진행 필요	높음, Linux 설정, 시스템 구성, 의존성 설치 필요	매우 낮음, 설정 불필요
코드 또는 터미널 필요 여부	예	예	아니요
상시 사용 가능 여부	PC가 실행 중일 때만	WSL이 실행 중일 때만	24시간 사용 가능, 클라우드 서버에서 실행
적합한 사용자	CLI에 익숙한 개발자	완전한 Linux 환경이 필요한 개발자	비기술 사용자 및 팀

Kimi Claw는 브라우저에서 OpenClaw를 실행할 수 있게 해 주는 온라인 도구입니다. 설정과 구성을 자동으로 처리하므로 Node.js, WSL, API 키 설정이 필요 없습니다. 몇 분 만에 바로 사용할 수 있는 agent를 시작할 수 있습니다.

로컬 PowerShell 또는 WSL2 설정은 방법 1 또는 방법 2로 내려가 확인하세요. 로컬 설치를 완전히 건너뛰려면 방법 3: Kimi Claw로 이동하세요. 더 빨리 시작하고 싶다면 지금 바로 시작할 수 있습니다.

Kimi Claw로 바로 시작하기

Windows에 OpenClaw를 로컬로 설치하기 전 준비 사항

OpenClaw를 로컬에 설치할 계획이라면 시스템이 다음 요구 사항을 충족하는지 확인하세요. Kimi Claw 같은 클라우드 옵션을 선택한다면 이 섹션은 건너뛰어도 됩니다.

시스템 요구 사항

Windows 10 또는 Windows 11(64비트)
최소 4GB RAM(안정적인 npm 빌드를 위해 8GB 권장)
안정적인 인터넷 연결
WSL2를 선택하는 경우 초기 설정을 위한 관리자 권한
OpenClaw WSL2의 경우: BIOS/UEFI에서 가상화가 활성화되어 있어야 함

필수 소프트웨어

Node.js 22.14 이상. OpenClaw에는 최신 Node.js 런타임이 필요합니다. nodejs.org에서 다운로드하거나 온보딩 스크립트로 설치하세요.
Git for Windows(선택 사항이지만 권장). 일부 npm 패키지와 스킬은 Git에 의존합니다.

방법 1: PowerShell을 사용해 Windows에 OpenClaw 설치하기

WSL2에 비해 PowerShell 방식은 단계가 적고 Linux 환경이 필요 없습니다. 단일 명령으로 OpenClaw를 다운로드하고 Node.js 버전을 확인한 뒤 온보딩 마법사를 실행합니다. 이 방법은 Windows 10과 Windows 11 모두에서 작동합니다.

1단계: OpenClaw 설치 및 실행

Windows는 시스템 보호를 위해 기본적으로 스크립트 실행을 제한합니다. OpenClaw를 설치하기 전에 다음 "안전 스위치" 명령을 실행해 PowerShell이 로컬 스크립트를 실행할 수 있도록 허용해야 합니다.

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

그런 다음 다음 명령을 실행하세요.

iwr -useb https://openclaw.ai/install.ps1 | iex

명령을 실행하면 아래 스크린샷과 비슷한 출력이 표시됩니다. 온보딩을 진행하기 전에 PowerShell을 닫았다가 다시 열어 시스템 PATH를 새로 고치세요.

2단계: 위험 안내 확인 및 온보딩 모드 선택

위험을 확인하고 계속하려면 Yes를 선택하세요.

다음으로 QuickStart를 선택해 온보딩을 빠르게 시작하세요. 설정은 나중에 조정할 수 있으며, 전체 구성을 원하면 Manual을 선택해도 됩니다.

3단계: AI 모델 구성 및 인증

모델/인증 제공업체로 Moonshot AI 선택

AI 모델 인증 및 구성

OpenClaw를 연결하려면 Kimi 오픈 플랫폼에서 Kimi API Key를 활성화하세요. $5를 충전하면$ 5 보너스 바우처를 받을 수 있지만, Tier 2 액세스를 열려면 $20 이상을 권장합니다. 이렇게 하면 지연 시간이 줄고 OpenClaw agent가 복잡한 다단계 작업을 안정적으로 처리할 수 있습니다.

Kimi API 키 생성

API Keys 섹션으로 이동해 Create API Key를 클릭하세요. API Key는 안전하면서도 필요할 때 찾을 수 있는 곳에 보관해야 합니다. 생성할 때 한 번만 표시됩니다.

API 키 입력 및 기본 모델 선택

온보딩 마법사가 요청하면 고유한 API 키를 PowerShell/Terminal 창에 붙여 넣으세요.

기본 모델을 선택하라는 메시지가 나오면 moonshot/kimi-k2.5를 선택하세요(이미 강조되어 있다면 "Keep current"를 선택). 이 모델은 agent 작업에 필요한 속도와 추론 능력의 균형이 가장 좋습니다.

4단계: 채널 선택

OpenClaw에 연결할 앱을 선택하세요. 잘 모르겠다면 그냥 건너뛰면 됩니다.

5단계: 성능 설정 구성

구성하려면 Yes를, 건너뛰려면 No를 클릭하세요.

6단계: Hooks 활성화

봇과 채팅할 방법을 선택한 뒤 실행이 시작될 때까지 기다리세요.

7단계: OpenClaw 실행

위 단계를 모두 마쳤다면 이제 OpenClaw를 사용해 보세요.

방법 2: WSL2로 Windows에 OpenClaw 설치하기

OpenClaw WSL2 설정은 Windows 안에 완전한 Linux 환경을 제공하며, OpenClaw 실행을 위해 공식적으로 권장되는 방식입니다. 이 방법을 사용하면 systemd 데몬 관리, 기본 셸 스크립팅, 더 원활한 npm 빌드 등 전체 기능을 사용할 수 있습니다. Windows에서 일상 워크플로우나 개발 용도로 OpenClaw를 사용할 계획이라면 OpenClaw WSL이 가장 좋은 선택입니다.

1단계: Windows 11/10에서 OpenClaw용 WSL2 활성화

PowerShell을 관리자 권한으로 열고 실행하세요.

wsl --install -d Ubuntu

이 명령은 WSL을 활성화하고 Ubuntu를 다운로드한 뒤 설치합니다. 과정이 완료되면 컴퓨터를 다시 시작하세요. Windows가 재부팅되면 Ubuntu가 실행되고 사용자 이름과 비밀번호를 만들라는 메시지가 표시됩니다.

이미 WSL이 설치되어 있다면 다음으로 확인하세요.

wsl --list --verbose

2단계: systemd용 WSL2 구성

OpenClaw는 systemd를 사용해 백그라운드 서비스로 실행됩니다. WSL 구성에서 이를 활성화하세요.

sudo tee /etc/wsl.conf > /dev/null << 'EOF' [boot] systemd=true [interop] enabled=true appendWindowsPath=true EOF

그런 다음 PowerShell에서 WSL을 다시 시작하세요.

wsl --shutdown

Ubuntu 터미널을 다시 열고 systemd가 실행 중인지 확인하세요.

ps -p 1 -o comm=

출력에 systemd가 표시되어야 합니다. 대신 init이 표시되면 /etc/wsl.conf 파일을 다시 확인하세요.

3단계: Node.js 22.14+ 설치

OpenClaw에는 Node.js 22.14 이상이 필요합니다. NodeSource 저장소에서 설치하세요.

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs

설치를 확인하세요.

node --version # v22.x.x 이상이 표시되어야 합니다 npm --version

4단계: npm으로 OpenClaw 설치

Node.js가 준비되면 OpenClaw를 전역으로 설치하세요.

sudo npm install -g openclaw@latest

또는 공식 설치 스크립트를 사용하세요.

curl -fsSL https://openclaw.ai/install.sh | bash

설치를 확인하세요.

openclaw --version

5단계: 온보딩으로 OpenClaw Windows 설정 완료

daemon 플래그를 사용해 온보딩 마법사를 실행하고 OpenClaw를 systemd 서비스로 설정하세요.

openclaw onboard --install-daemon

마법사는 다음 과정을 안내합니다.

LLM 제공업체 선택 및 API 키 입력
기본 모델 선택
메시징 채널 구성(선택 사항)
게이트웨이를 백그라운드 서비스로 설치

온보딩 후 WSL 부팅 시 OpenClaw가 자동으로 시작되도록 서비스 지속 실행을 활성화하세요.

sudo loginctl enable-linger $USER

게이트웨이는 agent 요청, 메시징, 모델 실행을 포함한 모든 OpenClaw 작업을 처리하는 핵심 백그라운드 서비스입니다. 게이트웨이가 실행 중인지 확인하면 OpenClaw 설치가 완료되어 사용할 준비가 되었음을 알 수 있으며, 이후 단계에서 발생할 수 있는 오류도 예방할 수 있습니다.

상태를 확인하려면 PowerShell 또는 WSL 터미널에서 다음 명령을 실행하세요.

openclaw gateway status

방법 3: Kimi Claw로 Windows에서 OpenClaw 실행하기(설정 불필요)

Node.js, WSL, API 키 관리가 필요 이상으로 번거롭게 느껴진다면 Kimi Claw가 OpenClaw를 실행하는 더 간단한 방법을 제공합니다. 로컬 설정이나 수동 구성 없이 브라우저에서 바로 OpenClaw를 실행할 수 있습니다. 시작하려면 다음 단계를 따르세요.

1단계: Kimi Claw 열기 및 인스턴스 생성

Kimi Claw 페이지로 이동해 Create를 클릭하여 시작하세요.

Kimi Claw 열기

2단계: 배포 시작

팝업에서 배포를 확인하세요. Kimi Claw가 게이트웨이, 워크스페이스, 도구를 포함한 OpenClaw 환경을 약 2분 만에 설정합니다. 명령이나 수동 구성은 필요하지 않습니다.

3단계: 워크스페이스에서 작업하기

배포가 완료되면 대시보드에서 워크스페이스가 열립니다. 브라우저에서 AI agent와 채팅하고, 스킬을 설정하고, 예약 작업을 구성하고, 파일을 관리할 수 있습니다.

Kimi Claw 사용해 보기

Kimi Claw에서 제공되는 기능

설정 불필요: Node.js, WSL, API 키 관리가 필요하지 않음
40 GB 클라우드 스토리지: 세션이 바뀌어도 유지되는 보고서, 데이터셋, 생성 파일 저장
영구 메모리: AI agent가 이전 상호작용, 선호도, 맥락을 기억
5,000+ ClawHub 스킬: 자동화, 리서치, 코딩, 분석 스킬에 즉시 액세스
예약 작업 자동화: 일일 보고서, 알림, 모니터링 같은 반복 작업 설정
모든 기기에서 사용 가능: Windows, Mac 또는 모바일의 모든 브라우저에서 OpenClaw agent에 액세스

OpenClaw를 위한 Windows 방화벽 및 보안 설정

Kimi Claw는 클라우드 서버에서 보안과 네트워킹을 자동으로 처리합니다. PowerShell 또는 WSL2로 OpenClaw를 로컬에 설치하려는 경우, 설치 후 구성해 두면 좋은 보안 설정이 몇 가지 있습니다.

Windows 방화벽 구성

OpenClaw 게이트웨이를 처음 시작하면 Windows 방화벽에서 네트워크 액세스 허용 여부를 묻는 메시지가 표시될 수 있습니다. 개인 네트워크에 대해서만 허용하세요. OpenClaw WSL2를 사용하는 경우 게이트웨이는 Linux 환경 안에서 실행되고 localhost를 통해 통신하므로, 일반적으로 추가 방화벽 규칙은 필요하지 않습니다.

Browser Relay나 기타 기능이 연결되지 않는다면 백신 프로그램, VPN 클라이언트, 회사 방화벽 같은 타사 보안 소프트웨어가 localhost 트래픽을 차단하고 있지 않은지 확인하세요.

Control UI 보안 설정

OpenClaw Control UI는 18789 포트에서 실행되며 agent에 대한 전체 액세스를 제공합니다. 이 포트를 공용 인터넷에 절대 노출하지 마세요. 게이트웨이는 127.0.0.1에 바인딩된 상태로 유지하고 로컬 머신에서만 액세스하세요.

안전한 원격 액세스를 위해 Tailscale을 사용해 프라이빗 네트워크 터널을 만드세요.

{ "gateway": { "tailscale": { "mode": "serve" } } }

이렇게 하면 포트는 localhost에 유지하면서, 개인 Tailscale 네트워크를 통해 액세스할 수 있습니다.

Windows에서 자주 발생하는 OpenClaw 설치 오류와 해결 방법

가이드를 그대로 따라도 설치 중 문제가 생길 수 있습니다. 아래는 Windows에 OpenClaw를 설치할 때 가장 자주 보고되는 문제와 해결 방법입니다.

OpenClaw를 인식하지 못함

원인: npm 전역 bin 디렉터리가 시스템 PATH에 포함되어 있지 않습니다.
해결 방법: 다음 명령을 실행해 npm prefix를 찾으세요.

npm prefix -g

출력된 경로를 Windows 환경 변수에 추가하세요. \\bin은 덧붙이지 마세요. 그런 다음 PowerShell을 닫았다가 다시 여세요.

설치 중 Git을 찾을 수 없음

원인: Git for Windows가 설치되어 있지 않습니다.
해결 방법: git-scm.com에서 Git을 다운로드해 설치하세요. 설치 후 PowerShell을 다시 시작하고 OpenClaw Windows 설치 프로그램을 다시 실행하세요.

Node.js 버전이 너무 오래됨

원인: 시스템에 설치된 Node.js 버전이 최소 요구 사항(v22.14+)을 충족하지 못합니다.
해결 방법: nodejs.org에서 최신 LTS 버전을 다운로드해 설치하세요. OpenClaw WSL2를 사용 중이라면 NodeSource 저장소를 통해 다시 설치하세요.

권한 거부 오류

원인: PowerShell 권한이 충분하지 않거나 npm 전역 디렉터리에 쓰기 권한이 없습니다.
해결 방법: PowerShell을 관리자 권한으로 실행하거나, npm 전역 prefix를 사용자 쓰기 가능 디렉터리로 변경하세요.

npm config set prefix "$env:APPDATA\npm"

게이트웨이가 시작되지 않음

원인: Port 18789가 이미 사용 중이거나 구성 파일이 손상되었습니다.
해결 방법: 충돌하는 프로세스가 있는지 확인한 뒤 다시 시작하세요.

# Check what is using the port netstat -ano | findstr :18789 # Restart the gateway openclaw gateway restart

WSL2 systemd가 작동하지 않음

원인: /etc/wsl.conf 파일에 systemd 구성이 없습니다.
해결 방법: 파일에 올바른 설정이 포함되어 있는지 확인하세요.

cat /etc/wsl.conf # 다음 내용이 포함되어야 합니다: # [boot] # systemd=true

설정이 없다면 추가한 뒤 PowerShell에서 wsl --shutdown을 실행해 WSL을 다시 시작하세요.

마무리

Windows에 OpenClaw를 설치하는 방법은 필요에 따라 간단한 스크립트 기반 설정부터 더 고급 WSL2 환경까지 다양합니다. 완전한 제어와 유연성이 필요하다면 PowerShell과 WSL2가 좋은 선택입니다. 설정을 건너뛰고 바로 시작하고 싶다면 Kimi Claw로 로컬 설정 없이 브라우저에서 OpenClaw를 실행할 수 있습니다. 워크플로와 기술 수준에 맞는 방식을 선택하면 OpenClaw를 최대한 활용할 준비가 됩니다.

Kimi Claw 사용해 보기

자주 묻는 질문

WSL 없이 Windows에 OpenClaw를 설치할 수 있나요?

예. OpenClaw는 Windows에서 바로 실행되는 기본 PowerShell 설치 프로그램을 제공합니다. PowerShell을 열고 iwr -useb https://openclaw.ai/install.ps1 | iex를 실행해 설치하세요. 이 방법은 단계가 더 적지만, systemd 서비스 관리 같은 일부 기능은 Linux 환경에서 더 잘 작동합니다. 일상적으로 로컬에서 사용한다면 OpenClaw WSL2가 여전히 권장되는 옵션입니다. Kimi Claw는 로컬 설치가 필요 없는 또 다른 선택지입니다.

Windows에서 OpenClaw를 실행할 때 PowerShell보다 WSL2를 권장하는 이유는 무엇인가요?

WSL2에서 OpenClaw를 실행하면 완전한 Linux 환경을 사용할 수 있어 백그라운드 서비스(systemd 기반), 셸 스크립팅, npm 패키지 빌드 같은 기능이 더 일관되게 동작합니다. PowerShell 설치 프로그램은 더 빠르게 설정할 수 있지만 Linux 호환성이 낮은 제한적인 환경에서 실행됩니다. 이런 설정 차이를 신경 쓰지 않고 Windows에서 OpenClaw의 모든 기능을 사용하고 싶다면, Kimi Claw를 통해 로컬 설정 없이 브라우저에서 OpenClaw를 실행할 수 있습니다.

Windows에서 "openclaw is not recognized" 오류를 어떻게 해결하나요?

이 오류는 npm 전역 bin 디렉터리가 시스템 PATH에 없다는 뜻입니다. PowerShell에서 npm config get prefix를 실행해 npm prefix를 확인한 뒤, 해당 경로를 Windows 환경 변수에 추가하세요. 변경 후 PowerShell을 다시 시작해야 합니다. 이는 OpenClaw Windows 설치에서 가장 자주 보고되는 문제 중 하나이며 로컬 설치에만 해당됩니다.

Windows PC가 꺼져 있거나 절전 모드일 때도 OpenClaw가 계속 실행되나요?

아니요. OpenClaw를 로컬에 설치하면 컴퓨터가 종료되거나 절전 모드로 들어갈 때 agent도 중지됩니다. Windows가 절전 모드로 전환되면 WSL2도 일시 중단되므로 그동안 예약 작업과 백그라운드 서비스가 실행되지 않습니다. 컴퓨터를 계속 켜 두지 않고도 OpenClaw를 24시간 사용할 수 있게 하려면, Kimi Claw가 항상 온라인 상태를 유지하는 클라우드 서버에서 agent를 실행해 줍니다.

OpenClaw는 Windows에서 작동하나요?

예. OpenClaw는 기본 PowerShell 설치 프로그램 또는 WSL2를 통해 Windows에서 실행됩니다. OpenClaw WSL2는 systemd 백그라운드 서비스와 기본 Linux 셸 도구를 포함한 전체 기능을 지원하므로 권장되는 로컬 방식입니다. Windows 10과 Windows 11을 모두 지원합니다. 로컬 설정을 건너뛰고 싶은 사용자는 Kimi Claw를 통해 클라우드 서버에서 OpenClaw를 실행하고 어떤 브라우저에서든 접속할 수 있습니다.

다음도 마음에 드실 수 있습니다