📂 OpenClaw 사용자 모임 종합 가이드북 (Ver. 2026.02.05)

채팅방에서 오고 간 팁, 시행착오, 해결책들을 집대성한 가이드입니다.
새로 오신 분들은 정독하시면 설치와 운영에 큰 도움이 됩니다.

━━━━━━

1. 프로젝트 정체성 및 용어 정리
   ━━━━━━

• 이름의 변천사:
  초기 'ClawdBot'에서 상표권 이슈 등으로 'MoltBot'으로 변경되었고, 현재는 'OpenClaw'로 프로젝트명이 확정되었습니다.

• OpenClaw의 개념 (몸통 vs 뇌):
  OpenClaw는 스스로 생각하는 AI가 아닙니다. AI 모델(Brain)을 웹 검색, 파일 제어, 메신저 등 실제 도구(Body)와 연결해 주는 '에이전트 플랫폼'입니다.

• 주요 용어:

  • LLM (Large Language Model): 클로드, GPT, 제미나이 등 실제 지능을 담당하는 모델.
  • MoltBook: 에이전트들이 생성한 콘텐츠를 올리는 SNS 형태의 피드.
  • ClawHub: 에이전트가 사용할 수 있는 스킬(기능)을 공유하는 마켓플레이스.

━━━━━━
2. 설치 및 운영 환경 가이드
━━━━━━

• Mac (가장 추천):
  개발자 및 대다수 유저가 사용하는 환경으로 호환성이 가장 좋습니다. 특히 Apple Silicon (M 시리즈) 칩셋에서의 구동이 원활합니다.

• Windows (주의 필요):

  • 터미널(PowerShell/CMD) 직접 설치: 권장하지 않습니다. 쉘 명령어 불일치, 경로 문제 등 오류가 잦습니다.
  • 추천 방식: WSL2(Windows Subsystem for Linux) 또는 Docker Desktop을 이용해 리눅스 환경을 가상으로 띄워서 설치하는 것이 정신 건강에 좋습니다.

• Linux (Ubuntu 등):
  구형 노트북이나 미니 PC에 우분투를 설치하여 전용 머신으로 돌리는 것도 훌륭한 방법입니다.

━━━━━━
3. 하드웨어 구매 가이드 (Mac Mini 대란)
━━━━━━

• 국민 세팅 (Mac Mini M4):
  현재 가성비와 전성비가 가장 좋아 '오픈클로 머신'으로 불립니다.

• 메모리(RAM) 용량 선택 가이드:

  • 16GB (기본형): 클라우드 API(Claude, Gemini 등)만 연결해서 쓸 분들에게 적합합니다.
  • 24GB ~ 32GB (권장): 로컬 LLM(소형), TTS(음성 합성) 모델 구동, 혹은 헤비하게 에이전트를 여러 개 돌릴 분들에게 권장됩니다.
  • 64GB 이상: 고성능 로컬 LLM (Llama 70B, Qwen 등)을 본격적으로 돌리기 위한 사양입니다.

• 구매 팁:
  공홈 교육 할인 + 샵백(Shopback) 경유 혜택을 중복으로 받으면 체감가를 크게 낮출 수 있습니다. (배송은 오래 걸릴 수 있음)

━━━━━━
4. 연결 모델(LLM) 장단점 및 비용 분석
━━━━━━

• Claude (Anthropic) - "똑똑하지만 비싼 귀족":

  • 장점: Opus 4.5 모델의 경우 코딩 및 추론 능력이 압도적입니다.
  • 단점: API 비용이 매우 비쌉니다. 며칠 만에 수십 달러가 청구될 수 있습니다. 웹 구독 계정 연동은 밴(Ban) 위험이 있습니다.

• Gemini (Google) - "가성비의 제왕":

  • 장점: Gemini 2.5 Flash 모델은 무료 티어 제공량이 넉넉하여 입문용으로 최고입니다.
  • 단점: 사용량이 몰리면 429 에러(Rate Limit)가 뜨거나, 맥락을 놓치고 멍청해지는 경우가 있습니다.

• GPT (OpenAI) - "무난한 올라운더":

  • 특징: 구독 계정(Plus)을 OAuth로 연결하여 사용할 수 있어 접근성이 좋습니다.

• Kimi (Nvidia) - "숨겨진 꿀통":

  • 팁: Nvidia API를 통해 Kimi k2.5 모델을 무료 혹은 매우 저렴하게 사용할 수 있다는 제보가 있습니다.

• 로컬 LLM (Ollama 등) - "보안과 비용의 자유":

  • 장점: API 비용 0원, 데이터 유출 걱정 없음.
  • 단점: 고사양 하드웨어 필요, 최상급 클라우드 모델(Opus 등)보다 지능이 다소 떨어질 수 있음.

━━━━━━
5. 보안 및 네트워크 설정 (필독)
━━━━━━

• 사내망 사용 금지:
  OpenClaw는 기본적으로 연결된 계정의 이메일, 파일 등을 읽을 수 있습니다. 회사의 보안 규정에 위배될 소지가 다분하므로 회사 PC 설치는 지양하세요.

• 외부 접속 (대시보드):

  • 기본 설정: 보안을 위해 설치된 PC(localhost)에서만 접속됩니다.
  • 외부 접속 허용: 다른 PC나 폰에서 접속하려면 openclaw config set gateway.bind lan 설정을 변경해야 합니다.
  • 접속 방법: 설정 변경 후 URL 뒤에 ?token=YOUR_TOKEN 형식으로 토큰값을 붙여야 접속됩니다.

• 포트 포워딩 주의:
  편의를 위해 공유기 포트를 개방하여 외부 인터넷에서 접속하게 하면 해킹 위험이 큽니다. 외부 접속이 필요하다면 Tailscale 같은 VPN을 이용하세요.

• 중국산 모델 이슈:
  DeepSeek 등 중국산 로컬 모델 사용 시 데이터 수집 우려가 있어, 보안이 중요한 작업에는 신중해야 합니다.

━━━━━━
6. 트러블슈팅 및 꿀팁 (FAQ)
━━━━━━

Q. 봇이 대답을 안 하고 먹통이에요.
A. 대부분 LLM의 API 사용 한도(Rate Limit)를 초과했거나, 모델 설정이 꼬인 경우입니다. openclaw doctor 명령어로 상태를 점검하거나 openclaw onboard로 재설정해 보세요.

Q. "Context Overflow" 에러가 떠요.
A. 대화 내역이 모델이 기억할 수 있는 한계를 넘었습니다. 대화 세션을 초기화하거나, 컨텍스트 창이 더 큰 모델로 변경해야 합니다.

Q. Gemini OAuth 연결이 자꾸 실패해요.
A. gemini-cli가 설치되지 않았거나, 설정 파일의 문법 오류일 수 있습니다. 터미널에서 npm install -g @google/gemini-cli를 먼저 실행해 보세요.

Q. 백업은 어떻게 하나요?
A. .openclaw 폴더 내의 .md 파일을 백업해 두거나, GitClaw 같은 백업 솔루션을 활용하면 재설치 시 복구 가능합니다.

Q. 텔레그램 말고 카카오톡 연동은 안 되나요?
A. 카카오톡은 공식 API 제한이 많아 어렵습니다. 현재는 텔레그램 연동이 가장 안정적이고 기능이 많습니다.

Q. "Context Overflow" 에러가 떠요.
A. 대화 내역이 모델이 기억할 수 있는 한계를 넘었습니다. 대화 세션을 초기화하거나, 컨텍스트 창이 더 큰 모델로 변경해야 합니다.