[OpenClaw 설치] 초기 상태 맥미니에서 OpenClaw(구 Moltbot) 설치부터 구동까지

※ 최초 포스트 발행 이후, 계속해서 최신(2026년 2월 7일 기준) 내용으로 업데이트하고 있습니다. 안심하고 따라 하셔도 됩니다. 혹시 잘 안 되면 댓글 남겨 주세요.

들어가는 말

출처: https://openclaw.ai/

요즘 핫한 OpenClaw(구 MoltBot, 구구 ClawdBot)를 설치해 보고 싶어서 바로 당근으로 맥미니를 하나 구했다. 급한 마음에 MDM이 걸려 있는 걸 확인도 안 하고 송금부터 하는 바람에 고생을 좀 했다. 업무용으로 쓰던 거라 깨끗하다는 문구를 봤을 때 알아챘어야 했는데.. 아무튼 지금은 잘 해결됐다.

글의 대상층과 난이도

포스트 제목 그대로 맥미니에 OpenClaw를 설치하고, 기본적으로 터미널을 기반으로 한다. 따라서 이 글은 맥을 사용해 본 적이 있고, 터미널을 실행은 할 줄 아는 분을 대상으로 한다. 스크린샷을 많이 넣었고 설명도 풀어서 최대한 자세하게 했다. 따라서 개발자(주니어 포함)에게는 너무 쉬울 것이고, 비개발자도 내용을 전부 이해하지 못하더라도 그대로 따라만 하면 설치에 성공할 수 있다. 그리고 중간중간 개인적인 경험담이나 썰렁한 농담들이 들어가 있는데 가볍게 못 본 척하고 넘어가시면 된다.

 

OpenClaw 설치 전 준비 작업

1. OpenClaw 설치용 기기 사양 추천

당근 해 온 맥미니의 사양은 Apple M2(Pro 아님), 메모리 16GB, SSD 512GB이다. 아래 페이지를 참고해서 구매했다. 참고로 공식 홈페이지인 줄 알았는데 뒤늦게 'moltbotai.onl is an unofficial guide' 문구를 발견했다. 아흑..

https://www.moltbotai.onl/moltbot-mac-mini#which-model

MoltBot AI: The Ultimate Personal AI Assistant Guide

공홈은 아니지만 아래와 같이 수긍될 만한 기준으로 16GB 메모리, 512GB SSD를 갖춘 맥미니 M2를 가장 가성비가 좋은 기기로 추천하고 있다.

• 16GB 메모리: 브라우저를 끊김 없이 자동 제어하는 데에 충분함.
• 512GB SSD: 대화 기록 및 Skill을 모두 기록하는 데에 적당
• M2 칩: OpenClaw(구 MoltBot)의 모든 기능을 동작시키는 데에 충분함.
• 파라미터 7B 정도의 Ollama 같이 작은 모델을 로컬로 돌릴 수 있음.

M2의 구체적인 사양은 아래 애플 공홈 참고.

https://support.apple.com/ko-kr/111837

Mac mini(2023년) - 기술 사양 - Apple 지원 (KR)

 

2. MDM 락 해제 성공, 중고 맥미니 구매 시 주의사항

TMI지만 다른 분들은 비슷한 일을 겪지 말라는 의미에서 좀 더 썰을 푼다. 당근 거래를 학교 근처에서 했다. 아무리 해도 lock이 안 풀려서 환불받으려고 가는 중이었는데, 판매자에게 다시 한번만 해보라는 연락이 왔다. 회사 IT 담당자와 연락이 돼서 제대로 락을 해제했단다. 급하게 학교 도서관에 자리를 잡고, 사물함에 있던 포터블 모니터를 꺼내서 연결하고 맥미니를 부팅시켰다.

드디어 "Your Mac is activated.'라는 문구가 뜨며 다음 단계로 넘어갔다! 눈물이 날 것만 같았다.

https://support.apple.com/ko-kr/guide/security/sec013b5d35d/web

MDM(Mobile Device Management) 보안 개요

