오픈클로(OpenClaw) 나도 한 번 설치해 볼까?

오픈클로(OpenClaw) 나도 한 번 설치해 볼까?

1970년 1월 1일 (목)

인터넷 커뮤니티를 뜨겁게 달구는 최신 AI 에이전트 ‘오픈클로(OpenClaw)’.

​“뭔가 신기한데… 나도 써보고 싶은데…”​

영상이나 글을 보면 혹하지만, 막상 시작하려니 검은 터미널 창과 영어 명령어가 가득해서 망설여지셨죠?

너무 궁금해서 미칠 것 같은 ‘비개발자’ 얼리 어댑터 분들을 위해서, 설치부터 실행까지 그림과 해설을 통해 최대한 쉽게 풀어드립니다.

한 시간만 투자하시면, 분명 간단한 경험은 하실 수 있을 거예요.

저도 모든 걸 알지는 못하기 때문에, 도전해 보시고 후기 댓글로 남겨주시면 함께 배워가겠습니다!


1. 오픈클로(OpenClaw)란?

이미지

현재 인공지능(AI)이라는 단어는 상당히 광범위하게 사용되기 때문에, 오픈클로가 구체적으로 AI 중 어떤 기능을 담당하는지 언뜻 이해하기가 어렵습니다.

가장 큰 오해는, “오픈클로가 뭐든 다해준다니까 가장 똑똑한 AI 아니야?”라는 것.

오픈클로는 두뇌가 아닌, ‘몸체(손과 발)’입니다.

우리가 평소에 자주 사용하고 익숙한, 최신 AI(ChagGPT, Gemini, Claude 등)의 ‘두뇌’를 오픈클로에게 주는 것이죠. 그러면, 오픈클로는 내 컴퓨터에서 자율적으로(혹은 나의 지시에 따라) 파일을 정리하거나 검색하는 나의 ‘손과 발’이 되어줍니다.

또한, 텔레그램이나 왓츠앱, 슬랙, iMessage와 같은 메신저를 통해, 내가 어디에 있든 나의 컴퓨터(에 설치된 오픈클로)와 자유롭게 의사소통을 할 수 있습니다.


2. 사전 준비

2-1. 설치 가능한 컴퓨터

이미지

그럼, 오픈 클로는 엄청난 고성능 컴퓨터에서만 돌아가나요?

결론은, “아니요. 완전 구식 컴퓨터에서도 잘 돌아갑니다.”​

단, 오픈클로의 개발자가 원래 iOS(맥의 운영체제) 관련 개발자였던 것과, 여러 가지 보안과 연동상의 문제로 Mac이 가장 설치가 쉽습니다. 그래서 북미에서는 Mac mini 품귀현상까지 벌어지고 있다고 하죠.

​(우리에게 가장 친숙한 Windows에서도 가능은 한데, 약간의 추가 설정이 필요합니다. 뒤에 상세히 알려드릴게요.)​

물론, 어느 정도 컴퓨터 지식이 있으신 분들은 자기의 개인 컴퓨터뿐 아니라, 인터넷상의 클라우드 서버를 빌려서 설치할 수도 있습니다.

초보자라면 일단 가지고 계신 노트북이나 데스크톱에 먼저 깔아보시는 걸 추천드립니다.

중요: 메인으로 사용하는 컴퓨터가 아닌, 서브 컴퓨터에 설치하는 것을 권장!


2-2. 기본 환경 설치 (좌절 금지)​

이미지

OpenClaw가 움직이려면 기본 엔진이 필요합니다.

바로 ‘Node.js(노드제이에스)’라는 녀석인데, 아마 처음 들어보신 분들도 많으실 겁니다.

개발자들 사이에서는 기본 중의 기본과 같은 개념이라 따로 설명을 드리기가 오히려 어색한데,

Node.js는 JavaScript라는 프로그래밍 언어를 브라우저 밖에서도 실행시켜 주는 ‘환경’입니다.

덕분에 웹사이트 서버부터 자동화 도구(오픈클로와 같은)까지 JavaScript 하나로 만들 수 있죠.

프로그래밍 언어에는 수백 가지가 있는데, 여러 가지 편의성 덕분에 JavaScript가 오픈클로에도 사용되고 있기에 오픈클로를 설치하기 전에 우리는 미리 Node.js라는 환경이 필요합니다.

그러면, 내 컴퓨터에 이게 있나 확인해 볼까요?

​(이 가이드를 여기까지 읽으시는 분들이라면 없을 가능성이 큽니다.)​

까만 창 터미널을 열고,

​(여는 방법은 버튼 클릭하거나 단축기만 누르면 되는데, 컴퓨터마다 다르기 때문에 구글로 검색하거나 AI친구에게 물어보세요.)​

node -v

라고 쳐보세요.

숫자가 나오면 합격! 에러가 뜨면,

https://nodejs.org/ko/download 가서 다운로드만 하면 끝입니다.

단, 다운로드 페이지부터가 상당히 불친절하니 좌절하시지 말고 댓글로 질문을 주시거나, 우리의 친구 AI에게 물으면서 진행하면 좋을 것 같습니다.

중요: 윈도우에 설치하실 분들은 [윈도우에 설치 시 주의사항] 을 미리 확인하세요.


2-3. AI서비스 연동 준비 (지갑 준비)​

이미지

혹시 벌써 좌절하셨나요?

여기서부터 또 이해하기 어려운 개념이 하나 등장합니다.

API키...

역시 개발자들에게는 너무나 친숙해서, 그 누구도 설명할 생각조차 하지 않는 개념인데요.

