결론부터 말씀드리겠습니다. 2026년 2월, 저희는 “OpenClaw은 Windows를 공식 지원하지 않으니 WSL2를 쓰셔야 합니다”라는 전제로 설치 가이드를 썼습니다. 그런데 그 전제가 지금은 더 이상 맞지 않습니다. 다만 정확히 짚어야 할 부분이 있습니다 — 네이티브 앱이 나왔다고 WSL2라는 기술 자체가 사라진 게 아닙니다. 사라진 건 사용자가 손으로 하나하나 밟던 8단계 설치 의식이고, 그 밑에 있던 기술은 지금도 그대로 쓰이고 있습니다. 이 글은 그 차이를 정확히 짚으면서, 지금 기준으로 실제 설치 방법 세 가지를 정리한 가이드입니다.
🦞 OpenClaw이란, 그리고 이 글을 다시 쓰는 이유
OpenClaw은 로컬에서 돌아가는 오픈소스 AI 에이전트 게이트웨이입니다. Discord, Telegram, WhatsApp 같은 메신저에 AI를 연결해서, 채팅으로 자연스럽게 대화하고 작업을 시킬 수 있습니다. Peter Steinberger가 만들었고, 지금은 그가 OpenAI 내부의 “Claw Labs”를 이끌면서 기술적 최종 결정권을 유지하는 한편, 2026년 7월 8일 공식 출범한 OpenClaw Foundation(501(c)(3) 비영리 재단)이 프로젝트를 관리하고 있습니다. 이 재단 출범은 저희가 이 글을 쓰는 시점 기준 12일 전 일입니다.
기존 글은 “OpenClaw이 Windows를 공식 지원하지 않는다”는 전제로 WSL2 경로 하나만 다뤘습니다. 지금은 이 전제 자체가 낡았습니다. 아래에서 현재 실제로 존재하는 세 가지 설치 경로를 정리합니다.
어떤 경로가 맞는지는 목적에 따라 갈립니다. 그냥 빠르게 시작해서 채팅으로 AI 에이전트를 쓰고 싶으시다면 Windows Hub가 가장 짧은 길입니다. 반대로 서버에 상시 배포하거나 CI 파이프라인에 넣는 등 GUI 없이 스크립트로 제어하고 싶으시다면 네이티브 CLI 쪽이 더 맞습니다. Linux 환경의 도구 생태계(특정 리눅스 전용 MCP 서버, 셸 스크립트 등)에 이미 익숙하시거나 그대로 재사용하고 싶으시다면 WSL2 경로가 여전히 유효한 선택입니다.
🪟 지금은 설치 방법이 세 가지입니다
| 방법 | 상태 | 한 줄 설명 |
|---|---|---|
| Windows Hub | 공식 권장 | 네이티브 WinUI 앱, 관리자 권한 불필요, 트레이·1회성 설정 마법사·채팅창 포함 |
| 네이티브 CLI + Gateway | 유효한 대안 | PowerShell 설치 스크립트, 진짜 네이티브, WSL2 불필요 |
| WSL2 Gateway | 여전히 동작, 예전 방식 | 수동 설치, “Linux 호환성이 가장 높은 런타임”이라는 게 공식 문서 표현 |
참고로 이 세 가지는 “Windows 데스크톱에서 뭘 고를지”에 대한 구분입니다. /install 공식 문서에는 npm·pnpm·bun·curl 설치 스크립트·Docker·Podman·Nix·Ansible 같은 패키지 매니저 단위 설치법도 따로 나열되어 있는데, 이건 위 세 가지 각각의 “안에서” 선택하는 세부 방식이라 별개입니다.
✅ Windows Hub로 설치하기 (권장 경로)
github.com/openclaw/openclaw-windows-node/releases/latest에서 서명된 x64/ARM64 설치 파일을 받습니다. Windows 10 20H2 이상 또는 Windows 11이 필요하고, 관리자 권한 없이 설치됩니다. 설치 후 트레이 상태 표시, 최초 실행 마법사, 네이티브 채팅창, Command Center 진단 도구, 노드 모드, 로컬 MCP 서버 모드까지 포함됩니다.
💡 정확히 짚을 부분: Windows Hub의 기본 “로컬에 설정” 흐름은 내부적으로 여전히 앱 전용 WSL2 배포판(OpenClawGateway)을 자동으로 만듭니다. 즉 WSL2라는 기술 자체가 없어진 게 아니라, 예전에 사용자가 손으로 하던 WSL2 설치·Node 설치·npm 설치 과정을 Hub가 대신 자동화해준 것입니다.
MXC 샌드박싱에 대해서도 정확히 말씀드립니다. Microsoft Build 2026 키노트에서 보안 기능으로 소개된 MXC(Microsoft Execution Containers)는 Hub나 네이티브 CLI에 기본 포함되어 있지 않습니다. @openclaw/mxc-sandbox라는 별도 옵션 플러그인으로 설치해야 하고, 이 기능이 기대는 Windows OS 자체의 컨테이너 기능도 이 글 작성 시점 기준으로는 아직 정식 출시가 아닐 수 있습니다(공개 미리보기 단계라는 보도가 있고, 정식 출시는 2026년 10월경으로 언급되고 있습니다 — 확인 시점 기준 정보이며, Windows 업데이트 일정에 따라 달라질 수 있습니다). “Hub를 설치하면 자동으로 샌드박싱된다”는 인상을 드리고 싶지 않아 별도로 밝힙니다.
🐧 WSL2로 직접 설치하기 (기존 방법, 정정 반영)
수동으로 직접 설정하고 싶으시거나, Linux 호환성이 최우선인 경우를 위해 기존 글의 단계를 다시 검증하고 바뀐 부분을 정정해 남겨둡니다.
- WSL2 설치.
wsl --install은 여전히 유효하지만, 지금은/etc/wsl.conf에서 systemd를 명시적으로 켜는 단계가 추가로 필요합니다. 예시 배포판도Ubuntu-24.04기준으로 바뀌었습니다. - Node.js 설치. 예전엔 “Node 22″라고만 안내했는데, 지금은
22.22.3+/24.15+/25.9+중 하나가 필요하고 Node 24를 권장합니다. nvm으로 설치하는 방식은 그대로입니다. - OpenClaw 설치.
npm install -g openclaw@latest— 변경 없이 그대로 유효합니다. - 데몬 등록.
openclaw onboard --install-daemon— 이것도 변경 없이 그대로 유효합니다. - Discord 봇 생성. 여기서부터 달라진 부분이 많습니다 — 바로 아래 절에서 따로 다룹니다.
- 설정 파일 작성. 예전엔
apiKey필드에 평문 키 문자열을 직접 넣었는데, 지금은{source, provider, id}형태의 SecretRef 객체로 참조하는 방식이 기본입니다. - 게이트웨이 확인.
openclaw gateway status/restart/doctor는 지금도 그대로 쓰이고(doctor는 오히려 진단 항목이 늘었습니다), 예전에 쓰던gateway logs --follow는 최상위openclaw logs명령으로 옮겨간 것으로 보입니다. 다만 이 부분은 변경 로그로 명확히 확인되지 않아 단정하지 않습니다 — 버전에 따라 둘 다 동작할 수 있으니, 옛 명령이 안 먹으면 새 명령을 시도해보시길 권합니다. - 워크스페이스 파일. 예전에 안내했던 SOUL.md/IDENTITY.md/USER.md/AGENTS.md 네 개는 지금도 핵심입니다. 다만 현재 공식 문서는 TOOLS.md, HEARTBEAT.md, BOOT.md, BOOTSTRAP.md, MEMORY.md, memory/, skills/, canvas/까지 포함한 더 넓은 부트스트랩 파일 목록을 안내합니다. 전부 외우실 필요는 없고, 필요할 때 공식 문서에서 확인하시면 됩니다.
🔌 Discord 연동 — 달라진 점
openclaw pairing approve discord <코드> 명령으로 페어링을 승인하는 단계가 필수입니다(코드는 1시간 뒤 만료됩니다). 기존 글에는 이 단계가 아예 없었습니다 — 예전 가이드를 그대로 따라 하시면 봇을 초대해도 아무 반응이 없는데 원인을 알 수 없는 상황을 겪으시게 됩니다.
그 외에도 Server Members Intent 활성화가 권장되고, OAuth2 스코프도 bot과 applications.commands 둘 다 필요합니다(예전엔 하나만으로 충분했을 수 있습니다). 권한 범위도 더 넓어졌고, 개발자 모드를 켜서 서버·채널 ID를 수집하는 절차, 그리고 페어링을 위한 DM 프라이버시 토글 설정도 필요합니다.
💡 알아두면 좋은 것들
게이트웨이 포트 — 18789는 이 글 작성 시점 기준 변경되지 않았습니다.
ClawHub 스킬 설치 시 보안 — 예전 글은 다소 경고 위주로만 안내했는데, 지금은 VirusTotal·ClawScan·NVIDIA Skill Cards·SkillSpector 같은 실제 스캔 인프라가 갖춰져 있습니다. 무조건 조심하라기보다, 설치 전에 스캔 요약을 확인하시는 걸 권합니다.
🧭 정리
정리하면 이렇습니다. Windows에서 OpenClaw을 쓰는 방법은 이제 세 가지이고, 대부분의 분들께는 Windows Hub가 가장 간단한 시작점입니다. 다만 Hub도 내부적으로는 WSL2를 자동으로 준비해준다는 점은 알아두시는 게 좋습니다 — 기술이 사라진 게 아니라 손이 덜 가게 된 겁니다. 직접 WSL2 경로로 설치하시는 경우, 위에서 정정한 단계들을 그대로 따라가시면 됩니다. 그리고 Discord 연동에서 페어링 승인 단계를 빠뜨리지 않는 게 가장 중요합니다.