나도 AI 비서 한 명 뽑아볼까? - OpenClaw(구 Moltbot / Clawdbot) 완벽 설치 가이드

이름이 Clawdbot에서 Moltbot으로, 다시 OpenClaw로 바뀌는 우여곡절이 있었지만 그 기능만큼은 역대급입니다. 개발 경험이 있어야 해서 설치 과정이 다소 복잡해 보일 수 있지만, 이 가이드를 차근차근 따라오시면 누구나 '나만의 AI 비서'를 가질 수 있습니다. 필요하면 검색해가면 하나씩 ㅐ보죠.

1. 설치 전 반드시 준비해야 할 것들 (Prerequisites)

OpenClaw를 돌리기 위해서는 단순한 프로그램 실행 이상의 환경 세팅이 필요합니다. 아래 리스트를 먼저 체크해 주세요.

  • Python 3.10 이상: OpenClaw는 파이썬 기반으로 작동합니다. (버전 확인 필수!)

  • Git: 소스 코드를 내려받기 위해 깃(Git)이 설치되어 있어야 합니다.

  • 충분한 여유 사양: AI가 화면을 캡처하고 분석하므로, 너무 저사양 PC보다는 어느 정도 퍼포먼스가 나오는 환경을 권장합니다.

  • 다양한 LLM API 지원: * Anthropic API: 가장 표준적이고 성능이 확실하지만 유료입니다.

    • Google Gemini API: 최근 무료 티어 제공 및 강력한 비전 성능으로 OpenClaw 유저들이 가장 많이 찾는 대안입니다.

    • OpenAI API (GPT-4o): 범용성이 뛰어나며 안정적인 구동이 가능합니다.

    • Local LLM (Ollama 등): API 비용이 걱정되거나 보안이 중요하다면, 내 컴퓨터 자원을 사용하는 로컬 모델을 연동할 수도 있습니다. (단, 매우 높은 하드웨어 사양 요구)

2. 단계별 설치 프로세스 (Step-by-Step)

Step 1: 소스 코드 복제 (Git Clone)

가장 먼저 공식 깃허브 저장소에서 최신 소스 코드를 내 컴퓨터로 가져와야 합니다. 터미널(또는 CMD)을 열고 아래 명령어를 입력하세요.

git clone https://github.com/공식주소/openclaw.git (주의: 최근 스캠 사이트가 많으니 반드시 공식 저장소 주소를 확인하십시오.)

Step 2: 가상 환경 설정 및 라이브러리 설치

다른 프로그램과의 충돌을 방지하기 위해 파이썬 가상 환경을 만드는 것이 좋습니다.

  1. python -m venv venv 입력 (가상 환경 생성)

  2. source venv/bin/activate (맥/리눅스) 또는 venv\Scripts\activate (윈도우) 입력

  3. pip install -r requirements.txt 명령어로 필요한 라이브러리를 한 번에 설치합니다.

Step 3: API 키 및 환경 변수 설정

이제 내가 사용할 AI 모델의 정보를 OpenClaw에게 알려줘야 합니다. .env 파일을 메모장으로 열고, 본인이 선택한 모델 하나만 정확히 입력하세요. 

  • 옵션 A: Anthropic (기본형)

    PROVIDER=anthropic
ANTHROPIC_API_KEY=your_key_here
MODEL_NAME=claude-3-5-sonnet-20241022

  • 옵션 B: Google Gemini (가성비형)

    PROVIDER=google
GEMINI_API_KEY=your_key_here
MODEL_NAME=gemini-1.5-pro

  • 옵션 C: OpenAI ChatGPT (범용/성능형) 가장 대중적이며, 특히 시각 지능(Vision)이 안정적인 GPT-4o 모델을 사용하는 설정입니다. 

    PROVIDER=openai
OPENAI_API_KEY=your_openai_key_here
MODEL_NAME=gpt-4o

    팁: OpenAI API를 처음 사용하신다면 계정에 최소 5달러 이상의 크레딧(Credit)이 충전되어 있어야 'Rate Limit(속도 제한)' 에러 없이 쾌적하게 사용하실 수 있습니다.

  • 옵션 C: Ollama (로컬/보안형)

    PROVIDER=ollama
