SDK
2026년 2월 3일 오후 06:31
2026년 2월 1일 · 약 12분 소요
"24시간 돌아가는 AI 비서가 내 대신 일해주면 얼마나 좋을까?" 트위터에서 OpenClaw(구 ClawdBot) 영상 보고 이런 생각 하신 분들 많으실 거예요. 저도 그랬습니다.
결론부터 말씀드리면, Mac Mini와 Mac Studio를 분리해서 구성하려던 시도는 실패했어요. 네트워크 레이턴시 문제로 결국 Mac Studio 한 대에서 돌리는 걸로 방향을 틀었습니다.
이 글에서 얻어가실 것 3가지:
- OpenClaw가 뭔지, 기존 AI 에이전트(AutoGPT, LangChain)랑 뭐가 다른지
- CLIProxyAPI로 Claude Code $200 구독을 API처럼 쓰는 방법
- Mac Mini + Mac Studio 분리 구성이 왜 실패했는지 (같은 삽질 피하세요)
📑 목차
- 1. OpenClaw(ClawdBot)이 뭔가요?
- 2. 설계: Mac Mini + Mac Studio 분리 전략
- 3. CLIProxyAPI로 Claude Code 구독 활용하기
- 4. Mac Mini에 OpenClaw 설치하기
- 5. 왜 실패했나? 네트워크의 함정
- 6. 배운 점과 2편 예고
1. OpenClaw(ClawdBot)이 뭔가요?
2026년 1월, 트위터 테크 커뮤니티가 난리였어요. 다들 Mac Mini 사서 "ClawdBot" 돌린다고. 이름이 Anthropic의 Claude랑 발음이 똑같죠? 우연이 아닙니다. Wikipedia에 따르면 이건 꽤 전략적인 마케팅이었고, 결국 상표권 문제로 Moltbot → OpenClaw로 두 번이나 이름이 바뀌었어요.
핵심 차이점: ChatGPT나 Claude.ai는 "물어보면 대답하는" 챗봇이에요. OpenClaw는 "시키면 알아서 하는" 에이전트입니다. 터미널 명령도 치고, 파일도 만들고, 웹 브라우저도 조작해요.
실제 사용 사례가 미쳤어요
유튜브 영상에서 소개된 사례들인데, 진짜 놀라웠습니다:
- 자동차 협상 $4,200 절약: 딜러 인벤토리 검색 → 견적 요청 → 딜러끼리 경쟁시킴 → 최저가 확보. 사용자는 서류만 사인.
- 보험 청구 승소: 거부된 보험 청구에 대해 법적 방어문 작성, 약관 인용해서 공격적 이메일 전송 → 재심사 후 승인.
- 자가 API 키 발급: 작업 중 Google Cloud API 키가 필요하다고 판단하자, 스스로 브라우저 열고 OAuth 설정하고 키 발급받음.
⚠️ 주의: 이런 자율성이 양날의 검이에요. Wikipedia와 Dark Reading 보안 기사에서도 지적하듯이, 프롬프트 인젝션, 자격 증명 노출 등 보안 리스크가 있습니다. 고급 사용자용 도구예요.
기존 AI 에이전트와 뭐가 다른가요?
| 도구 | 특징 | 한계 |
|---|---|---|
| Baby AGI / AutoGPT | 작업 분해, 단계별 실행 | 자기 개선 불가, 능력 고정 |
| LangChain | 유연한 체이닝, 개발자 친화적 | 직접 다 만들어야 함 |
| n8n 워크플로우 | 노코드 자동화 | 미리 설계한 흐름만 실행 |
| OpenClaw | 자연어 지시, 자가 스킬 생성 | 보안 리스크, 러닝 커브 |
OpenClaw의 킬러 피처는 soul.md 파일이에요. "이런 스킬 배워" 하면 스스로 코드 작성해서 저장하고, 다음부터 그 스킬을 씁니다. n8n은 "조립 라인"이라면, OpenClaw는 "신입 직원"에 가깝습니다.
2. 설계: Mac Mini + Mac Studio 분리 전략
유튜브 영상 다 보고 나서 제가 세운 계획은 이랬어요:
Mac Mini (테스트/위험 작업용) │ ├── OpenClaw 상주 (24시간) ├── 위험한 자동화 실험 ├── 시스템 망가져도 OK │ └── HTTP API ──▶ Mac Studio Mac Studio (개발 전용, 보호) │ ├── CLIProxyAPI (Claude Code 래핑) ├── Claude Code CLI ($200 구독) ├── ComfyUI + Flux (이미지 생성) └── 메인 개발 환경
왜 이렇게 나눴나?
OpenClaw는 시스템 전체 접근 권한을 가져요. 터미널 명령, 파일 삭제, 앱 설치까지 다 가능합니다. DigitalOcean 튜토리얼에서도 강조하듯이, "개인 데이터가 있는 메인 머신에서 돌리지 마세요"가 공식 권장사항이에요.
| 구성 | 장점 | 단점 |
|---|---|---|
| Mac Mini 분리 | 메인 환경 보호, 실험 자유도 | 네트워크 레이턴시, 관리 복잡 |
| Mac Studio 올인원 | 빠름, 단순함 | OpenClaw가 시스템 건드릴 위험 |
| 클라우드 VPS | 완전 격리, 저렴 | 로컬 파일 접근 불가 |
저는 "안전 + 성능" 둘 다 잡으려고 분리를 선택했는데... 결과적으로 둘 다 놓쳤습니다. 이유는 뒤에서 설명할게요.
3. CLIProxyAPI로 Claude Code 구독 활용하기
여기서 막히는 분들 많아요. OpenClaw 자체는 무료 오픈소스인데, 뒤에 붙는 AI 모델이 돈이 듭니다.
| 옵션 | 월 비용 | 품질 |
|---|---|---|
| OpenRouter 무료 모델 | $0 | 느림, 제한 많음 |
| ZAI GLM 4.5 | ~$2.70 | Claude 급 |
| Anthropic API 종량제 | 사용량 따라 | 최고 |
| Claude Code Max ($200) | $200 (정액) | 최고 + 무제한 |
저는 이미 Claude Code Max를 구독 중이었어요. 월 $200인데 종량제로 쓰면 훨씬 더 나올 사용량입니다. 문제는 이게 API 키가 아니라 OAuth 방식이라서 외부 도구에서 못 쓴다는 거예요.
💡 해결책: CLIProxyAPI
CLIProxyAPI가 이 문제를 해결해줍니다. OAuth 기반 CLI 도구들을 OpenAI 호환 API로 래핑해주는 프록시예요. ⭐ 8.6k 스타, MIT 라이선스.
CLIProxyAPI 설치 (Mac Studio)
# 클론
git clone https://github.com/router-for-me/CLIProxyAPI.git
cd CLIProxyAPI
# 설정 파일 생성
cp config.example.yaml config.yaml
# Docker로 실행
docker compose up -d
# 로그 확인
docker logs cli-proxy-api
처음에 config.yaml is a directory 에러가 났어요. 폴더가 만들어진 거였는데, 삭제하고 파일로 다시 만들어서 해결했습니다.
Claude Code OAuth 연동
An Tran의 가이드가 도움이 많이 됐어요. 핵심은:
- CLIProxyAPI 실행 상태에서 OAuth 로그인 진행
- 브라우저 팝업에서 Claude 계정 인증
- 토큰이
~/.cli-proxy-api/에 저장됨 - 이후
http://localhost:8317/v1/chat/completions로 API 호출 가능
# Claude Code OAuth 로그인
# Docker 내부에서 또는 관리 UI(http://localhost:8085)에서 진행
# 테스트
curl -H "x-api-key: your-api-key-1" http://localhost:8317/v1/models
성공하면 Claude 모델 목록이 쭉 나와요. 저는 Codex(GPT-5)도 같이 연동했습니다.
⚠️ 법적 회색 지대: CLIProxyAPI로 본인 구독을 본인만 쓰는 건 "아마도" 괜찮아요. 하지만 제3자에게 API를 제공하는 건 명확한 이용약관 위반입니다. 다모앙 같은 서비스에 연동하면 안 됩니다.
4. Mac Mini에 OpenClaw 설치하기
SSH 원격 접속 설정
Mac Mini를 헤드리스(모니터 없이)로 쓰려면 SSH가 필수예요.
# Mac Mini에서 직접 (또는 화면 공유로)
시스템 설정 → 일반 → 공유 → 원격 로그인 켜기
# Mac Studio에서 접속
ssh [email protected]
❌ 흔한 실수: Connection refused가 뜨면 100% SSH가 꺼져 있는 거예요. Mac Mini에 직접 가서 켜야 합니다. 터미널로 sudo systemsetup -setremotelogin on 하면 "Full Disk Access" 에러 나더라고요. GUI로 하는 게 편합니다.
OpenClaw 설치
# 원라이너 설치
curl -fsSL https://openclaw.ai/install.sh | bash
설치 중 질문들:
- "I understand this is powerful and inherently risky" → Yes
- "Quick start mode" → Yes
- Model provider → 처음엔 OpenRouter 선택 (무료 테스트용)
- Telegram 봇 토큰 → BotFather에서 발급
Telegram 봇 설정
OpenClaw의 킬러 피처 중 하나가 텔레그램으로 어디서든 명령할 수 있다는 거예요.
- Telegram에서
@BotFather검색 /newbot명령- 이름: 자유롭게 (예: SDK OpenClaw)
- 유저네임:
_bot으로 끝나야 함 - 받은 토큰을 OpenClaw 설치 과정에서 입력
모델 설정 삽질
처음에 openrouter/auto로 설정했는데, 7분 넘게 응답이 안 왔어요. 무료 모델의 한계입니다.
# 설정 파일 직접 수정
nano ~/.openclaw/openclaw.json
# "primary": "openrouter/auto" 를
# "primary": "google-gemini-cli/gemini-2.5-flash" 로 변경
Gemini CLI도 느려서, 결국 CLIProxyAPI를 통한 Claude Code 연동으로 방향을 틀었습니다.
5. 왜 실패했나? 네트워크의 함정
Mac Mini에 OpenClaw, Mac Studio에 CLIProxyAPI. 완벽한 구성이라고 생각했어요.
Mac Mini (192.168.55.178) │ └── OpenClaw │ └── HTTP 요청 ──▶ Mac Studio (192.168.55.78:8317) │ └── CLIProxyAPI → Claude Code
네트워크 연결도 잘 됐어요:
# Mac Mini에서 테스트
curl -H "x-api-key: your-api-key-1" http://192.168.55.78:8317/v1/models
# 결과: Claude, GPT-5 모델 목록 정상 출력 ✅
근데 실제로 OpenClaw에서 메시지 보내면?
안녕! 너는 누구야?
⠙ flibbertigibbeting… • 13s | connected
13초째 대기 중. 같은 머신에서 직접 Claude Code 쓰면 2-3초면 응답 오는데요.
실패 원인 분석:
- 네트워크 홉: OpenClaw → HTTP → CLIProxyAPI → Claude API → 역순 (왕복 4단계)
- 스트리밍 오버헤드: 실시간 응답이 네트워크 버퍼링되면서 지연
- OpenClaw 내부 처리: 외부 API 응답 파싱하는 과정에서 추가 지연
결론: 같은 머신이 답이다
| 구성 | 예상 | 현실 |
|---|---|---|
| Mac Mini → Mac Studio | 안전 + 빠름 | 안전하지만 느림 |
| Mac Studio 올인원 | 위험? | 빠름, 실용적 |
"위험한 작업은 Mac Mini에서" 전략은 좋은데, 실제로 쓸 수 있을 정도로 빨라야 의미가 있어요. 13초 기다리면서 "버그 고쳐줘" 하고 싶은 사람 없잖아요.
6. 배운 점과 2편 예고
이번 삽질에서 배운 것
- 무료 모델의 한계: OpenRouter 무료 티어는 테스트용이에요. 실사용은 유료 모델 필수.
- 네트워크 분리의 대가: 보안을 위해 분리하면 속도를 포기해야 합니다. 트레이드오프.
- CLIProxyAPI는 진짜 유용: $200 구독을 API처럼 쓸 수 있게 해주는 건 가치 있어요.
- OpenClaw는 아직 발전 중: 유튜브에서 보여주는 "AI 회사처럼 협업"은 아직 현실이 아니에요. "AI 인턴" 정도.
"완벽한 AI 회사는 아니지만, 일손 하나 느는 거예요."
핵심 요약 3줄
- OpenClaw는 "시키면 알아서 하는" 자율 에이전트. 챗봇과 다름.
- CLIProxyAPI로 Claude Code 구독을 API처럼 쓸 수 있음 (본인만).
- Mac 분리 구성은 네트워크 레이턴시 때문에 비실용적. 같은 머신 추천.
🚀 2편 예고
Mac Studio 올인원으로 OpenClaw + CLIProxyAPI + ComfyUI 통합 구성기
실제 동작 테스트, 블로그/유튜브 자동화 활용 사례, 최종 비용 정리까지!
참고 자료:
댓글 (0)
- 아직 댓글이 없습니다. 첫 댓글을 작성해보세요!
댓글을 작성하려면 이 필요합니다.