Open Claw 맥북 설치: npm 오류 해결 & 30분 완성

목차

• Open Claw가 뭔지 아직도 헷갈리시나요? (구 Moltbot, Clawdbot)
• 설치 전에 이것만은 꼭 확인하세요
• STEP 1: Node.js v22 설치 (맥북 기준)
• STEP 2: Open Claw 터미널 설치 명령어 실행
• STEP 3: 초기 설정 및 데몬 설치
• 윈도우에서는 어떻게 설치하나요? (WSL2 필수)
• ‘npm install moltbot’ 오류 해결 완벽 가이드
• Open Claw Gemini API 키 발급하는 법 (5분 완성)
• 당신만의 AI 비서, 이제 시작입니다
• 자주 묻는 질문 (FAQ)

Open Claw가 뭔지 아직도 헷갈리시나요? (구 Moltbot, Clawdbot)

Open Claw는 “채팅앱으로 내 컴퓨터를 제어하는 AI 에이전트”입니다. WhatsApp이나 Telegram에 메시지 보내듯 “바탕화면 스크린샷 찍어줘”, “Python 스크립트 실행해” 같은 명령을 날리면 LLM(대규모 언어 모델)이 알아서 처리해줍니다.

원래 이름은 Clawdbot → Moltbot → Open Claw 순서로 바뀌었어요. 그래서 지금도 터미널 명령어는 clawdbot으로 남아있어서 초보자분들이 “뭐가 진짜 이름이야?” 하고 혼란스러워하시죠. 2026년 1월 기준 공식 명칭은 Open Claw이고, npm 패키지는 openclaw 또는 clawdbot@latest 둘 다 작동합니다.

주요 기능은 이렇습니다:

• 파일 관리 (복사, 삭제, 검색)
• 프로그램 자동 실행
• 웹 스크래핑
• 시스템 모니터링 (CPU, 메모리 확인)

다만 Node.js 22 이상이 필수예요. 이전 버전에서는 설치 자체가 안 됩니다. 여기서 막히는 분들이 절반이에요.

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

바로 설치 명령어 입력하셨다가 오류 나서 돌아오신 분들 많으시죠? 아래 체크리스트 먼저 확인해야 시간 낭비 안 합니다.

소프트웨어 요구사항

• Node.js: v22 이상 필수. 터미널 열고 node --version 쳐보세요. v18이나 v20 나오면 업그레이드해야 합니다.
• 운영체제: macOS (M1/M2/M3 Apple Silicon 전부 지원), Windows는 WSL2 필수
• 터미널 기본 지식: cd, ls 정도는 알아야 따라오기 편합니다

필수 준비물

• LLM API 키: Google Gemini 또는 Anthropic Claude 키 (뒤에서 무료 발급 방법 알려드려요)
• 메신저 계정: WhatsApp, Telegram 등 연동할 계정

보안 경고

여기서 중요한 건, Open Claw는 PC 전체를 제어할 수 있는 권한을 갖습니다. 메인 맥북에 바로 설치하기보다 테스트용 서브 기기나 Docker 환경에 먼저 설치해보는 걸 강력히 권장해요. Reddit에서 “실수로 파일 다 날렸다”는 후기도 몇 개 봤거든요 (출처: Reddit r/LocalLLaMA).

STEP 1: Node.js v22 설치 (맥북 기준)

Node.js 버전 확인부터 해볼까요? 터미널 열고 이렇게 입력하세요.

node --version

v22.x.x 나오면 바로 다음 단계로 가시면 됩니다. v20 이하거나 “command not found” 나오면 설치해야 해요.

macOS에서는 Homebrew 쓰는 게 제일 편합니다. 복사해서 터미널에 붙여넣기만 하세요.

# Node.js 22 버전 설치
brew install node@22

# 환경 변수 설정 (중요!)
echo 'export PATH="/opt/homebrew/opt/node@22/bin:$PATH"' >> ~/.zshrc

# 설정 즉시 적용
source ~/.zshrc

# 설치 확인
node --version

여기서 주의할 점: echo 명령어로 PATH 추가 안 하면 나중에 clawdbot 명령어가 안 먹혀요. “설치했는데 command not found 뜨는데요?” 하시는 분들 대부분이 이 단계를 건너뛰셨습니다.

Intel 맥이든 M1/M2/M3든 Homebrew가 알아서 처리해주니 걱정 안 하셔도 돼요. (Homebrew 공식 문서 참조)

STEP 2: Open Claw 터미널 설치 명령어 실행

이제 본격적으로 Open Claw를 설치합니다. 여기서 혼란스러운 부분이 패키지 이름이에요. 예전 글들 보면 npm install moltbot 하라고 나오는데, 리브랜딩 후에는 openclaw로 바뀌었습니다.

