2026년 최신 OpenClaw 설치 방법 초보자 완벽 가이드

목차

• OpenClaw 설치 전, 이것만은 꼭 확인하세요
• 단 한 줄의 명령어로 끝내는 OpenClaw 설치 방법
• OpenClaw 시작하기: 5분 만에 끝내는 초기 설정
• 나의 첫 AI 에이전트: OpenClaw 실행 및 테스트
• 성공적으로 끝낸 OpenClaw 설치, 이제 시작입니다!
• 자주 묻는 질문 (FAQ)

OpenClaw 설치 전, 이것만은 꼭 확인하세요

OpenClaw 설치는 매우 간단하지만, 몇 가지만 미리 준비하면 훨씬 더 원활하게 진행할 수 있습니다. 이 섹션은 여러분이 겪을 수 있는 대부분의 문제를 미리 방지해 줄 든든한 체크리스트입니다. OpenClaw 설치 가이드 초보자용으로서, 시스템 요구사항부터 꼭 필요한 Node.js와 WSL2까지 차근차근 짚어보겠습니다.

이 준비 과정은 마치 요리를 시작하기 전 재료를 손질하는 것과 같습니다. 미리 시스템 환경을 정리하고 필요한 도구를 갖추면, 실제 설치는 버튼 하나 누르는 것처럼 간단하게 느껴질 것입니다. 특히 Windows 사용자의 경우 WSL2 설치는 번거롭게 느껴질 수 있지만, 가장 안정적인 사용 환경을 보장하는 필수 단계이므로 꼭 따라 해 주시길 바랍니다.

1. 시스템 요구사항

먼저 여러분의 컴퓨터가 OpenClaw를 맞이할 준비가 되었는지 확인해 보세요. 다행히 OpenClaw는 대부분의 최신 컴퓨터에서 가볍게 작동합니다.

2. Node.js 설치 (가장 중요)

OpenClaw는 Node.js라는 기술을 기반으로 만들어졌습니다. 따라서 여러분의 컴퓨터에 Node.js가 설치되어 있어야 합니다. 하지만 걱정하지 마세요. Node.js가 없더라도 OpenClaw 설치 프로그램이 알아서 설치해 주기도 합니다.

• 필수 버전: 공식적으로 Node 22.22.3+, 24.15+, 또는 25.9+ 버전이 필요합니다.
• 자동 설치: 만약 여러분의 컴퓨터에 Node.js가 없다면, OpenClaw 설치 프로그램이 자동으로 권장 버전을 설치합니다. (macOS는 Node 26, Linux는 Node 24 LTS 자동 설치)
• 버전 확인: 이미 설치되어 있는지 확인하려면, 터미널(또는 Windows의 명령 프롬프트)을 열고 아래 명령어를 입력해 보세요.

node -v

3. 운영체제별 사전 준비

Windows 사용자: WSL2 설치
OpenClaw는 리눅스 환경에서 가장 잘 작동합니다. Windows에서는 WSL2(Windows Subsystem for Linux 2)라는 기능으로 가상의 리눅스 환경을 만들어야 합니다.

1. 시작 메뉴에서 ‘PowerShell’을 찾아 마우스 오른쪽 버튼을 클릭 후, ‘관리자 권한으로 실행’을 선택하세요.
2. 열린 PowerShell 창에 아래 명령어를 그대로 복사하여 붙여넣고 Enter 키를 누르세요.

wsl --install

3. 설치가 완료되면 컴퓨터를 재시작하라는 메시지가 나올 수 있습니다. 메시지에 따라 재시작하면 모든 준비가 끝납니다.

macOS 사용자
‘Terminal’ 앱만 사용할 줄 알면 됩니다. Command + Space를 눌러 Spotlight를 열고 ‘Terminal’을 검색해 실행하세요. 패키지 관리를 더 쉽게 하고 싶다면 Homebrew를 설치하는 것을 추천합니다. 터미널에 아래 명령어를 붙여넣으면 간단하게 설치할 수 있습니다.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Linux 사용자
대부분의 리눅스 배포판에서는 별도의 준비 없이 바로 설치를 시작할 수 있습니다.

4. API 키 미리 준비하기 (강력 추천)

OpenClaw의 두뇌 역할을 하는 것은 거대 언어 모델(LLM)입니다. 이 LLM을 이용하려면 ‘API 키’라는 비밀번호가 필요합니다. 설치 과정에서 바로 입력할 수 있도록 미리 발급받는 것이 좋습니다.

