Windows 에서 OpenClaw 설치 완벽 가이드

안녕하세요, coding your life, 코딩오페라입니다. 오늘은 최근 개발자와 생산성 마니아들 사이에서 '게임 체인저'로 불리는 OpenClaw를 Windows에서 설치하는 방법을 아주 자세히 알아보겠습니다. OpenaClaw의 범용적인 설치방법을 알려드릴 테니, Windows 뿐만 아니라 Mac OS에서 설치하실 분들도 참고하시기 바랍니다. 설치 중 발생하는 에러를 사전에 차단하는 팁까지 꽉 채웠으니 끝까지 따라와 주세요! (맨 뒤에 설치 가이드 영상도 있습니다!!)

 

1. 들어가며: 왜 다들 'OpenClaw'에 열광할까?

OpenClaw란 무엇인가?

OpenClaw는 단순한 챗봇이 아닙니다. 사용자의 로컬 환경(파일, 터미널, 브라우저)과 AI 모델(Gemini, GPT 등)을 연결해 주는 'AI 에이전트 게이트웨이'입니다. 쉽게 말해, AI에게 "내 바탕화면의 PDF 요약해서 메일로 보내줘"라고 시키면, AI가 실제로 내 컴퓨터의 파일을 읽고 브라우저를 열어 메일을 보내는 실행력을 갖게 해주는 도구입니다. 즉 브라우저에서만 비서 역할을 했던 기존 AI 모델과 달리, 로컬에서 보다 실질적인 기능을 수행하는 비서 AI라고 생각하시면 됩니다.

원래 이름은 clawdbot이었는데, 앤트토픽의 claudebot과 이름이 유사(발음이 거의 비슷)하여 앤트로픽에서 항의를 하여 moltbot으로 이름을 변경하였고, 한번 더 변경하여 OpenClaw가 되었습니다. 아마 상표권 관련해서 둘이 논쟁이 있었던 것 같네요! 이런 서사를 알고 설치를 하니 더 재밌지 않나요?

🤣🤣

 

왜 요즘 핫할까? (사용해야 하는 이유)

• 단순 답변을 넘어선 '행동': 기존 AI가 말만 했다면, OpenClaw는 내 컴퓨터에서 직접 코드를 실행하고 파일을 관리합니다.
• 로컬 제어와 보안: 클라우드에 모든 데이터를 올리지 않고, 내 컴퓨터 내에서 에이전트가 작동하도록 제어할 수 있습니다.
• 플랫폼 통합: 카카오톡, 텔레그램, 디스코드 등 익숙한 메신저를 통해 내 컴퓨터의 AI 에이전트에게 명령을 내릴 수 있습니다.

 

2. 완벽한 설치를 위한 사전 준비 (Prerequisites)

윈도우는 리눅스와 구조가 달라 아래 도구들이 반드시 필요합니다. 각각의 역할을 이해하면 설치가 훨씬 쉬워집니다.

 

2-1. WSL 2 (Windows Subsystem for Linux)

• 무엇인가요? 윈도우 안에서 리눅스(Ubuntu 등)를 직접 실행할 수 있게 해주는 마이크로소프트의 기술입니다.
• 역할: 대부분의 AI 도구는 리눅스 기반으로 개발됩니다. WSL을 깔아두면 윈도우에서도 리눅스 표준 도구들을 에러 없이 쓸 수 있어 호환성이 극대화됩니다.
• 설치방법: Windows PowerShell을 관리자 권한으로 실행한 다음 아래 코드를 수행해 주시면 됩니다.

# wsl 설치
wsl --install

# 원하는 버전의 wsl 설치	
wsl --install -d Ubuntu-24.04

# wsl 버전 확인
wsl --version

 

2-2. Node.js (엔진 역할)