공식 권장 방법은 설치 스크립트 사용이에요.

# 공식 스크립트로 자동 설치
curl -fsSL https://openclaw.ai/install.sh | bash

스크립트 실행이 불안하신 분들은 npm으로 직접 설치도 가능합니다.

# npm 글로벌 설치
npm install -g openclaw

또는 하위 호환성 유지하는 clawdbot 패키지로도 됩니다.

npm install -g clawdbot@latest

설치 완료되면 반드시 확인하세요.

clawdbot --version

버전 번호 나오면 성공입니다. “command not found” 뜨면 PATH 문제예요 (STEP 1 다시 확인).

npm 레지스트리에서 openclaw 패키지 확인해보시면 최신 버전 정보 나와있습니다.

STEP 3: 초기 설정 및 데몬 설치

설치만 하고 끝이 아닙니다. 온보딩 과정이 제일 중요해요. 여기서 API 키, 메신저 연동 등을 대화형으로 설정합니다.

clawdbot onboard --install-daemon

--install-daemon 옵션 꼭 붙이세요. 이걸 해야 맥북 재부팅해도 Open Claw가 백그라운드에서 자동 실행됩니다.

실행하면 이런 질문들이 나와요:

• “어떤 LLM 사용하시겠습니까?” → Gemini 또는 Claude 선택
• “API 키를 입력하세요” → 복사한 키 붙여넣기 (다음 섹션에서 발급 방법 설명)
• “메신저 연동하시겠습니까?” → WhatsApp 선택하면 QR 코드 나옴

맥북에서 꼭 해야 할 권한 설정
온보딩 중에 “터미널이 컴퓨터를 제어하려고 합니다” 같은 알림 뜹니다. 시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용으로 가서 터미널 앱에 체크해줘야 해요. 안 하면 명령어가 먹히지 않습니다.

윈도우에서는 어떻게 설치하나요? (WSL2 필수)

윈도우 사용자분들 실망하실 수도 있는데, Open Claw는 Windows를 네이티브로 지원 안 합니다. 반드시 WSL2(Windows Subsystem for Linux)가 필요해요.

PowerShell을 관리자 권한으로 열고 이렇게 입력하세요.

wsl --install

재부팅 후 Ubuntu 터미널이 생깁니다. 거기서부터는 리눅스 환경이니 아래 명령어 따라하시면 됩니다.

# WSL Ubuntu 터미널에서
# Node.js 22 설치
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# Open Claw 설치
npm install -g openclaw

# 온보딩
clawdbot onboard --install-daemon

Windows Task Scheduler로 WSL 시작 시 자동 실행 설정하면 편합니다. 다만 WSL 자체가 무겁고 복잡해서, 솔직히 맥이나 리눅스 환경이 훨씬 편해요.

‘npm install moltbot’ 오류 해결 완벽 가이드

여기가 제일 막히는 부분입니다. GitHub Issues 보면 설치 오류 질문이 절반 이상이에요. 유형별로 정리해드릴게요.

Case 1: EACCES: permission denied (권한 오류)

npm ERR! code EACCES
npm ERR! syscall mkdir
npm ERR! path /usr/local/lib/node_modules/openclaw
npm ERR! errno -13

npm이 글로벌 디렉토리에 쓰기 권한이 없어서 생기는 오류예요. sudo 붙여서 설치하는 건 보안상 권장하지 않습니다. 대신 이렇게 해보세요.

# 임시 해결책 (주의)
sudo npm install -g openclaw --unsafe-perm

# 장기적 해결책: nvm 사용
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22
npm install -g openclaw

nvm(Node Version Manager) 쓰면 권한 문제가 아예 안 생깁니다.

Case 2: gyp: No Xcode or CLT (macOS 빌드 도구 부재)

gyp: No Xcode or CLT version detected!

C++ 애드온 빌드할 때 필요한 Command Line Tools가 없어서 나는 오류예요. 해결 방법은 간단합니다.

xcode-select --install

팝업 뜨면 “설치” 누르고 10분 정도 기다리세요. 완료되면 npm install -g openclaw 다시 실행하면 됩니다.

Case 3: command not found: clawdbot (경로 문제)

설치는 성공했는데 명령어가 안 먹히는 경우예요. PATH 환경 변수에 npm 글로벌 경로가 안 들어가 있어서 그래요.

# npm 글로벌 경로 확인
npm config get prefix

# 출력된 경로를 PATH에 추가
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

터미널 완전히 종료했다가 다시 열어보세요. 그래도 안 되면 hash -r 명령어로 캐시 지우고 재시도.

디버깅 팁
Open Claw는 시스템 점검 명령어도 제공합니다.

clawdbot doctor

