OpenClaw 설치 쉽고 빠르게 따라하기 (Click !)

OpenClaw 설치 방법을 단계별로 안내합니다. 평범한 40대 아저씨 소카가 직접 설치하면서 경험한 내용을 바탕으로, 초보자도 따라할 수 있는 완전한 가이드입니다. 맥미니가 품절될 정도로 인기 있는 OpenClaw, 함께 설치해보겠습니다.

OpenClaw란 무엇인가

OpenClaw에서 무엇을 할 수 있나요?

WhatsApp, Telegram, Discord, Slack 등 다양한 채널을 통해 AI와 대화하세요. (오늘은 가장 쉬운 Telegram으로 연결해볼 거예요)
컴퓨터에서 프로그램을 실행하거나 웹을 검색하고, 파일을 읽고 쓰는 등 에이전트가 다양한 도구를 사용하게 하세요.
시간이 지남에 따라 더 똑똑해지도록 사용자에 대한 정보를 기억하게 하세요. (나를 가장 잘 아는 AI가 탄생합니다)

기본적으로 컴퓨터 안에 사는 똑똑한 로봇 친구가 있어서 무엇이든 도와줄 수 있는 것과 같다고 보시면 됩니다 🙂

OpenClaw 설치 전 준비물

시작하기 전에 — 준비물 (지루할 수 있지만 정말 중요한 부분이니 자세히 살펴보세요.)

1. 컴퓨터
다음 중 하나의 PC가 필요합니다:
• Mac Mini (또는 맥 스튜디오, 맥북도 가능)
• Windows PC (WSL2 사용을 강력 추천합니다. 가장 안정적입니다.)
• Linux (ubuntu 추천)

2. Node.js (버전 22.14 이상, 24 권장)
Node.js는 컴퓨터에서 JavaScript 프로그램을 실행할 수 있게 해주는 도구입니다. OpenClaw는 JavaScript로 구축되었기 때문에 제대로 작동하려면 Node.js가 필요합니다. nvm을 사용하면 버전 관리가 편리합니다.

# nvm 설치:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# Node.js 24 설치:
nvm install 24

# 버전 확인:
node --version

3. AI 서비스(LLM) 계정
OpenClaw가 진정으로 똑똑해지려면 AI 서비스와 통신해야 합니다. 온보딩 마법사에서 아래 옵션 중 선택할 수 있습니다:

OpenAI Codex (ChatGPT OAuth) — 브라우저 로그인으로 가장 간편 (기본 월 $20) ⭐ 추천
OpenAI API key — 직접 API 키 입력
Anthropic Claude — Claude CLI 또는 API 키
Google (Gemini) — Google AI API 키
xAI (Grok), MiniMax, Moonshot, StepFun 등
Ollama — 로컬 오픈 모델 (무료, GPU 필요)
Custom Provider — OpenAI/Anthropic 호환 API면 모두 연결 가능

OpenClaw는 설치 후에도 openclaw configure 명령어로 언제든 AI 제공 업체를 변경하거나 추가할 수 있습니다.

4. 약 5~10분의 시간
과거보다 많이 간편해졌습니다. 단계별로 따라하시기만 하면 됩니다!

1부: OpenClaw 설치

1단계: 터미널/명령 프롬프트 열기

2단계: OpenClaw 설치

Mac / Linux 사용자:

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

Windows (PowerShell) 사용자:

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

3단계: 설치가 완료될 때까지 기다리세요
화면에 많은 텍스트가 스크롤되는 것을 보실 수 있습니다. OpenClaw 다운로드 → 필요한 구성 요소 설치 → 모든 것 설정 순서로 진행됩니다.

4단계: 제대로 작동하는지 확인하기

openclaw --version

버전 번호(예: 2026.xx.xx)가 보이면 성공한 겁니다! 🎉

(Docker, Nix, npm 등 다른 설치 방법은 공식 설치 문서 참고)