• 무엇인가요? JavaScript 코드를 브라우저 밖(내 컴퓨터)에서 실행하게 해주는 환경입니다.
• 원래 JavaScript는 크롬이나 사파리 같은 브라우저 안에서만 움직일 수 있는 '안방 도련님' 같은 언어였습니다. 웹페이지를 반짝거리게 하거나 버튼을 누르면 알림 창을 띄우는 역할만 했죠. 하지만 2009년, 라이언 달(Ryan Dahl)이 크롬의 강력한 엔진인 V8 엔진을 떼어내어 브라우저 밖에서도 실행될 수 있게 만들었는데, 그것이 바로 Node.js입니다.
• 왜 필요한가요? OpenClaw 자체가 Node.js로 작성된 프로그램입니다. 이게 없으면 OpenClaw라는 엔진 자체가 돌아가지 않습니다.
• 설치 팁: Node.js 공식 홈페이지에서 LTS(안정화 버전)를 권장합니다.
• https://nodejs.org/ko/download
• 마지막에 Chocolatey 패키지 선택(꼭 해주셔야 합니다! 자세한 이유는 아래 내용을 참고해 주세요!) -> 자동으로 Chocolatey 패키지가 설치됩니다.

Node.js — Node.js® 다운로드

 

2-3. Chocolatey (패키지 매니저)

• 무엇인가요? 윈도우용 '앱 스토어'의 명령어 버전입니다.
• 스마트폰에서 '앱 스토어'나 '구글 플레이 스토어'를 쓰듯이, 윈도우용 프로그램들을 클릭 몇 번 대신 타이핑한 줄로 설치, 업데이트, 관리할 수 있게 해주는 도구입니다.
• 역할: Git, Python 같은 개발 도구를 일일이 웹사이트에서 다운로드하지 않고 choco install git 한 줄로 설치 및 업데이트를 관리해 줍니다.

2-4. Git (버전 관리 및 소스 다운로드)

• 중요: OpenClaw 설치 중 발생하는 spawn git 에러는 99% Git이 없어서 생깁니다. Chocolatey를 통해 미리 설치하세요.

# 관리자 권한 PowerShell에서 입력
choco install git -y

 

2-5. Google Gemini API 발급

• Google AI Studio 접속: 구글 계정으로 로그인합니다.
• https://aistudio.google.com/u/1/api-keys
• 약관 동의: 처음 접속 시 생성형 AI 서비스 약관에 동의합니다.
• 키 생성: 좌측 사이드바에서 "Get API key" 메뉴를 클릭 > 우측 상단 "API 키 만들기"를 클릭 > 원하시는 키를 선택하시고, 마지막으로 "키 만들기" 버튼을 클릭합니다.

  

  

• 프로젝트 선택: "Create API key in new project"를 클릭하면 즉시 영문과 숫자로 된 키가 생성됩니다. 이 키를 복사해서 안전한 곳에 저장하세요.

https://accounts.google.com/v3/signin/identifier?continue=https%3A%2F%2Faistudio.google.com%2Fu%2F1%2Fapi-keys&dsh=S-1005206093%3A1770446337069481&followup=https%3A%2F%2Faistudio.google.com%2Fu%2F1%2Fapi-keys&ifkv=AXbMIuDMJErbtK83jyL-Did8CyKwlTWb8KPyCUNqWUVFLxbsTdUAPRPU5_Q2k-bdTd002CRnfBPZ&passive=1209600&flowName=WebLiteSignIn&flowEntry=ServiceLogin

 

 

3. OpenClaw 설치 단계

준비가 끝났다면 Windows PowerShell(관리자 권한)에서 다음 명령어를 순서대로 입력합니다.

OpenClaw 사이트의 Quick Start항목에 간단한 설치방법이 명시되어 있습니다.

OpenClaw 사이트: https://openclaw.ai/

OpenClaw — Personal AI Assistant

 

3-1. 실행 정책 변경 (보안 차단 해제)

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

 

 

3-2. OpenClaw 전역 설치

# Install OpenClaw
npm i -g openclaw

 

 

3-3. 온보딩 가이드 실행

# Meet your lobster
openclaw onboard

 

위 코드를 실행하면, 아래 그림과 같이 openclaw가 Windows PowerShell에서 실행이 되는데요! 자세한 진행사항은 다음과 같습니다.

 

[OpenClaw 온보딩 과정]

- 초기 진입 및 모드 선택

• I understand... (위험 고지): Yes (시스템 제어 권한 승인)
• Onboarding mode: QuickStart (핵심 설정 위주의 빠른 시작)