• 추천 모델: 초보자에게는 가입 시 무료 사용량을 제공하는 Anthropic의 Claude 모델을 가장 추천합니다.
• 발급 방법:
  1. Anthropic 공식 웹사이트(console.anthropic.com)에 접속하여 회원가입을 합니다.
  2. 로그인 후, 프로필 설정이나 대시보드에서 ‘API Keys’ 메뉴를 찾습니다.
  3. ‘Create Key’ 버튼을 눌러 새로운 API 키를 생성하고, 생성된 키를 안전한 곳에 복사해 두세요. 이 키는 한 번만 보여주므로 꼭 저장해야 합니다.
• 비용: API는 사용한 만큼 비용이 발생할 수 있다는 점을 기억해 주세요. 하지만 무료로 제공되는 양만으로도 충분히 테스트해 볼 수 있습니다.

단 한 줄의 명령어로 끝내는 OpenClaw 설치 방법

이제 모든 준비가 끝났습니다. 지금부터는 운영체제에 상관없이 단 한 줄의 명령어로 OpenClaw 설치 방법을 완료할 수 있습니다. 초보자에게는 모든 과정을 자동으로 처리해 주는 이 ‘원라인 설치’ 방법을 가장 강력하게 추천합니다. 복잡한 설정 없이 OpenClaw 시작하기의 첫 단추를 가장 쉽게 끼울 수 있는 방법입니다.

이 명령어는 OpenClaw 설치에 필요한 모든 파일을 인터넷에서 내려받아 최적의 위치에 설치하고, 실행에 필요한 환경까지 자동으로 구성해주는 마법 같은 주문입니다. 터미널 화면에 여러 글자가 빠르게 지나가더라도 걱정하지 마세요. 여러분의 AI 에이전트가 깨어나는 정상적인 과정입니다.

1. macOS 및 Linux 사용자

터미널(Terminal) 앱을 열고, 아래의 명령어를 그대로 복사하여 붙여넣은 뒤 Enter 키를 누르세요.

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

2. Windows (WSL2) 사용자

1. 시작 메뉴에서 ‘Ubuntu’ (또는 wsl --install로 설치된 다른 리눅스 배포판)를 검색하여 실행합니다.
2. 열린 리눅스 터미널 창에, 위 macOS/Linux와 완전히 동일한 명령어를 복사하여 붙여넣고 Enter 키를 누르세요.

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

3. 설치 과정 및 확인

위 명령어를 실행하면, 터미널 화면에 ‘Downloading OpenClaw…’와 같은 메시지들이 나타나며 설치가 자동으로 진행됩니다. 1~2분 정도 소요될 수 있습니다. 설치가 성공적으로 완료되면, 터미널을 완전히 닫았다가 다시 연 후에 아래 명령어를 입력하여 설치를 확인하세요.

openclaw --version

버전 번호(예: openclaw 1.2.3)가 정상적으로 나타난다면 성공적으로 설치된 것입니다.

(선택) npm을 이용한 수동 설치

Node.js와 npm에 익숙한 고급 사용자를 위한 방법도 있습니다. 하지만 권한 문제 등이 발생할 수 있어 초보자에게는 권장하지 않습니다.

npm install -g openclaw@latest --allow-scripts=openclaw

OpenClaw 시작하기: 5분 만에 끝내는 초기 설정

설치가 끝났으니, 이제 여러분의 AI 에이전트를 깨울 시간입니다. 첫 실행 시에는 간단한 초기 설정 과정인 ‘온보딩 마법사’가 실행됩니다. 이 과정은 앞으로 OpenClaw가 어떻게 작동할지를 정하는 중요한 단계이지만, OpenClaw 설치 가이드 초보자용에 맞춰 가장 쉽고 빠른 길로 안내해 드리겠습니다.

OpenClaw 시작하기의 이 단계는 여러분의 AI 에이전트에게 ‘두뇌’를 연결하고 ‘작업 공간’을 마련해주는 과정과 같습니다. 여기서 설정한 API 키는 AI의 지능을, 워크스페이스는 AI의 기억과 결과물을 저장하는 책상 역할을 하게 됩니다. 처음에는 모든 고급 설정을 건너뛰고 가장 핵심적인 부분만 설정하여 빠르게 시작하는 것을 목표로 합니다.

1. 온보딩 마법사 실행

터미널을 열고 아래 명령어를 입력하세요. 설치 직후라면 openclaw onboard 명령어를 사용하라는 안내가 나왔을 수도 있습니다.