OLLAMA_BASE_URL=http://localhost:11434
MODEL_NAME=llama3.2-vision (비전 지원 모델 필수) 

주의: MODEL_NAME은 오타 하나만 나도 작동하지 않으니 공식 문서의 명칭을 그대로 복사해 넣는 것이 좋습니다.

3. 실행 및 초기 세팅 주의사항

모든 준비가 끝났다면 python main.py를 실행합니다. 처음 실행 시 AI가 화면 제어 권한을 요청할 수 있는데, 이를 반드시 허용해줘야 합니다.

※ 여기서 잠깐! 설치 중 오류가 발생한다면?

  • ModuleNotFoundError: 라이브러리 설치가 덜 된 경우입니다. pip install 과정을 다시 진행하세요.

  • API 접속 에러: API 키가 활성화되었는지, 혹은 계정에 잔액(Credit)이 있는지 확인해야 합니다.

4. 보안을 위한 필독 가이드 (중요!)

OpenClaw는 내 컴퓨터의 마우스와 키보드를 직접 제어합니다. 이는 편리하지만, 보안상 매우 강력한 권한을 부여하는 행위입니다.

  1. 샌드박스 환경 권장: 가급적이면 중요한 개인정보가 없는 서브 PC나 가상 머신(VM)에서 먼저 테스트해 보시길 권합니다.

  2. 공식 배포처 확인: 이름이 자주 바뀌는 틈을 타 악성 코드가 심어진 '가짜 설치 파일'이 돌고 있습니다. 반드시 검증된 깃허브 코드를 사용하세요.

  3. 로그 모니터링: AI가 어떤 명령을 수행하고 있는지 실시간 로그를 확인하는 습관을 들여야 합니다.

5. 윈도우(Windows) 환경 유저를 위한 특별 가이드

많은 분이 사용하는 윈도우 환경에서는 명령어나 경로 설정에서 오류가 발생하기 쉽습니다. 윈도우 사용자라면 아래 내용을 특히 주목해 주세요.

① 윈도우 전용 환경 구축 (PowerShell 활용)

윈도우의 '명령 프롬프트(CMD)'보다는 PowerShell을 관리자 권한으로 실행하는 것을 권장합니다.

  • 가상 환경 활성화: venv\Scripts\activate를 입력했는데 보안 오류가 뜬다면, Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser 명령어를 먼저 실행하여 권한을 풀어줘야 합니다.

② 환경 변수(Path) 설정의 중요성

파이썬 설치 시 'Add Python to PATH' 체크박스를 해제했다면, 터미널에서 python 명령어를 인식하지 못합니다. 이럴 때는 제어판의 '시스템 환경 변수 편집'에서 파이썬 경로를 직접 추가해 주거나, 파이썬을 재설치하는 것이 가장 깔끔합니다.

③ 윈도우 권한 승인 (UAC) 문제

OpenClaw가 마우스를 제어하려고 할 때 윈도우의 '사용자 계정 컨트롤(UAC)' 팝업이 뜨면서 동작이 멈출 수 있습니다.

  • 해결책: OpenClaw를 실행하는 터미널 자체를 '관리자 권한으로 실행' 하십시오. 그래야 AI가 시스템 창이나 다른 프로그램 위에서도 자유롭게 마우스를 움직일 수 있습니다.

  • Powershell 관리자 권한부여 명령어: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

④ 필수 도구: VS Code와 Terminal

메모장으로 코드를 수정하기보다는 **Visual Studio Code(VS Code)**를 설치하여 사용하시길 강력히 추천합니다. 에러 메시지를 확인하기 훨씬 수월하며, .env 파일 수정 시에도 가독성이 뛰어납니다.

마치며: 이제 당신만의 에이전트와 대화해 보세요