MDM(Mobile Device Management) 락은 기업이 보안을 위해 원격으로 기기 사용을 제한하는 기능이다. 해제하려면 등록된 IT 부서를 통해 Apple Business Manager 등에서 기기를 제거해야 한다. OpenClaw 때문에 맥미니 대란이 발생해서 나처럼 중고로 구매하려는 분들도 많을 듯하다. 보통은 iCloud의 기기 목록에서 삭제하면 끝이지만 MDM 락은 이것만으로 안 된다. 꼭 확인하고 구매하시기 바란다.

 

3. OpenClaw 홈페이지 접속, 설치 문서 확인

반응형

설치는 아래 OpenClaw 공홈(이번엔 진짜!)의 'Getting started - OpenClaw'를 참고해서 진행했다. 거의 깡통 수준의 맥미니에 설치하냐고 문서에는 없는 사전 준비 작업이 좀 필요했다. 이 부분을 포함해서 OpenClaw 설치 과정을 정리해 봤다.

https://openclaw.ai

OpenClaw — Personal AI Assistant

https://docs.openclaw.ai/start/getting-started

Getting started - OpenClaw

공홈 첫 페이지에는 아래 명령어 한 줄이지만 될 것처럼 쓰여있지만 실제 해 보니 그렇지는 않았다.

 

4. OpenClaw의 컴패니언 앱, OpenClaw.app 소개

OpenClaw CLI 기반을 설치 및 설정을 진행하고 있지만 잠깐 샛길로 빠진다. OpenClaw의 보조 툴로서 익숙한 GUI 환경에서 각종 설정 및 운영을 쉽게 할 수 있게 해주는 macOS 앱을 소개한다. OpenClaw의 git 저장소를 보면 최근 배포된 v2026.1.29 릴리즈부터 무려 dmg 파일로 macOS 앱이 같이 배포되고 있다.

https://github.com/openclaw/openclaw/releases/tag/v2026.1.29

Release openclaw 2026.1.29 · openclaw/openclaw

공홈에도 'Companion App'이라고 해서 macOS 앱 설치 메뉴가 생겼다. 개발 및 배포 속도가 정말 빠르다. 어느 기사를 보니 운영진이 AI가 작성한 코드를 보지도 않고 배포한다고 하더니 진짜인가 보다.

OpenClaw-2026.1.29.dmg 파일을 다운로드 받고 Applications 폴더로 이동시켜서 설치했다. OpenClaw 앱을 실행하면 오른쪽 그림과 같이 창이 뜬다.

 

베타 버전이고 아직은 OpenClaw CLI가 중심에 있는 이 글의 성격에도 맞지 않아 실제 설치는 진행하지 않고, 여기서 멈춘다. 추후 별도 포스트에서 다룰 예정이다. 그런데 macOS 앱은 그렇다 치고 우리가 설치하려는 OpenClaw와 OpenClaw CLI가 같은 것을 가리키는 말일까? 이것도 한번 정리하고 가야 할 것 같다.

 

5. OpenClaw, 그리고 OpenClaw CLI의 개념과 관계

https://docs.openclaw.ai/

OpenClaw - OpenClaw

OpenClaw 문서 페이지의 Overview 섹션에서 가져온 구조도다.

OpenClaw는 위의 모든 구성 요소를 포함하는 개념이다. (한참 아래에서 실행할) 한 줄의 설치 명령어로 대부분의 구성 요소가 함께 설치된다. 그 중의 핵심은 'Gateway'인데 그림에서도 한가운데에 위치한다. 그리고 하나의 Gateway에 붙는 다수의 Node(클라이언트)가 있다. 각 구성 요소를 다시 간단하게 설명하면 아래와 같다.

• Gateway : 핵심 데몬, 백그라운드 프로세스 (WebSocket 서버)
• CLI : 사람이 Gateway와 소통하는 터미널 인터페이스
• macOS 앱 : 사람이 Gateway와 소통하는 GUI 인터페이스
• 텔레그램 봇 : 사람이 Gateway와 소통하는 메시징 인터페이스

더 자세히 설명하는 건 설치 및 구동을 이야기하는 이 글의 주제와 벗어나는 것 같아 이 정도로 한다. Gateway와 Node에 대한 더 자세한 내용은 아래 포스트에 정리했다.