openclaw

2. API 키 설정 (가장 중요)

온보딩 과정에서 가장 먼저, 그리고 가장 중요하게 설정할 부분입니다. 미리 준비해 둔 API 키를 사용할 차례입니다.

1. Provider 선택: Which provider would you like to use? 라는 질문이 나오면, 여러분이 키를 발급받은 서비스(예: Anthropic)를 화살표 키로 선택하고 Enter를 누릅니다.
2. API 키 입력: Please enter your API key: 라는 안내에 따라 복사해 둔 API 키를 붙여넣고 Enter를 누르세요. (보안을 위해 키를 입력해도 화면에는 아무것도 나타나지 않는 것이 정상이니 당황하지 마세요.)

3. 워크스페이스(Workspace) 디렉토리 설정

• 개념: 워크스페이스는 OpenClaw가 파일을 생성하거나, 대화 내용을 기억하고, 로그를 저장하는 전용 폴더입니다.
• 설정: Enter workspace directory라는 질문이 나오면, 기본 경로가 이미 제안되어 있을 것입니다. 특별한 이유가 없다면 그냥 Enter 키를 눌러 기본값을 사용하는 것을 권장합니다.

4. 채널 및 스킬 설정

온보딩 마법사가 텔레그램, 디스코드 같은 메신저 연동(Channels)이나 추가 기능(Skills) 설치에 대해 물어볼 수 있습니다. 이 기능들은 매우 강력하지만, 처음 시작하는 단계에서는 복잡하게 느껴질 수 있습니다.

• 추천: 이 단계들은 나중에 언제든지 다시 설정할 수 있으므로, ‘Skip’ 또는 기본값을 선택하여 넘어가세요.

5. 설정 완료 확인

모든 과정을 마치면 “Onboarding complete!” 라는 메시지와 함께 > 형태의 OpenClaw 프롬프트가 나타납니다. 축하합니다! 이제 여러분만의 AI 에이전트를 사용할 모든 준비가 끝났습니다. (참고: 오늘 설정한 내용은 ~/.openclaw/config.json 파일에 저장되며, 나중에 이 파일을 직접 수정할 수도 있습니다.)

나의 첫 AI 에이전트: OpenClaw 실행 및 테스트

드디어 OpenClaw 시작하기의 마지막 단계이자 가장 흥미로운 순간입니다. 이제 여러분의 AI 에이전트가 정말로 살아 움직이는지 확인해 볼 차례입니다. 간단한 명령 몇 가지를 통해 OpenClaw가 여러분의 말을 얼마나 잘 이해하고 작업을 수행하는지 직접 경험해 보세요.

이 테스트는 단순한 작동 확인을 넘어, AI 에이전트와의 첫 ‘소통’ 경험입니다. 사람이 컴퓨터에게 자연스러운 언어로 명령을 내리면, 컴퓨터가 그 의도를 파악하고 실제 행동으로 옮기는 놀라운 과정을 직접 목격하게 될 것입니다. 파일 하나를 만드는 작은 성공 경험이 앞으로 여러분이 OpenClaw를 활용해 펼쳐나갈 무한한 가능성의 시작이 될 것입니다.

1. 첫 대화 시작하기

OpenClaw 프롬프트(> )에 아래와 같이 다양한 질문과 명령을 입력해 보세요. 한국어도 물론 잘 알아듣습니다.

• 기능 물어보기:

  Hello, what can you do?

• 간단한 정보 질문하기:

  현재 시간을 한국 시간으로 알려줘.

• 실제 파일 생성 명령하기:

  내 워크스페이스에 'hello.txt'라는 이름으로 'Hello OpenClaw!'라고 적힌 파일을 만들어줘.

2. 작동 확인하기

파일 생성 명령을 내렸을 때, OpenClaw는 다음과 같이 반응할 것입니다.

1. 의도 파악: “Understood. I will create a file named ‘hello.txt’ in your workspace with the content ‘Hello OpenClaw!’.” 와 같이 자신이 이해한 내용을 먼저 확인시켜 줍니다.
2. 작업 수행: 실제로 여러분이 설정한 워크스페이스 폴더 안에 hello.txt 파일을 생성합니다.
3. 결과 보고: “I have successfully created the file.” 와 같이 작업 완료를 보고합니다.