Node.js 버전, 권한, 의존성 문제를 자동으로 체크해줘요. 오류 메시지 보고 따라하시면 대부분 해결됩니다.

Open Claw Gemini API 키 발급하는 법 (5분 완성)

Open Claw는 LLM이 없으면 작동 안 합니다. 두뇌가 없는 거니까요. Google Gemini나 Anthropic Claude API 키가 필요한데, Gemini가 무료 할당량이 커서 추천해요.

Google Gemini API 키 발급 단계

1. Google AI Studio 접속 (구글 계정으로 로그인)
2. 좌측 메뉴에서 “Get API key” 클릭
3. “+ Create API key in new project” 버튼 누르기
4. 생성된 키를 복사해서 메모장에 저장 (다시 안 보여줍니다!)

키 받으셨으면 온보딩 중에 붙여넣으시면 돼요. 만약 온보딩 단계를 건너뛰셨다면 환경 변수로 직접 등록도 가능합니다.

export GOOGLE_API_KEY="여기에_복사한_API_키_붙여넣기"

영구적으로 저장하려면 .zshrc에 추가하세요.

echo 'export GOOGLE_API_KEY="your-api-key"' >> ~/.zshrc
source ~/.zshrc

Anthropic Claude 쓰고 싶으신 분들은
Anthropic Console에서 동일한 방식으로 발급받으시면 됩니다. 다만 Claude는 무료 크레딧이 적어서 테스트용으로만 쓰기 좋아요.

API 키 테스트는 온보딩 완료 후 간단한 명령어로 확인 가능합니다.

clawdbot -v

버전 정보 나오고 “LLM connected” 메시지 뜨면 성공입니다.

당신만의 AI 비서, 이제 시작입니다

여기까지 Open Claw 맥북 설치를 완료하셨다면 축하드립니다! Node.js 22 설치부터 API 키 연동, npm 오류까지 가장 막히는 부분들을 전부 통과하신 거예요.

설치는 시작일 뿐입니다. 이제부터 WhatsApp에 “오늘 작업한 파일 목록 보여줘”, “Python 스크립트 실행해줘” 같은 명령어로 실전 자동화를 경험하실 수 있어요. 처음에는 간단한 파일 조회부터 시작하시고, 익숙해지면 복잡한 워크플로우도 만들어보세요.

더 많은 정보는 Open Claw 공식 웹사이트와 GitHub 저장소에서 확인하실 수 있습니다. Discord 커뮤니티에서 다른 사용자들의 활용 사례도 공유되고 있으니 참고하시면 좋습니다. 막히는 부분 있으면 clawdbot doctor 명령어로 먼저 진단해보시고, 그래도 안 되면 GitHub Issues에 질문 남기시면 커뮤니티에서 도와줍니다.

이제 AI에게 지시하고, 여유 시간을 즐기세요.

자주 묻는 질문 (FAQ)

Q: Open Claw, Moltbot, Clawdbot은 다 다른 건가요?
A: 아니요, 전부 같은 프로젝트입니다. Clawdbot → Moltbot → Open Claw 순서로 리브랜딩됐어요. 2026년 현재 공식 명칭은 Open Claw지만, clawdbot 명령어는 하위 호환성 유지를 위해 그대로 남아있습니다. 둘 다 써도 상관없어요.

Q: M1/M2/M3 맥에서도 잘 돌아가나요?
A: 네, 완벽하게 지원합니다. Homebrew가 Apple Silicon 전용으로 자동 빌드해주니까 Intel 맥이랑 똑같이 설치하시면 됩니다. 성능은 오히려 더 좋아요.

Q: Open Claw 삭제하고 싶으면 어떻게 하나요?
A: 패키지 삭제는 간단합니다.

npm uninstall -g openclaw

데몬 서비스도 제거하려면:

clawdbot uninstall-daemon

launchd 설정 파일도 수동으로 지워주세요.

rm ~/Library/LaunchAgents/com.openclaw.agent.plist

Q: 보안이 걱정되는데, 안전한가요?
A: 솔직히 말씀드리면, PC 전체 제어 권한을 주는 거라 100% 안전하다고는 못 합니다. 공식 문서에서도 “프로덕션 환경에 바로 쓰지 말라”고 경고해요. 테스트는 Docker나 가상머신에서 먼저 해보시고, API 키는 환경 변수로만 관리하세요. GitHub에 절대 커밋하지 마시고요.

Q: 무료인가요?
A: Open Claw 자체는 오픈소스라 무료입니다. 다만 LLM API 사용량에 따라 Gemini나 Claude 비용이 발생할 수 있어요. Gemini 무료 티어는 일일 60 requests까지 가능합니다. (Google AI Studio 요금표 참조)