OpenClaw 맥미니 설치하기 1편 - node 배경 지식 및 설치

준석 Adam
1일 전
3분 분량

고객사들에게 양질의 정보를 제공하고 서비스의 질을 높이기 위해 OpenClaw를 사용하기로 마음먹고 지금 일요일 새로 산 맥 미니 앞에 앉았습니다.

(OpenClaw은 특정 하드웨어에 종속되지 않는 Node 기반 애플리케이션이므로 맥미니가 반드시 필요한 것은 아닙니다.

다만 저는 기존 업무 환경의 데이터를 보호하고 실험 환경을 분리하기 위해 별도의 개발 환경을 구축했습니다.

또한 일부 웹사이트는 데이터센터 IP 기반 자동화 트래픽을 제한하기 때문에, 사무실의 고정 IP 환경에서 로컬 서버를 운영하는 방식이 브라우저 자동화 테스트에 더 안정적일 수 있습니다)

사전에 읽어야 할 정보 사전 정보

1 - Node란 무엇인가

OpenClaw 설치 과정을 따라가다 보면 가장 먼저 등장하는 것이 Node(Node.js) 입니다.Node는 쉽게 말해 자바스크립트를 컴퓨터에서 실행할 수 있게 해주는 프로그램입니다.

원래 자바스크립트는 웹 브라우저 안에서만 실행되는 언어였습니다. 예를 들어 우리가 웹사이트에서 버튼을 누르면 화면이 바뀌거나, 입력한 값이 실시간으로 검사되는 기능들이 자바스크립트로 동작합니다.

하지만 브라우저 밖에서는 자바스크립트를 실행할 수 없었습니다.이 한계를 해결하기 위해 등장한 것이 Node.js입니다.

Node.js가 등장하면서 자바스크립트는 더 이상 웹 브라우저 안에만 머무르지 않고 다음과 같은 일을 할 수 있게 되었습니다.

서버 프로그램 만들기
파일을 읽고 쓰기
다른 프로그램 실행하기
인터넷에서 데이터를 가져오기
자동화 프로그램 만들기

즉 Node는 자바스크립트를 웹사이트가 아니라 컴퓨터 자체에서 실행하게 해주는 실행 환경(runtime)이라고 이해하면 됩니다.

OpenClaw가 Node로 만들어졌다는 뜻

OpenClaw 문서를 보면 “Node 기반 애플리케이션”이라는 표현이 나옵니다.이 말은 OpenClaw의 내부 코드가 자바스크립트로 작성되어 있고, 그것을 실행하기 위해 Node가 필요하다는 의미입니다.

조금 더 쉽게 설명하면 다음과 같습니다.

컴퓨터 프로그램은 보통 이렇게 구성됩니다.

프로그램 코드
그 코드를 실행하는 프로그램

예를 들어

Python 프로그램 → Python 실행 환경 필요
Java 프로그램 → Java 실행 환경 필요
Node 프로그램 → Node 실행 환경 필요

OpenClaw도 같은 구조입니다.

OpenClaw 코드 > Node가 실행 > OpenClaw 프로그램 동작

따라서 OpenClaw를 실행하려면 먼저 Node를 설치해야 하는 이유가 바로 이것입니다.

2 - Node가 하는 역할 및 Node 설치

OpenClaw이 Node 위에서 실행되면 Node는 다음과 같은 역할을 합니다.

OpenClaw 프로그램을 실행한다
파일 읽기/쓰기 기능을 제공한다
인터넷 요청을 처리한다
다른 시스템 명령을 실행할 수 있게 한다

OpenClaw은 이런 기능들을 이용해

웹 검색
파일 읽기
브라우저 자동화
메시지 전송
자동화 작업

같은 기능을 수행합니다.

쉽게 비유하면

비유를 들면 이렇게 생각할 수 있습니다.

Node = 프로그램을 실행하는 엔진
OpenClaw = 그 엔진 위에서 돌아가는 자동차

즉 Node는 플랫폼, OpenClaw은 그 위에서 돌아가는 프로그램입니다.

그래서 OpenClaw 설치 과정에서 항상 Node 설치가 먼저 등장하는 것입니다.

정리

OpenClaw 설치 과정에서 Node가 필요한 이유는 다음과 같습니다.

Node는 자바스크립트를 컴퓨터에서 실행할 수 있게 해주는 프로그램이다.
OpenClaw은 자바스크립트(Node) 기반으로 만들어진 애플리케이션이다.
따라서 OpenClaw를 실행하려면 먼저 Node 실행 환경이 필요하다.

즉 Node는 OpenClaw이 동작하기 위한 기반 환경이라고 이해하면 됩니다.

3- Mac에서 OpenClaw 설치하기 (Node가 없는 상태 기준)

OpenClaw은 Node.js 기반 애플리케이션이기 때문에 먼저 Node를 설치해야 합니다.이 글에서는 Homebrew만 설치되어 있는 맥 환경에서 OpenClaw를 설치하는 과정을 정리합니다. (Homebrew란 맥에서 특정 프로그램들의 다운로드 및 삭제, 버젼 관리를 쉽게 해주는 프로그램입니다.)

설치 순서는 아래와 같습니다.

1️⃣ Node 설치

2️⃣ Node 정상 설치 확인

3️⃣ OpenClaw 설치

4️⃣ 정상 실행 확인

1. Node 설치하기

OpenClaw은 Node.js 22 이상 버전이 필요합니다.

Homebrew가 이미 설치되어 있다면 아래 명령으로 Node를 설치할 수 있습니다.

brew install node@22

해당 명령어는 ""~/.zshrc 파일에

export PATH="/opt/homebrew/opt/node@22/bin:$PATH"

라는 줄을 추가"" 라는 뜻으로, 노드를 이제 손쉽게 사용하겠다고 말해주는 뜻입니다.

설치가 완료되면 Node를 시스템에 연결합니다.

brew link node@22 --force --overwrite

2. Node 설치 확인

Node가 정상적으로 설치되었는지 확인합니다.

node -v

정상적으로 설치되었다면 아래와 같은 형식의 결과가 나옵니다.

v22.x.x

npm도 함께 설치됩니다.

npm -v

npm은 Node 패키지를 설치하는 도구입니다.

3. OpenClaw 설치

Node가 준비되었다면 이제 OpenClaw를 설치할 수 있습니다.

npm install -g openclaw

여기서

npm → Node 패키지 관리자
install → 설치
-g → 전역(global) 설치

를 의미합니다.

전역 설치를 하면 OpenClaw 명령어를 어디서든 사용할 수 있습니다.

4. OpenClaw 설정 파일 확인

OpenClaw의 설정 파일은 아래 위치에 생성됩니다.

~/.openclaw/openclaw.json

이 파일에는 다음과 같은 설정들이 들어 있습니다.

tools 권한
skills 설정
메시지 채널
자동화 설정

필요하면 직접 수정할 수 있습니다.

5. OpenClaw 정상 실행 확인

OpenClaw daemon이 정상 실행 중인지 확인합니다.

openclaw status

정상적으로 실행되고 있다면 상태 정보가 표시됩니다.

6. 설치 완료

여기까지 완료되면 OpenClaw CLI 설치가 완료됩니다.

하지만 OpenClaw이 실제로 동작하려면 Gateway 설정과 초기 onboarding 과정이 필요합니다.

다음 글에서는 openclaw onboard 명령을 통해 OpenClaw을 실제로 실행하는 과정을 진행해 보겠습니다.