2026.02.02 - [개발 스터디/AI - OpenClaw] - [OpenClaw 분석] 핵심 구성 요소 Gateway와 Node 개념 정리 (feat. macOS 앱)

[OpenClaw 분석] 핵심 구성 요소 Gateway와 Node 개념 정리 (feat. macOS 앱)

 

 

OpenClaw 설치

준비 과정이 좀 길었다. 이제 본격적으로 OpenClaw 설치를 시작한다.

OpenClaw 설치 - 필수 패키지 설치

말했다시피 깡통 맥미니라 기본적인 개발 도구 및 패키지를 모두 설치해야 했다.

1. Xcode Command Line Tool 설치

제일 먼저 'Xcode Command Line Tool'을 먼저 설치한다.

% xcode-select --install

2. nvm 설치 및 환경 변수 설정

이어서 nvm과 Node.js를 설치할 차례다. nvm은 Node.js의 버전을 관리하는 도구로 2026년 2월 7일 현재, 'v0.40.4'이 최신 버전이다. nvm GitHub 릴리즈 페이지에서 최신 버전을 확인할 수 있다. 아래 명령어로 nvm을 설치한다.

% curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

위 명령어는 "curl -o-"로 GitHub에서 nvm 설치 스크립트를 다운로드하고, "| bash"로 바로 실행한다는 의미다.

이 단계에서 nvm 자체의 설치는 완료됐다. 하지만 셸 프로필 파일(.zshrc, .bash_profile 등)을 못 찾아서 자동 설정이 실패한 상태다. 기본적으로 nvm 스크립트가 셸 프로필 파일을 찾아 필요한 내용을 자동으로 추가해 준다. 하지만 공장 초기화된 맥이라 셸 프로필 파일이 없어서 이 프로세스가 수행되지 못한 것이다. 설치 로그 메시지에서 시키는 대로 .zshrc 파일을 생성하고 명령어를 추가하는 작업을 진행한다.

용어 정리
- zsh : macOS는 Catalina(2019) 이후 zsh가 기본 셸이다. 혹시 본인의 셸이 뭔지 확인하려면 터미널에서 'echo $SHELL'을 입력하면 된다.
- 셸 프로필(.zshrc, .bash_profile 같은 파일) : 터미널을 열 때마다 자동으로 실행되는 설정 파일이다. 환경변수나 경로 설정 등을 여기에 넣어두면 매번 다시 입력할 필요가 없다.

아래 명령어를 실행해서 .zshrc 파일을 직접 만든다. 참고로 nano는 리눅스 기반 OS의 셸 기반 텍스트 편집기다.

nano ~/.zshrc

위와 같은 편집기 창이 뜨는데 아래 명령어 두 줄을 복사해서 붙여넣기(Cmd-V)한다.

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

이어서 "ctrl(cmd 아님!)+O" 키를 누르면 위와 같은 화면이 뜨는데 엔터키를 눌러서 저장한다. 화면상에는 TAB이 저장인 것처럼 보이는데 엔터키를 눌러야 한다. 'ctrl+X' 키를 입력해서 nano 편집기를 빠져나온다. 터미널을 재시작(또는 source ~/.zshrc 명령어 실행)해서 nvm 설치 및 설정을 끝낸다. 아래와 같이 nvm 설치가 완료된 것을 확인할 수 있다.

% nvm --version
0.40.4

 

3. Node.js 설치

이어서 Node.js 다운로드 및 설치를 진행한다. 아래 페이지에 설치 파일(.pkg)를 다운로드 받아서 설치하는 쉬운 방법도 있다.

https://nodejs.org/ko/download

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

.pkg 파일을 다운로드 받으면 익숙한 GUI 환경에서 설치할 수 있지만 Node.js 버전을 하나만 쓸 수 있다. 앞에서 이미 설치한 nvm을 사용하면 여러 버전을 설치하고 자유롭게 전환할 수 있어서 개발 환경에서는 nvm 방식이 더 일반적이다. 게다가 OpenClaw CLI가 (당연히) 터미널 기반인 만큼 터미널과 친해지자는 의미에서 Node.js도 터미널에서 설치한다. 터미널에서 아래의 명령어를 실행해서 Node.js를 설치한다.