2부: 온보딩 마법사로 OpenClaw 설정

OpenClaw가 설치되었지만, 아직 AI 서비스 연결이나 게이트웨이 설정이 되어 있지 않습니다. 이제 온보딩 마법사로 모든 설정을 한 번에 끝냅시다.

1단계: 온보딩 마법사 실행 (데몬 설치까지 한 번에)

openclaw onboard --install-daemon

--install-daemon 옵션을 추가하면 OpenClaw를 항상 백그라운드에서 실행하는 데몬(시스템 서비스)도 함께 설치합니다. 이 옵션을 꼭 사용하세요!

2단계: 마법사를 따라가세요 — QuickStart vs Advanced

온보딩 시작 시 QuickStart와 Advanced 중 선택할 수 있습니다. 처음 설치라면 QuickStart를 추천합니다.

QuickStart (권장) — 기본값으로 빠르게 진행. 로컬 게이트웨이, 자동 토큰 인증, Workspace 기본 경로
Advanced — 모든 단계를 하나씩 직접 설정 (포트, 바인드 주소, 채널, 데몬, 스킬 등)

Step 1. 약관 동의 (Agree 선택 후 Enter)

Step 2. “어떤 AI 제공 업체를 이용하고 싶으신가요?” — 원하는 AI 서비스 선택. OpenAI Codex (ChatGPT OAuth)가 가장 간편합니다.

Step 3. OpenAI Codex를 선택했다면 — 브라우저에서 OpenAI 로그인 후 인증 → 리다이렉트 URL을 터미널에 붙여넣기. (API key를 직접 입력하는 방식도 가능합니다.)

Step 4. 채널 선택 — Telegram 선택 (설정이 가장 간편합니다)

텔레그램 봇 생성하기:
1) 텔레그램을 열고 @BotFather를 검색하세요
2) BotFather에게 /newbot을 입력하세요
3) 봇 이름 입력 후 Enter
4) 봇 아이디 생성 (마지막은 bot으로 끝나야 합니다)
5) 받은 토큰을 OpenClaw에 붙여넣기

Step 5. 게이트웨이 설정 — 포트(기본 18789), 인증(자동 토큰 생성) 등은 QuickStart가 자동 처리합니다.

Step 6. 데몬 설치 — macOS는 LaunchAgent, Linux/WSL2는 systemd, Windows는 Scheduled Task가 자동 설치됩니다. 백그라운드에서 OpenClaw가 계속 실행됩니다.

Step 7. 건강 체크 및 스킬 설치 — 자동으로 진행됩니다.

3부: OpenClaw가 잘 작동하는지 확인하기

게이트웨이 상태 확인:

openclaw gateway status

게이트웨이가 포트 18789에서 정상 작동 중인지 확인합니다.

Control UI(대시보드) 열기:

openclaw dashboard

브라우저에서 Control UI가 열립니다. 여기서 바로 AI와 채팅해볼 수 있습니다.

텔레그램으로 AI와 대화하기

온보딩에서 텔레그램을 설정했다면, 이제 텔레그램 봇에게 말을 걸어보세요.

AI가 응답할 거예요! 🙂

축하합니다!!! OpenClaw🦞 설정이 성공적으로 완료되었습니다! 🎉

저의 Agent 이름은 Chloe입니다. 채팅 창에 쓰여 있는 것처럼 몇 가지 일들을 시키고 있어요. 일부는 자동화 스케줄로, 일부는 함께 워크플로우를 만들어가면서 말이죠.

가능성이 무궁무진한 OpenClaw의 세계에 여러분도 한번 빠져보시길 바라면서.. 이만 마칩니다.

외부 참고 자료:
• OpenClaw 공식 문서 — 매우 상세한 설치 및 활용 가이드
• Getting Started — 5분 퀵셋업 가이드
• ClawHub — 멋진 스킬들을 찾아보세요!