설치가 완료되었다면 이제 "내 컴퓨터에서 ~작업을 대신 해줘"라고 말해보세요. 단순한 챗봇을 넘어, 당신의 손과 발이 되어주는 놀라운 경험을 하시게 될 겁니다.


이전글 보러가기 (눈과 손이 달린 AI, 그 소름 돋는 작동 원리)

다음글 보러가기 (말만 하면 알아서 척척, 핵심 기능 Top 3)

댓글

댓글 쓰기

이 블로그의 인기 게시물

OpenClaw(구 Moltbot / Clawdbot) 실행 에러 총정리: 막힘없이 가동하는 해결 가이드

OpenClaw를 설치하고 실행하다 보면 마주하게 되는 빨간색 에러 메시지들은 우리를 당혹스럽게 합니다. 특히 하드웨어 환경과 소프트웨어 설정이 제각각인 윈도우에서는 더욱 그렇습니다. 오늘은 블로그에서 다뤘던 기초 에러를 포함하여, 실무에서 가장 빈번하게 발생하는 구체적인 에러 케이스들을 살펴볼까요? 에러를 해결하기 전, OpenClaw가 어떤 부품들로 이루어져 있는지 알면 훨씬 이해가 빠릅니다. 전문가들이 쓰는 어려운 말 대신, 우리 주변의 물건에 비유해 보겠습니다. 1. PyAutoGUI (파이오토지유아이): AI의 로봇 손가락 OpenClaw가 "어디를 클릭해!"라고 명령을 내리는 '두뇌'라면, PyAutoGUI 는 그 명령을 받아 실제로 마우스를 이동시키고 버튼을 누르는 **'로봇 손'**입니다. 역할: 마우스 커서 이동, 왼쪽/오른쪽 클릭, 드래그, 키보드 타이핑 등 인간이 컴퓨터 인터페이스(GUI)를 조작하는 모든 동작을 파이썬 코드로 대신 수행합니다. 중요성: 이 부품에 문제가 생기면 AI가 아무리 똑똑해도 마우스가 움직이지 않거나 엉뚱한 곳을 찌르게 됩니다. 2. 가상 환경 (venv): 전용 작업실 컴퓨터에는 이미 여러 프로그램이 깔려 있습니다. 가상 환경 은 OpenClaw만을 위해 만든 **'깨끗하고 독립적인 빈 방'**이라고 생각하시면 됩니다. 왜 쓰나요? 다른 프로그램과 파일들이 섞여서 에러가 나는 것을 방지하기 위해, 오직 OpenClaw에 필요한 재료들만 모아두는 격리 공간입니다. 3. OCR (광학 문자 인식): AI의 안경 화면에 떠 있는 글자(이미지)를 데이터(텍스트)로 읽어내는 기술입니다. 역할: 스크린샷에 적힌 "로그인"이라는 글자를 보고, AI가 "아, 이게 버튼이구나"라고 인지할 수 있게 해주는 안경 역할을 합니다. 1. 가상 환경 활성화 보안 오류 (Execution Policy) 가장 첫 단계인 venv\Script...
자세한 내용 보기

About : OpenClaw? Moltbot? 이름만 3번 바뀐 이 녀석, 써도 될까요? (OpenClaw 시리즈 정주행 가이드)