nvm install 22    # 안정적인 선택 (권장)
nvm install 24    # 최신 버전 (필자가 사용 중)

나는 Node.js 24 버전을 설치했는데, 공식 문서의 최소 요구사항은 'Node >= 22'이다. Node는 너무 최신 버전을 설치하면 오히려 불안정할 수 있기 때문에 22 버전으로 설치하는 것을 권한다. 뭐, 나는 아직까지 별다른 문제없이 잘 쓰고 있다.

Node.js 설치까지 완료됐다.

4. Homebrew 설치

마지막으로 Homebrew라는 도구를 설치한다. Homebrew는 macOS 및 Linux용 오픈 소스 패키지 관리자로, 터미널 명령어를 통해 소프트웨어를 쉽게 설치, 업데이트, 삭제할 수 있게 해주는 도구다. OpenClaw 설치 과정에서 Homebrew가 없으면 오류가 발생하므로 미리 설치해 둔다.

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

터미널에서 위의 명령어를 실행해서 Homebrew 설치를 진행한다.

위의 설치 로그 메시지 중  'Next steps:'에 PATH 설정 명령어가 표시된다. 이 명령어 전체를 그대로 복사해서 터미널에서 한 번에 실행한다.

echo >> ~/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv zsh)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv zsh)"

세 번째 줄의 명령어가 변경 내용을 현재 세션에 바로 적용하는 역할을 하기 때문에 터미널을 재시작할 필요는 없다.

 

OpenClaw 설치 - 다운로드 및 설치 진행

필수 패키지 설치는 완료됐고 이제 OpenClaw 설치를 진행한다.

(2026.02.05 업데이트) 동작에는 상관없지만 설치 스크립트 url이 'openclaw.bot'에서 'openclaw.ai'으로 변경됐다. 기존 'openclaw.bot'로 접속해도 리다이렉트 돼서 동작에는 문제가 없다.

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

 

터미널에서 위 명령어를 실행해서 'OpenClaw' 다운로드 및 설치를 진행한다.

'Installing OpenClaw 2026.1.29...' 이후에 변화가 없는데 잠시 기다리면 설치가 완료되고 빨간 글씨로 'I understand this is powerful and inherently risky. Continue?'라는 문장이 뜬다. 매트릭스의 빨간 약, 파란 약을 선택하는 것 같기도 하고.. 'Yes'를 선택하면 이후 뭔가 계속 선택해야 한다.

 

OpenClaw 설정

OpenClaw 설치는 완료됐고, 이제 각종 설정을 진행한다.

OpenClaw 설정 - 설치 완료, 기본 설정 진행

보안 관련 경고 문구들이 뜨는데 일단 Yes 또는 엔터 키를 입력해서 넘어간다. 설치 후에 운영 중에 설정하는 것이 가능하다. 보안 관련 내용은 추후 별도 포스트에서 다룰 예정이다.

1. Onboarding mode 및 LLM 모델 선택

오른쪽 이미지, 마지막 줄에 gateway 관련 Health check failed 오류 문구가 보인다. gateway는 remote, local 중 하나를 선택할 수 있는데 기본 값이 remote였던 것 같다. 내가 따로 local로 변경하지 않았는데 서비스가 잘 뜬 것을 보면 뒤에 이어지는 onboard 과정에서 자동으로 변경된 것 같다.

선택 및 설정이 필요한 모든 항목을 여기에 전부 쓰기는 어렵고 그럴 필요도 없을 것 같다. 주요 항목들은 아래와 같다.

• Onboarding mode: Manual과 QuickStart 중에 하나를 고른다. 일단 빨리 돌아가는 걸 보기 위해 'QuickStart'를 선택했다. 대부분의 설정 항목은 나중에 수정하는 것이 가능하다.
• Model/auth provider: 다양한 모델 및 공급사가 쭉 표시되는데, 내 경우 Claude Max 플랜을 구독 중이라 'Anthropic'을 골랐다.
• Anthropic auth method: API key 또는 OAuth token 중 하나를 고르면 된다. 'claude'가 Claude Code를 실행하는 명령어이기 때문에 당연히 Claude Code가 설치돼 있어야 한다.

2. Claude Code 설치

