3줄 요약
- 대상: OpenClaw 설치 가이드: 맥북에서 AI 에이전트 비서 초기 세팅하기 내용을 빠르게 파악하려는 독자
- 핵심: 설치·설정·운영 포인트를 핵심 단계 중심으로 정리
- 결과: 재현 가능한 절차와 점검 기준으로 시행착오를 줄임
트러블슈팅
- 증상이 나오면 로그·버전·포트/권한·네트워크 순서로 확인합니다.
- 설정 반영이 안 되면 서비스 재시작/캐시 비우기 후 다시 검증합니다.
결론 + 다음 단계
핵심 절차를 먼저 완료하고, 운영 단계에서는 백업·모니터링·기본 보안 설정을 함께 적용하세요.
요약: 이 글은 “OpenClaw 설치 가이드: 맥북에서 AI 에이전트 비서 초기 세팅하기” 주제의 핵심 개념과 실제 적용 절차를 빠르게 정리합니다.
트러블슈팅: 트러블슈팅: 설정이 적용되지 않거나 접속/권한 오류가 나면 “로그 확인 → 네트워크/포트 → 권한/경로” 순서로 점검하세요.
결론/다음 단계: 결론/다음 단계: 동작 확인 후 운영 루틴(백업·업데이트·모니터링)을 추가하고, 관련 가이드도 함께 적용해 완성도를 올리세요.
함께 보면 좋은 글
이 글은 맥북에서 OpenClaw를 설치하고, 기본 설정(게이트웨이/대시보드/채널)을 잡아 “AI 에이전트 비서”를 실제로 운영 가능한 상태로 만드는 과정을 정리한다. 핵심은 설치보다 초기 동작 확인 루틴과, 문제 발생 시 빠르게 원인을 분리하는 순서를 만드는 것이다.
이 글의 목표(성공 기준)
- OpenClaw가 설치되고 gateway/dashboard가 정상 실행된다.
- Telegram 등 채널 연동이 1개 이상 정상 동작한다.
- 자주 겪는 오류(포트/토큰/브라우저) 점검 순서가 정리되어 있다.
1. OpenClaw? 그게 뭔데 내 PC를 탐내나?
요즘 홈랩 커뮤니티에서 가장 핫한 키워드는 단연 ‘에이전트’이다. 단순히 질문에 답하는 챗봇의 시대를 지나, 이제는 인공지능이 직접 마우스를 움직이고 코드를 짜며 내 업무를 대신하는 시대가 왔다. 그 중심에 있는 것이 바로 **OpenClaw**다.