1. 이름의 변천사 뒤에 숨은 거대 IT 기업의 견제 이 프로젝트가 처음 'Clawdbot'이라는 이름으로 공개되었을 때, 업계는 경악했습니다. 단순히 챗봇과 대화하는 수준을 넘어, 사용자의 마우스와 키보드를 직접 제어하여 웹 서핑을 하고 엑셀 작업을 수행하는 능력을 보여주었기 때문입니다. 하지만 앤트로픽(Anthropic) 사의 AI 모델인 'Claude(클로드)'와의 상표권 유사성 문제가 제기되면서, 프로젝트는 급히 'Moltbot'으로, 그리고 현재의 'OpenClaw'로 이름을 바꿔야 했습니다. 이러한 급격한 리브랜딩 과정은 역설적으로 이 툴이 가진 파괴력이 기존 빅테크 기업들에게 얼마나 위협적인지를 증명하는 사례가 되었습니다. 2. '컴퓨터 유즈(Computer Use)' 기술의 대중화 OpenClaw의 핵심은 '눈(Vision)'과 '손(Action)'입니다. 기존의 AI가 텍스트를 생성하는 데 그쳤다면, OpenClaw는 화면의 스크린샷을 찍어 현재 상태를 분석하고, 버튼의 위치를 찾아 클릭합니다. 기존 방식과의 차이: 예전에는 매크로를 짜기 위해 복잡한 코딩이 필요했지만, 이제는 "이 사이트에서 가장 저렴한 비행기 티켓을 찾아줘"라는 일상적인 명령만으로 AI가 직접 브라우저를 열고 결제 직전 단계까지 작업을 수행합니다. 오픈 소스의 힘: 이 강력한 기능을 누구나 무료로 내려받아 자신의 PC에서 돌릴 수 있게 되면서, 개인용 AI 비서 시대가 한 걸음 더 가까워졌습니다. 3. 양날의 검: 보안과 개인정보 탈취 리스크 권한이 강력할수록 위험도 커집니다. OpenClaw는 사용자의 화면을 실시간으로 캡처하고 키보드 입력을 제어합니다. 만약 이 오픈 소스 코드에 악의적인 '백도어'가 심어져 있다면, 사용자의 은행 비밀번호나 개인 메시지가 고스란히 유출될 수 있는 치명적인 구조입니다. 실제로 최근 이 프로젝트의 인기에 편...
자세한 내용 보기

금값이 춤추고 달러가 요동친다: 2026 원자재 쇼크

"사상 최고치를 찍던 금과 은, 주말을 앞둔 시장의 변동성은 무엇을 암시하는가?" 경제의 근간, 즉 원자재와 화폐 가치의 흐름을 놓친다면 그것은 반쪽짜리 통찰에 불과합니다.  자본의 흐름은 언제나 기술보다 먼저 움직이기 때문입니다. 1. 숫자가 증명하는 1월 30일의 '피의 금요일' 지난주까지만 해도 원자재 시장은 그야말로 '불장'이었습니다. 하지만 2026년 1월 30일 금요일 , 시장은 역사에 남을 변동성을 기록했습니다. 단순히 조정이라고 하기엔 그 수치가 가히 충격적입니다. 금(Gold Futures): 불과 하루 전 $5,600 선을 위협하던 금 가격은 어제 $4,763.10 으로 장을 마감하며 하루 만에 약 11.4%(-$600) 폭락했습니다. 이는 1980년대 초 이후 단일 거래일 기준 최대 낙폭 중 하나입니다. IAU(ETF): 선물 가격 하락을 반영하며 장중 극심한 매도세를 보였습니다. 은(Silver Futures): 은의 변동성은 더 공포스러웠습니다. 전날 $120 을 돌파하며 사상 최고치를 경신했던 은은 어제 $78.83 까지 수직 낙하하며 무려 31.4% 가량 폭락했습니다. SLV(ETF): 전일 대비 -28.54% 하락한 $75.44 로 마감하며 은 시장의 투매(Capitulation) 현상을 그대로 보여주었습니다. 2. 시장을 뒤흔든 결정적 한 방: '케빈 워시'의 등판 이번 대폭락의 트리거는 도널드 트럼프 대통령의 전격적인 인사 발표였습니다. 트럼프 대통령은 현지시간 30일, 제롬 파월의 뒤를 이을 제17대 연방준비제도(Fed) 의장으로 케빈 워시(Kevin Warsh) 전 연준 이사를 공식 지명했습니다. 누가 지명되었나? 케빈 워시(Kevin Warsh): 35세에 최연소 연준 이사를 지낸 '월가의 아들'이자, 한국인들에게는 쿠팡(Coupang)의 사외이사 로도 잘 알려진 인물입니다. 재무장관 스콧 베센트(Scott Bessent): 이미...
자세한 내용 보기