이제 파일 탐색기를 열어 워크스페이스 폴더(기본값은 홈 디렉토리 아래 .openclaw/workspace/)로 이동해 보세요. hello.txt 파일이 멋지게 생성되어 있을 것입니다!

3. OpenClaw 종료하기

OpenClaw를 종료하고 싶을 때는 프롬프트에 exit을 입력하거나, 키보드에서 Ctrl + C를 함께 누르면 됩니다.

성공적으로 끝낸 OpenClaw 설치, 이제 시작입니다!

축하합니다! 여러분은 이 가이드를 통해 자신만의 강력한 AI 에이전트를 성공적으로 설치하고 첫걸음을 뗐습니다. 복잡해 보였던 OpenClaw 설치 방법이 사실은 아래의 3단계로 요약된다는 것을 이제 아실 겁니다.

1. 준비하기: 내 컴퓨터에 맞는 환경(Node.js, WSL2)을 점검하고 API 키를 준비합니다.
2. 설치하기: 터미널에 마법의 한 줄 명령어를 입력하여 설치를 끝냅니다.
3. 설정하기: 온보딩 마법사를 따라 API 키를 입력하여 AI의 두뇌를 연결합니다.

이처럼 OpenClaw 시작하기는 결코 어렵지 않습니다. 이제 여러분의 손안에 놓인 AI 에이전트를 통해 일상과 업무의 생산성을 극대화할 수 있는 무한한 가능성이 열렸습니다. 반복적인 파일 정리, 웹 리서치, 코드 작성 보조 등 여러분이 상상하는 모든 것을 자동화할 준비가 되었습니다.

다음 포스팅에서는 OpenClaw의 진정한 힘을 보여주는 ‘스킬(Skills)’을 설치하고 활용하는 방법을 자세히 다룰 예정입니다. 스킬을 통해 웹 브라우저를 제어하고, GitHub 저장소를 분석하는 등 훨씬 더 복잡하고 지능적인 작업을 수행하는 방법을 배우게 될 것입니다.

만약 설치나 사용 중 문제가 발생하면 주저하지 말고 공식 커뮤니티를 방문하세요. 전 세계의 사용자들이 여러분의 질문에 답변해 줄 것입니다.

• OpenClaw 공식 GitHub: https://github.com/openclaw/openclaw
• OpenClaw 공식 Discord: 커뮤니티 채널에서 실시간으로 도움을 받을 수 있습니다.

AI 에이전트와 함께하는 여러분의 새로운 여정을 진심으로 응원합니다.

자주 묻는 질문 (FAQ)

Q: ‘command not found: openclaw’ 메시지가 나타납니다.

A: 설치는 완료되었지만 시스템이 명령어를 인식하지 못하는 상태입니다. 터미널을 완전히 껐다가 다시 켜보세요. 이것이 가장 간단하고 확실한 해결책입니다. 시스템이 새로 변경된 환경 설정을 불러오게 됩니다.

Q: ‘EACCES: permission denied’ 오류가 발생합니다.

A: 이 오류는 npm으로 수동 설치 시 시스템 폴더에 파일을 쓸 권한이 부족하여 발생합니다. 이런 문제를 피하기 위해 초보자에게는 원라인 설치를 권장합니다. 가이드 본문에 안내된 curl로 시작하는 명령어로 다시 설치해 보세요.

Q: API 키 인증에 실패했다는 메시지(‘401 Unauthorized’)가 나옵니다.

A: 입력한 API 키가 잘못되었거나 계정의 무료 사용량이 소진되었을 가능성이 높습니다. 먼저 API 키에 오타나 공백이 없는지 확인하고, API 발급 사이트(예: Anthropic)에 로그인하여 키가 유효한지, 무료 크레딧이 남았는지 확인하세요. openclaw onboard --reset 명령어로 설정을 초기화하고 다시 시도해볼 수도 있습니다.

Q: OpenClaw 설치 시 보안상 주의할 점이 있나요?

A: 네, 매우 중요합니다. 2026년 1월 29일 이전에 배포된 구버전 OpenClaw에는 CVE-2026-25253이라는 심각한 보안 취약점이 존재합니다. 하지만 이 가이드의 최신 설치 방법을 따랐다면 해당 취약점이 완벽하게 해결된 가장 안전한 버전이 설치되었으니 안심하셔도 됩니다. 만약 구버전을 사용 중이라면, 보안을 위해 반드시 최신 버전으로 업데이트할 것을 강력히 권고합니다.

이 글이 마음에 드세요?

RSS 피드를 구독하세요!