OpenClaw 설치 잔혹사 가이드 | OpenClaw 설치 잔혹사: 3전 4기 끝에 만난 나만의 AI 자비스(+보안 꿀팁)

얼마 전, 나는 OpenClaw(당시 이름은 Clawdbot)의 등장 소식을 접하고 설레는 마음으로 글을 하나 남긴 적이 있었다. 당시 나는 이 녀석을 저전력 N100 서버에 올릴지, 아니면 내 맥북에 직접 설치해서 구성할지 행복한 고민에 빠져 있었다. (그때의 천진난만한 고민은 여기에서 볼 수 있다.) 하지만 지금 돌아보니, 그것은 폭풍 전야의 고요함이었다.

세상에 없던 물건이 나왔다는 소문은 빠르게 퍼졌다. 깃허브 스타 14만 개. 이건 오픈소스 세계에서 거의 종교적인 숫자다. 이름도 Moltbot을 거쳐 OpenClaw로 확정되며 뭔가 더 ‘날카롭고’ 강력해 보였다. 내 맥북 안에 나만을 위해 24시간 일하는 ‘자비스’를 심을 수 있다니, 얼리어답터를 자처하는 내가 가만히 있을 수 없었다. 하지만 그 결정이 내 황금 같은 주말을 포함해서 3~4일을 통째로 집어삼킬 블랙홀이 될 줄은 꿈에도 몰랐다.

2. 고난의 행군: 설치와 재설치, 그리고 삽질의 반복

자신만만하게 터미널을 열었다. 내 맥북은 이미 수많은 개발 환경이 세팅된 ‘전투용’이었기에 별일 없을 거라 믿었다. 설치는 처음에는 수월한 것 처럼 보였다. 공식 홈페이지에 이미 한줄 짜리 설치 커맨드가 나와있기 때문이다. 그렇게 설치가 진행되었고 첫 대화는 순조로운 것 같았다.

curl -fsSL https://openclaw.ai/install.sh | bash

하지만 모델을 하나하나 추가하고 텔레그램 설정을 변경하고 스킬을 설치하면 할 수록 점점 꼬여가기 시작했다. 가장 먼저 나를 반긴 건 파이썬(Python) 버전 충돌이었다. 시스템에 깔린 3.10과 OpenClaw가 요구하는 특정 라이브러리들이 서로 죽이겠다며 싸워댔다. 평소 같으면 sudo를 앞에 붙여 기를 죽였겠지만, 나는 이 시스템의 전권을 쥐고 있는 root 사용자가 아닌가. 거침없이 명령어를 때려 박았다. 하지만 결과는 처참했다. 시스템 환경 변수가 꼬이면서 터미널 자체가 먹통이 됐다. 첫 번째 실패였다.

결국 나는 모든 것을 지우고 ‘태초의 상태’에서 다시 시작하기를 세 번이나 반복했다. 눈은 충혈되었고 새벽까지 키보드를 붙잡고 있었다. 꼬박 사흘이 걸려서야 마침내 AI 에이전트 다운 대화가 가능해지기 시작했다.

3. 토큰 브레이커: 내 지갑을 털어간 인공지능

겨우 구동에 성공했을 때의 감격은 딱 30분 갔다. OpenClaw는 내 기대와는 전혀 다르게 동작했다. “이거 해줘”라고 시키면 제대로 된 결과물은 안 내놓고, 백그라운드에서 무슨 생각을 그렇게 깊게 하는지 OpenAI와 Claude의 토큰을 무시무시하게 갈아 넣기 시작했다. 그리고 결국 내놓는 것은 “작업에 실패했습니다.”라는 한마디.

아침에 일어나 API 대시보드를 확인해 보니 내 사용량 그래프가 에베레스트 정상마저 뚫고 수직 상승해 있었다. 제대로 된 작업은커녕 혼자서 “생각 중…”이라는 메시지만 띄우며 내 달러를 태우고 있는 ‘불효자’를 보며 깊은 현자타임이 왔다. 결국 나는 공식 문서를 뒤져가며 모델을 저렴한 녀석으로 바꾸는 법부터 배워야 했다.

4. 🛠️ OpenClaw 트러블슈팅 가이드 (공식 문서 기반)

사흘간의 사투를 통해 얻은 지식과 공식 문서의 설정값들을 정리했다. 나처럼 고생하지 않길 바란다.

① 모델 변경하기: “토큰이 다 떨어졌어요!”

초기에 기본 설정된 모델을 쓰다 보면 무료 토큰이나 예산이 순식간에 바닥나서 봇이 먹통이 되는 경우가 있다. 이럴 땐 경제적인 모델로 갈아타야 한다. ~/.openclaw/openclaw.json 파일을 열어 다음 설정을 수정하자. 잘 모르겠다면 그냥 커맨드창에 openclaw onboard를 치고 설정을 하는것도 괜찮은 방법이다.

JSON

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "google/gemini-2.5-flash-lite"
      }
    }
  }
}

② Grok AI 모델 적용하기