혹시 Claude Code가 설치돼 있지 않다면 터미널에서 아래 명령어를 실행해서 설치하면 된다.

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

Claude Code 설치에 대한 추가적인 내용이 궁금하다면 아래 공식 문서에서 확인할 수 있다.

https://code.claude.com/docs/ko/overview

Claude Code 개요 - Claude Code Docs

3. OAuth token 획득 및 적용

터미널에서 위의 명령어를 입력하면 인증에 필요한 OAuth token을 얻을 수 있다

claude setup-token

 

브라우저가 잠깐 떴다가 터미널에 위와 같이 노란색 글씨로 OAuth token이 표시된다. 이걸 복사해서 아래 그림과 같이 OpenClaw를 설치 중인 터미널에 붙여넣기 해서 쓰면 된다.

4. Anthropic token 인증 방식 관련 참고사항

다만 공식 문서(Getting Started)에는 아래와 같이 적혀있다.

"For Anthropic we recommend an API key; claude setup-token is also supported."

공식 권장은 API key 방식이고 token(OAuth) 방식은 '지원은 됨' 수준이라 나중에 막힐 가능성도 있으니 참고하시기 바란다.

 

OpenClaw 설정 - Telegram 채널 설정

쭉쭉 넘어가서 이제 OpenClaw와 통신할 채널을 설정하는 단계다.

오른쪽 이미지와 같이 Telegram, WhatsApp, Discord 등 수많은 채널을 지원하는데 Telegram이 제일 간단하다고 쓰여 있어서 고민 없이 선택했다. 공홈의 아래 문서를 참고해서 Telegram 설정을 진행했다.

https://docs.openclaw.ai/channels/telegram

Telegram - OpenClaw

telegram 앱을 실행하고 @BotFather 검색해서 대화 창을 연다. OpenClaw에만 국한된 것이 아니고 일반적으로 telegram에 봇을 추가하는 과정이라고 한다.

대화 창에 '/newbot' 입력해서 봇 생성을 시작한다. 이어서 봇 이름(예: My OpenClaw Bot)을 입력한다. 뭐라고 메시지가 뜨면 이번엔 봇의 username(예: myopenclaw_bot)을 입력한다. username은 반드시 _bot으로 끝나야 한다. username을 입력하면 길게 뭐라고 하는데 'Use this token to access the HTTP API:' 뒤에 붙은 토큰 값을 복사해서 잘 저장해 놓는다.

OpenClaw를 설치 중인 터미널로 돌아가서 저장한 토큰 값을 입력한다.

 

OpenClaw 설정 - Skills 설정

telegram 채널 설정이 완료됐다. 다음은 Skill 설정이다.

Skills는 웹 검색, 파일 작업, 브라우저 제어 등의 OpenClaw가 사용할 수 있는 도구들이다. Eligible 3개가 바로 설치 가능한 것들이고, Missing requirements 46개는 추가 설정이나 의존성이 필요한 것들이다. 일단 기본으로 진행하고 나중에 필요한 것을 추가하면 된다. Yes를 선택했다.

추가 설정이나 의존성이 필요한 skill 목록이 표시된다. 많다.. 'Skip for now'를 선택하고 다음으로 넘어갔다. skill은 사용 중에 필요성을 느끼면 손쉽게 바로 설치할 수 있다.

 

OpenClaw 설정 - 기타 설정

이번엔 GOOGLE_PLACES_API_KEY를 입력하라고 한다. 기본은 'No'로 선택돼 있고 이대로 넘어가도 무방하다. 나는 대략 한 달 전에 진행하다 멈춘 '구글 Advent of Agents 2025 따라 하기'에서 만들어 둔 Google Maps Key가 있어서 이걸 입력했다.

2025.12.25 - [개발 스터디/AI - Etc.] - 구글 Advent of Agents 2025 따라 하기 - Day 7) Code Execution

구글 Advent of Agents 2025 따라 하기 - Day 7) Code Execution

요금 폭탄을 맞는 건 아닌지 살짝 불안하다.

이번엔 이미지 생성에 사용할 Gemini API key를 입력하란다. 마침 이것도 며칠 전에 Claude Code에서 Imagen 스킬을 사용하는 작업을 할 때 생성해 둔 게 있다. 이런 우연이 있나!

