2026 OpenClaw Windows 재현 설치: PowerShell 원클릭·WSL2 비교·Gateway 상주 차이·PATH/doctor 단계 FAQ

Windows는 여전히 GUI 중심 운영자에게 흔한 데스크 OS입니다. OpenClaw CLI·선택 Gateway·토큰 기반 채널은 PATH, 권한 상승, 「누가 데몬을 띄우는가」만 문서에 박아 두면 관리 가능합니다. 여기서는 재현 가능한 설치에 초점을 맞춥니다: PowerShell 스크립트 패턴, WSL2와 네이티브의 트레이드오프, Linux systemd와 다른 Windows Gateway 상주, 그리고 티켓을 호스트 간에 비교 가능하게 만드는 PATH·doctor 단계(L0–L3)입니다.

재현 설치: PowerShell 원샷 패턴

가정을 고정한 스크립트에 성공 경로를 담습니다: 현재 프로세스 실행 정책, 전용 설치 디렉터리, 단일 Node 메이저, append 전용 로그. 짧음보다 멱등성이 낫습니다——부분 실패 후 재실행 시 PATH 중복이나 나란히 남은 복사본이 생기면 안 됩니다.

# Windows PowerShell 5.1 또는 pwsh 중 하나를 문서에 고정
$ErrorActionPreference = 'Stop'
$installRoot = "$env:LOCALAPPDATA\openclaw-toolchain"
$log = "$installRoot\install.log"
New-Item -ItemType Directory -Force -Path $installRoot | Out-Null
"--- $(Get-Date -Format o) ---" | Out-File -FilePath $log -Append
# 체크섬 검증·압축 해제는 여기로만 — 이후:
$bin = "$installRoot\current\bin"
$userPath = [Environment]::GetEnvironmentVariable('Path','User')
if ($userPath -notlike "*$bin*") {
  [Environment]::SetEnvironmentVariable('Path', "$userPath;$bin", 'User')
}

PATH 변경 후 새 터미널이 필요한지 문서에 적으세요——「CLI가 사라졌다」티켓의 상당수는 오래된 세션 핸들 때문입니다. Node 메이저·OpenClaw 빌드 id·Gateway 포트를 적은 작은 매니페스트를 함께 배포하면 통화 없이 호스트를 diff할 수 있습니다.

Windows PowerShell vs WSL2: 어디서 OpenClaw를 돌릴까

WSL2는 Linux 형 디렉터리와 syscall을 제공해 curl | bash 예제가 익숙해집니다. 대신 분리된 DNS, 한 홉 추가, PATH 우주가 두 개라는 비용이 있습니다——Ubuntu에서 성공했다고 Win32 바이너리를 호출하는 예약 작업이 같이 동작한다는 뜻은 아닙니다. 역할마다 주 런타임을 하나 고르세요. 예: 데스크 운영자는 네이티브 Windows, 이미 컨테이너 우선인 인력만 WSL2.

서버에 올리는 구성과 맞추려면 아래 Linux VPS 실전 글과 이 표를 같이 보세요: 2026 OpenClaw Linux 클라우드 VPS 실전: curl 설치 vs Docker 비교, 환경 검증과 자주 보는 오류 FAQ.

Gateway 상주: Windows는 Linux가 아니다

Linux에서 상시 Gateway는 보통 Restart=on-failure와 journald가 있는 systemd입니다. Windows는 서비스 제어 관리자(SCM), 작업 스케줄러, 래퍼를 쓰며——각각 자격 증명·작업 디렉터리·환경 블록이 다릅니다. 흔한 함정: 관리자가 상승된 PowerShell에서 테스트한 사용자 PATH와 동일하지 않은 LOCAL SERVICE로 서비스를 등록하는 경우입니다.

같은 체크리스트를 재사용하세요: 바이너리 경로, 설정 경로, 쓰기 가능한 데이터 디렉터리, 바인드 인터페이스, 아웃바운드 HTTPS, 토큰 파일 ACL. Linux 쪽 로그·포트·프로브 단계는 2026 OpenClaw Linux 상주 장애: systemd·openclaw logs·게이트웨이 포트 프로브 단계별 FAQ에 정리되어 있습니다. Windows에서는 journald 대신 이벤트 로그, 작업 기록, 직접 연결한 로그로 바꿔 읽으면 됩니다.

PATH와 doctor: 티켓을 비교 가능하게 만드는 단계

두 엔지니어가 같은 티켓 상태를 보게 하려고 L0–L3로 라벨을 붙입니다. L0: 어떤 셸인지——프로필, 상승, WSL 탭 vs PowerShell 탭. L1: Get-Command openclaw / where.exe openclaw와 openclaw --version. L2: 번들 doctor 검사——설정 경로, Node ABI, 아웃바운드 프로브, 선택적 바인드 자가 테스트. L3: 마스킹한 환경, 방화벽 스니펫, 설치 로그 마지막 200줄.

경고에서 오류로 바뀌는 순간 doctor 심각도를 런북에 버전을 매겨 대시보드가 흔들리지 않게 하세요. 도메인 가입 PC에서는 GPO가 PATH를 덮어쓰는 경우만으로도 「금요일까지 됐는데」 회귀가 설명됩니다.