Elon Musk의 Grok을 써보고 싶다면 x.ai API 키를 발급받은 뒤 다음과 같이 설정한다. 초기 설정할 때 x.ai가 선택할 수 있는 목록에 없어서 호환이 안되는 줄 알았는데 공식 문서를 보니 설정 방법이 따로 있었다. 왜 초기 설정에 안 넣었는지는 모르겠지만 아무튼 공식문서 도움으로 해결할 수 있었다.

JSON

{
  "env": {
    "XAI_API_KEY": "your-xai-key-here"
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "grok-4-fast",
        "api_type": "openai",
        "base_url": "https://api.x.ai/v1"
      }
    }
  }
}

③ 브라우저 사용 권한 주는 방법

OpenClaw가 직접 웹을 서핑하게 하려면 권한이 필요하다. 공식적으로 두 가지 방법을 제공한다.

크롬 익스텐션 활용: 크롬 웹스토어에서 OpenClaw Extension을 설치한 후, 릴레이 서버 URL을 페어링한다. 특정 탭만 제어하므로 보안상 유리하다. 하지만 재설치하다보면 쉽게 꼬여서 어쩔 수 없이 두번째 방법으로 넘어갈 수 밖에 없었다.
자체 브라우저 제어: 설정 파일에서 browser_automation을 활성화한다.JSON"browser_automation": { "enabled": true, "headless": false }
그리고 커맨드창에 공식 문서에 있는 명령어들을 입력해보면 정상 작동하는 걸 볼 수 있다.

openclaw browser --browser-profile openclaw status
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot

④ 지메일, 캘린더 권한 주기 (gog 설치)

구글 워크스페이스 연동을 위해선 gog 라이브러리가 필요하다.

npx openclaw install-skill google-workspace 실행.
gog auth login 명령어를 입력하고, 구글 클라우드 콘솔에서 발급받은 OAuth JSON 파일로 인증을 진행하거나 커맨드창에 표시되는 주소로 들어가서 인증을 하면 된다.

⑤ 기타 필수 트러블슈팅

Port Collision: 실행 시 18789 포트가 이미 사용 중이라면 openclaw gateway --port 19000으로 변경하자.
Skill Timeout: 스킬 설치가 너무 오래 걸려 멈춘다면, 당황하지 말고 한 번 더 명령어를 입력하자. 의존성 파일이 캐싱되어 두 번째엔 성공한다.
삭제 후 재설치 시 기존에 연결했던 메신져 채널과 다시 연결을 하고 싶다면 채팅창에 /paring 이라고 치면 연결 정보가 나온다.

💡 중요 팁: OpenClaw는 업데이트가 굉장히 잦다. 기능이 이상하다 싶으면 고민하지 말고 업데이트부터 해보자. npm install -g openclaw@latest 또는 openclaw update 명령어로 항상 최신 상태를 유지하는 것이 정신 건강에 좋다.

5. 현재의 평화와 지워지지 않는 불안감

우여곡절 끝에 지금은 제법 친해졌다. 매일 아침 쏟아지는 메일을 요약해 주고, 복잡한 코드를 대신 짜주기도 하며 파일이 복잡하게 널려있던 내 구글드라이브를 폴더별로 정리해주기도 했다. 앞으로는 Home assistant를 연동해서 집안일 자동화에도 써볼 계획이다. 처음에는 나를 적잖이 고생시켰지만 지금은 이녀석 덕분에 업무 효율은 확실히 비약적으로 상승했다. 이제는 정말 내 손발이 된 느낌이다. 마치 신입사원 들어온 후 교육시켜서 이제 일좀 시킬만 해진 느낌이랄까. 하지만 평화로운 일상 뒤편에는 늘 보안 취약점이라는 찝찝함이 남아 있다. 어찌보면 셀프호스팅의 태생적인 한계이기도 하다.

“100점 만점에 2점”이라는 보안 점수를 봤을 때의 충격이란. 내 소중한 파일들이 담긴 맥북의 권한을 통째로 넘겨준 셈이니, 밤마다 누군가 내 API 키를 훔쳐 가거나 파일을 들여다보지는 않을까 하는 걱정에 잠을 설친 적도 있다.

6. 다음 행선지: 클라우드 샌드박스로의 탈출?

그래서 요즘은 다른 대안을 고민 중이다. 내 맥북을 직접 내어주는 대신, 클라우드플레어(Cloudflare) 같은 곳에서 서비스를 시작한 샌드박스형 클라우드 에이전트로 옮겨탈까 싶다. 내 소중한 데이터와 시스템은 격리하고, 에이전트의 편리함만 쏙 빼먹는 영리한 전략이 필요할 것 같다.

OpenClaw는 분명 매력적이지만, 직접 설치하며 겪은 이 고생은 한 번으로 족하다. 혹시 지금 이 순간에도 설치 버튼을 누르려는 당신, 부디 단단히 마음먹기를 바란다. 4일간의 자유 시간과 두둑한 지갑, 그리고 강철 같은 멘탈이 준비되었다면 말이다.

FAQ: N100 OpenClaw 운영 질문

Q. N100에서 OpenClaw를 실사용해도 괜찮나요?
가능합니다. 다만 모델 크기와 자동화 범위를 욕심내면 체감 속도가 떨어질 수 있어, 경량 모델/하이브리드 구성이 안정적입니다.

3줄 요약

트러블슈팅

결론 + 다음 단계