2026.01.29 - [개발 스터디/AI - VibeCoding] - Claude Code - 구글 이미지 생성 Skill 설치 및 동작 확인

Claude Code - 구글 이미지 생성 Skill 설치 및 동작 확인

이어서 NOTION_API_KEY, OPENAI_API_KEY, ELEVENLABS_API_KEY 등은 입력하지 않고 넘어갔다.

다음으로 Hooks 설정인데 이것도 나중에 아래와 같이 설정할 수 있어서 일단 넘어갔다.

openclaw configure --section hooks

 

OpenClaw 설정 - 설정 완료, Gateway 재시작

이제 슬슬 끝이 보인다. 지금까지 적용한 항목들을 적용하기 위해서 Gateway를 재시작한다.

지금까지 설정한 내용들을 쭉 보여주고 있다.

설정은 모두 끝났고, 이제 여기서 엔터만 치면 OpenClaw가 구동된다. 나중에 내가 보려고 위에 그림으로 붙인 내용을 텍스트로도 남긴다.

Telegram: ok (@garibong_bot) (1107ms)
Agents: main (default)
Heartbeat interval: 1h (main)
Session store (main): /Users/garibong/.openclaw/agents/main/sessions/sessions.json (0 entries)
Missing Control UI assets. Build them with `pnpm ui:build` (auto-installs UI deps).
│
◇  Optional apps ────────────────────────╮
│                                        │
│  Add nodes for extra features:         │
│  - macOS app (system + notifications)  │
│  - iOS app (camera/canvas)             │
│  - Android app (camera/canvas)         │
│                                        │
├────────────────────────────────────────╯
│
◇  Control UI ────────────────────────────────────────────────────────────╮
│                                                                         │
│  Web UI: http://127.0.0.1:18789/                                        │
│  Web UI (with token):                                                   │
│  http://127.0.0.1:18789/?token=c**************************************  │
│  **********                                                             │
│  Gateway WS: ws://127.0.0.1:18789                                       │
│  Gateway: reachable                                                     │
│  Docs: https://docs.openclaw.ai/web/control-ui                          │
│                                                                         │
├─────────────────────────────────────────────────────────────────────────╯
│
◇  Start TUI (best option!) ─────────────────────────────────╮
│                                                            │
│  This is the defining action that makes your agent you.    │
│  Please take your time.                                    │
│  The more you tell it, the better the experience will be.  │
│  We will send: "Wake up, my friend!"                       │
│                                                            │
├────────────────────────────────────────────────────────────╯
│
◇  Token ────────────────────────────────────────────────────────╮
│                                                                │
│  Gateway token: shared auth for the Gateway + Control UI.      │
│  Stored in: ~/.openclaw/openclaw.json (gateway.auth.token) or  │
│  OPENCLAW_GATEWAY_TOKEN.                                       │
│  Web UI stores a copy in this browser's localStorage           │
│  (openclaw.control.settings.v1).                               │
│  Get the tokenized link anytime: openclaw dashboard --no-open  │
│                                                                │
├────────────────────────────────────────────────────────────────╯
│
◆  How do you want to hatch your bot?
│  ● Hatch in TUI (recommended)
│  ○ Open the Web UI
│  ○ Do this later

기본 값인 TUI가 선택된 상태로 엔터를 쳤다.

 

OpenClaw 구동

두근두근.. 드디어 OpenClaw 구동이다. 

기억도, 이름도, 내가 누군지도 아직 모르겠단다. 고정된 대사인 듯하지만 뭔가 심쿵했다.

웹 대시보드도 정상적으로 잘 뜬다. 이제 bot의 이름, 성격, 스타일 등을 정하고 임무를 내려 줄 차례다. 이 부분은 아래 포스트에서 이어진다.

2026.02.02 - [개발 스터디/AI - VibeCoding] - [OpenClaw 설치] 에이전트의 페르소나(세계관) 설정, 그리고 스몰토크까지

[OpenClaw 설치] 에이전트의 페르소나(세계관) 설정, 그리고 스몰토크까지

끝.

---

글이 도움이 됐다면 아래 공감(♥️) 아이콘 클릭 부탁드립니다^^