쉽게 말하자면, 어떤 프로그램(서비스)의 기능을 본래 용도가 아닌, ‘나만의 앱’을 만들 때 사용할 수 있는 권한입니다.

너무 편리하죠? 다른 회사에서 만든 엄청난 기능들을 API키만 발급받으면, 내가 만든 전용앱에서 자유롭게 쓸 수 있다는 개념. 단, 여기에는 한 가지 큰 함정이 있습니다.

바로 ‘비용’​

오픈클로는 완전히 무료이지만, 오픈클로에 두뇌를 연결하기 위해서 우리가 좋아하는 ChatGPT나 구글 Gemini, 앤트로픽 Claude 같은 AI들을 연결하려면, 각 회사에서 API키를 발급받고, 따로 사용료를 지불해야 합니다. 또한, 이 비용은 월구독료와는 완전 별개이며, 종량제라서 사용한 만큼 돈을 지불합니다. 안 쓰면 0원, 많이 쓰면 수십만 원이 과금될 수도 있는 거죠.

또한, 신용카드 번화와 같이 이 API키가 도용당하거나 유출되면, 남들이 마음대로 사용할 수도 있습니다.

너무 겁을 드렸나요?

막상 해보면, 어렵지는 않습니다.

발급 과정도 오픈 AI나 구글 사이트에 신용카드를 등록해서 발급버튼만 누르면 되고(10분도 안 걸림),

사용료도 많이 안 쓴다면, 1달에 몇 만 원도 안 나올 겁니다.


2-4. 윈도우에 설치 시 주의사항 (맥을 추천)​

이미지

윈도우 쓰시는 분들, 잠깐만요!

기본으로 있는 파란 화면(파워셸)이나 까만 화면(CMD)에 그냥 설치하면 오류가 대량으로 발생할 가능성이 큽니다.

우리에게는 너무나 친숙한 윈도우지만, 개발자들은 기본적으로 별로 선호하지 않기에, 윈도우 안에 리눅스라는 새로운 OS를 입주시키는 ‘WSL2’ 기능을 써야 하죠.

역시 어렵지 않아요. 관리자 권한으로

wsl --install

만 치면 ‘리눅스 Ubuntu(우분투)’가 짠! 하고 설치됩니다.


2-5. 꼭 알아야 할 안전 수칙 (안 읽으면 후회함)​

이미지

API키의 비용에 대해서는 이미 말씀드렸지만, 조금 더 상세히 안전 수칙을 짚고 넘어가죠.

초보자가 가끔 겪는 함정이 “얼마 안 썼는데, 왜 이렇게 요금이 많이 나왔지?”라는 상황.

즉, 나는 오픈클로를 설치해서 몇 번 쓰고 말았는데, API 사용료가 몇 십만 원 나왔다는 경우죠.

컴퓨터 프로그램에는 무한루프라는 개념이 있습니다. 쉽게 말하자면 ‘먹통’이 되었다는 건데, 멈춰버린 게 아니라, 영원히 계산(생각)하는 상황에 빠져버린 거죠.

이 경우, AI가 작업한 결과에 비해 지나치게 많은 생각(모두 다 비용)을 해서, 과금 폭탄을 맞을 우려가 있습니다.

다행히 모든 AI 사이트 설정에는 ‘한 달에 10달러까지만!’처럼 한도(Limit)를 걸어둘 수도 있고, 메일 등으로 일정 사용량이 넘으면 경고가 오도록도 설정할 수 있기 때문에 주의 깊게 본다면 큰 문제는 없습니다.

페어링에 관한 설명은 [2-8. 주인님 맞으세요? (페어링)] 를 참조하세요.


2. 설치하기

2-1. 설치 가능한 컴퓨터 (이제 재미있어짐)​

이미지

자, 이제 영화 속 해커처럼 ‘터미널’을 열어봅시다.

겁먹지 마세요, 그냥 아주 원시적인 채팅창입니다.

Mac: Command + Space 누르고 Terminal 검색

Windows: 아까 설치한 Ubuntu 앱 실행!


2-2. 설치 주문 외우기 (너무 쉬움)​

이미지

터미널 창에 OpenClaw를 소환하는 주문을 입력합니다.

npm install -g openclaw@latest

이 영어 문장을 복사해서 붙여 넣고 엔터(Enter) 쾅!

그냥, 인터넷에서 프로그램 다운로드하고 더블클릭해서 설치하는 것과 동일한 작업인데,개발자들은 어려운 길을 선호합니다.

글자들이 막 지나가면서 설치될 겁니다. 잠시만 기다려 주세요.


2-3. 친절한 마법사님 소환 (더 쉬움)​

이미지

설치는 됐는데 설정이 막막하시죠?

오픈클로의 개발자는 그나마 상식이 있는 ‘친절한’ 개발자입니다.

AI 에이전트
사용자가 부여한 목표를 달성하기 위해 자율적으로 판단하고 작업을 수행하는 지능형 소프트웨어 시스템
노드
병렬 또는 분산 컴퓨팅에서 노드는 계산에 참여하는 하나의 서버 또는 머신 단위이며, 보통 하나 이상 CPU나 GPU를 포함합니다.
OpenClaw
자율형 디지털 비서(AI 에이전트)를 배포하고 운영할 수 있게 해주는 AI 에이전트 플랫폼으로, ClawHub라는 마켓플레이스를 통해 에이전트 스킬을 공유하고 관리할 수 있습니다.
NPM
자바스크립트 프로그래밍 언어를 위한 패키지 관리자이자 세계 최대 규모의 소프트웨어 레지스트리다.
ChatGPT
OpenAI가 개발한 대화형 AI 챗봇으로, 질문을 이해하고 글로 답변을 생성합니다.