- AI 모델 및 API 연동 (Google Gemini)

• Model/auth provider: Google
• Google auth method: Google Gemini API key
• Enter Gemini API key: [Google AI Studio에서 발급받은 키 붙여 넣기]
• Default model (중요):
  • 무료 API 사용자: google/gemini-2.0-flash-lite 추천 (가장 가볍고 안정적)
  • 유료 API 사용자: google/gemini-2.0-flash 이상 자유롭게 선택

- 부가 기능 및 채널 설정 (간소화)

• Select channel: Skip for now (설치 후 언제든 추가 가능)
• Configure skills: No (우선 설치 완료에 집중)

 

4. OpenClaw 실습( 3-3. 온보딩 가이드 실행 이후)

 

위 3-3 온보딩 과정을 거치게 되면 위 우측 그림처럼 OpenClaw gateway 터미널이 팝업 되게 됩니다. 여기서 "https://~"를 통해 UI 사이트를 확인할 수 있습니다.

 

원래 Windows PowerShell 터미널에서는 위와 같이 "How do you want to hatch your bot?"이라는 문구가 나오는데, 이는 "너가 어떤 방법으로 OpenClaw를 실행할거냐?" 라는 방식을 선택하는 문장입니다. 여기서 TUI를 선택하시면, 터미널에서 실행이, web UI를 선택하시면 웹에서 OpenClaw가 실행됩니다. 일단은 TUI를 선택해 보겠습니다.

 

TUI를 선택하시면, 위 그림과 같이 터미널에서 LLM에게 질문을 할 수 있는데요. 다음과 같이 잘 답변하는 것을 알 수 있습니다. 

 

그럼 이번에는 web UI에서도 잘 작동하는지 확인해 볼까요? 위 선택에서 web UI를 선택, 또는 OpenClaw gateway 터미널에서 웹사이트 주소를 이용하여 웹에 접근하면, 위 그림과 같이 UI에서도 OpenClaw가 잘 작동하는 것을 확인할 수 있습니다.

 

https://www.youtube.com/watch?v=b8yzNMaMQxU&t=1056s

여러분들 아직 글로 따라하니 OpenClaw 설치 이해가 어렵다구요? 그래서 제가 준비했습니다. 여러분들을 위해 설치 가이드 영상을 유튜브 영상으로 올려 놓았으니, 영상과 블로그 글을 모두 보시면 이해가 빠르실 겁니다!! 이해가 안되시는 분들은 꼭 영상 참고해주세요 ㅎㅎ

 

또한 여러분들이 OpenClaw 설치 이후 Telegram과 연동하여, 실제 로컬 컴퓨터를 조작해보실 분들은 아래 블로그와 유튜브를 꼭 참고해주세요!
https://codingopera.tistory.com/87

OpenClaw와 Telegram 연동 및 컴퓨터 조작하기 실습(Windows, Mac OS)

 

https://www.youtube.com/watch?v=BabmsVuBkGU&t=383s

 

 

 

5. 마치며

지금 까지 'OpenClaw'설치에 대해 알아보았는데, 도움이 되셨나요? 만약 되셨다면 구독 및 좋아요로 표현해 주시면 정말 감사하겠습니다. 구독과 좋아요는 제가 블로그를 운영하는 데 정말 많은 힘이 됩니다. 궁금한 사항 혹은 앞으로 다루어 주었으면 좋을 주제가 있으시면 댓글 남겨주시면 감사하겠습니다. 여러분 저는 Coding your life, '코딩 오페라'였습니다.

 

추가적으로 제가 AI 학습 관련 오픈 카카오톡방을 만들었습니다. AI와 코딩 학습에 목말라 있으신 분들이 라면 누구나 들어와서 즐겁게 맘껏 정보공유와 AI 공부하시면 될 것 같습니다. 링크는 다음과 같이니 꼭 한번 참석 및 홍보 부탁드리겠습니다.
https://open.kakao.com/o/ggxse9sg

인공지능/AI/코딩 공부방(코딩오페라)

https://www.youtube.com/@codingopera9945

Coding Opera Korea