이전 글에서 소개했던 ClawdBot이라는 핫한 AI 에이전트가 나왔는데 MoltBot으로 이름이 바뀌었다는 글을 썼었는데 이름을 한번더 바꾸면서 OpenClaw가 되었다. 무슨 사연이 있는지는 모르겠으나 이젠 좀 사용자들 덜 헷갈리게 이름 그만 바꿨으면 좋겠다.
이 에이전트가 주목받는 가장 큰 이유는 ‘적극성’과 ‘자율성’이다. 내가 “오늘 뉴스 요약해서 텔레그램으로 보내줘”라고 하면, 스스로 브라우저를 켜고 뉴스를 검색한 뒤 메시지까지 전송한다. 한마디로 내 컴퓨터 안에 상주하는 유능한(때로는 사고도 치는) 개인 비서를 두는 셈이다.
2. 하드웨어 선정: N100 서버냐, 추억의 맥북이냐
처음에는 저전력 끝판왕인 N100 미니 PC 서버에 올릴까 고민했다. 하지만 OpenClaw의 진정한 매력은 ‘컴퓨터 제어’에 있었다. 서버 안에 갇혀 있는 에이전트보다는, 내가 실제로 업무를 보고 웹서핑을 하는 환경을 직접 만져주는 게 더 쓸모 있겠다는 판단이 섰다.
결국 책상 구석에서 잠자고 있던 **맥북 프로 2018(Intel i7, 16GB RAM)**을 꺼냈다. 조금 오래된 모델이긴 하지만, 로컬 연산보다는 API 통신이 주를 이루는 에이전트 특성상 충분히 현역으로 뛸 수 있을 거라 믿었다. 무엇보다 맥 OS 전용 컴패니언 앱이 있다는 사실이 내 결정에 쐐기를 박았다.
3. 설치는 순식간, 내 맥북에 빨대 꽂기
설치 과정은 허무할 정도로 간단했다. OpenClaw 공식 홈페이지 메인에 대문짝만하게 걸려 있는 터미널 커맨드 한 줄이면 끝난다.
Bash
# root 권한으로 실행할 필요도 없이 한 줄이면 끝난다.
curl -fsSL https://openclaw.ai/install.sh | bash
설치가 진행되는 동안 맥 OS 유저를 위한 Companion App도 다운로드했다. 이 앱은 OpenClaw가 내 화면을 인식하고 마우스와 키보드를 대신 제어할 수 있게 돕는 ‘손과 발’ 같은 존재다. 설치가 끝나자 터미널 창에는 화려한 ASCII 아트와 함께 나를 반기는 온보딩(Onboard) 화면이 나타났다. 이제 이 녀석에게 ‘지능’을 불어넣을 차례였다.
4. 초기 세팅: API 키와 챗봇의 혼령 불어넣기
본격적인 세팅은 지금부터다. OpenClaw는 빈 껍데기에 불과하므로, 뇌 역할을 할 LLM과 소통 창구인 메신저를 연결해야 한다.
① Google AI Studio (Gemini) 연결
가장 먼저 Google AI Console로 달려가 API 키를 발급받았다. 최근 Gemini 2.5 Pro와 Flash 모델의 가성비가 압도적이라 주저 없이 선택했다. 발급받은 키를 터미널 설정 창에 붙여넣으니 OpenClaw가 비로소 첫 기지개를 켰다.
② 텔레그램(Telegram) 봇 생성
밖에서도 내 맥북을 부려 먹으려면 메신저 연동이 필수다. 텔레그램의 BotFather를 찾아가 새로운 봇을 만들고 API 토큰을 따냈다. 공식 문서에 따르면, 봇 설정에서 Privacy Mode를 끄고 Group Anonymous Management 권한을 적절히 조절해야 에이전트가 메시지를 놓치지 않고 읽을 수 있다고 한다.
이 설정이 중요한 이유가 태스크를 시켜두면 어느정도 시간이 걸리는데 그동안 컴퓨터 앞에 앉아서 모니터링 하지 않고 언제 어디서든 텔레그램을 통해 현재 상태를 확인할 수도 있고, 나아가 언제든 필요한 일을 시키고 원격으로 답을 받을 수 도 있기 때문이다.
③ Brave Search API: 실시간 검색이라는 에이전트의 눈
에이전트가 최신 정보를 파악하게 하려면 외부 검색 기능이 필수다. 이를 위해 Web Tool 설정을 통해 Brave Search API를 연결했다. 이 과정은 onboard 과정에 포함되어 있지 않아서 별도로 진행해줘야 하는데 링크의 공식 문서를 보면 어렵지 않게 따라할 수 있다.
OpenClaw는 단순히 구글 검색 결과를 긁어오는 수준이 아니다. Brave Search API를 사용하면 에이전트가 웹 페이지의 본문 텍스트를 직접 읽고 분석하는 Web Search 기능을 활성화할 수 있다. 무료 티어에서도 하루 2,000건의 쿼리를 제공하므로 개인용으로는 충분하다. 이제 이 녀석은 “오늘 삼성전자 주가 어때?”라는 질문에 실시간 웹 데이터를 뒤져 답변할 수 있게 되었다.
④ Chrome Extension: 브라우저를 직접 조종하는 파일럿
OpenClaw의 진정한 백미는 브라우저를 직접 만지는 능력이다. **Chrome Extension**을 설치하면 에이전트가 내 브라우저 탭을 열고, 닫고, 스크롤하며 특정 버튼을 클릭하는 것이 가능해진다. 이것 역시 기본 설정에는 포함되어있지 않아서 공식 문서를 보고 따라서 진행해줘야 한다. 다만, 중간에 기본으로 숨겨저있는 폴더 내의 경로를 지정해줘야 하는 과정이 나오는데, 맥 OS의 Finder에서 숨겨진 폴더를 보는 단축키는 “cmd+shift+.”이다. 처음에 이거 몰라서 한참 헤맸는데, 너무 간단한 걸 갖고 오래 고민해서 나중에 알고나니 어이가 없었다.
아무튼 이렇게 하면 확장 프로그램이 설치되는데 이게 좋은 이유가 단순한 스크린샷 캡처 방식은 좌표가 어긋나면 헛발질하기 일쑤지만, 이 확장 프로그램은 브라우저의 접근성 트리(Accessibility Tree)를 활용한다. 덕분에 에이전트는 웹 페이지의 구조를 완벽히 이해하고 “로그인 버튼을 눌러줘” 같은 복잡한 명령을 실수 없이 수행한다. 내 맥북의 크롬 브라우저가 AI의 조종석이 되는 순간이었다.
5. 첫 테스트와 처절한 ‘한도 초과’의 벽
모든 준비가 끝났다. 나는 설레는 마음으로 첫 명령을 내렸다.
“내 목소리를 복제할 수 있는 모델을 하나 만들어줘.”
처음으로 이걸 시킨 이유는 내 블로그 글 내용을 기반으로 유튜브 쇼츠나 인스타 릴스를 자동 생성할 수 있는 환경을 만들기 위한 첫 단계이기 때문이다.
OpenClaw는 잠시 고민하더니 GPT-SoVITS라는 오픈소스 모델을 찾아내 설치를 시도하기 시작했다. 파이썬 환경을 구축하고 깃허브 저장소를 클로닝하는 모습을 보며 감탄했다. 하지만 기쁨도 잠시, 먹통이 된것 같아서 로그를 확인해보니 “Token Limit Exceeded”라는 붉은 메시지가 떴다. 무료 티어의 한계였다.
참지 못하고 Google AI Console에 결제 카드 정보를 등록했다. 유료 결제자의 위엄을 보여주려 했으나, 조금 더 돌아가다 말고 이번에는 TPM(Tokens Per Minute) 제한이라는 더 높은 벽이 나를 가로막았다. 고성능 모델인 Pro를 쓰기엔 내 지갑과 구글의 제한 정책이 아직 합의를 보지 못한 모양이었다.
결국 모델을 조금 가벼운 Gemini 2.5 Flash-lite 모델로 교체했다. 지능은 살짝 낮아졌을지 모르지만, 반응 속도가 조금 더 빨라졌고 무엇보다 TPM 제한치가 일반 모델보다 훨씬 높기 때문에 ‘무한 제한’의 늪에서 벗어날 수 있었다. 현재는 이 세팅으로 다시 목소리 복제 모델 구축을 재시도하며 에이전트와 밀당 중이다.
6. 앞으로 이 녀석과 무엇을 할 것인가?
최근 뉴스에 따르면 AI 에이전트의 활용 사례는 상상을 초월한다.
- 자율적 시장 조사 및 보고서 작성: 특정 주식이나 코인의 기술적 분석 자료를 24시간 수집하여 매일 아침 요약 보고서를 작성하고 내 메일로 보내주는 사례가 늘고 있다.
- 개인 맞춤형 코딩 어시스턴트: 내가 자는 동안 내 깃허브 저장소의 이슈를 분석해 버그 수정 풀 리퀘스트(PR)를 미리 올려두는 기특한 에이전트들도 등장했다.
나 역시 이 OpenClaw를 통해 단순히 질문에 답하는 수준을 넘어, 매일 반복되는 이메일 정리, 블로그 포스팅 초안 작성, 그리고 복잡한 홈랩 서버 모니터링 자동화를 맡겨볼 생각이다. 인공지능이 내 맥북의 팬을 돌리며 열일하는 동안, 나는 더 창의적인 ‘삽질’에 집중할 수 있을 테니까.