왜 만들었나

매번 ChatGPT 열고, Claude 열고, 탭 전환하다 지쳐서 — 내 서버에서 돌아가는 AI 비서 하나 만들어보기로 했다.

요구사항은 단순했다:

  • 무료 (or 최대한 저렴하게)
  • 빠를 것
  • 내 인프라에서 돌 것

무엇을 쓸 것인가

후보 비교

옵션이유결과
로컬 LLM (Ollama 등)N100 미니 PC 8GB 메모리론 70B 모델 못 돌림❌ 패스
Groq 무료 티어OpenClaw 내부 프롬프트가 48k 토큰, 무료 TPM 한도(6k12k) 초과❌ 실패
Claude (Anthropic)서드파티 앱은 플랜 용량 사용 불가, 별도 extra usage 필요❌ 패스
Google AI Studio (Gemini)무료 티어 250,000 TPM, 1M 컨텍스트✅ 선택

결론: Google AI Studio + Gemini 2.5 Flash.
무료 TPM 한도가 250,000이라 OpenClaw의 대용량 프롬프트도 문제없다.

Groq 무료 티어는 TPM이 너무 낮다. OpenClaw는 내부적으로 요청당 48k 토큰을 사용하므로 Groq 무료 티어(6k12k TPM)로는 동작하지 않는다.

환경

  • 테스트: MacBook M3 Pro 14” 36GB
  • 이전 예정: N100 Proxmox VM

설치

Node.js 먼저 확인:

node -v   # v25.9.0
npm -v    # 11.12.1

OpenClaw 글로벌 설치:

npm install -g openclaw
openclaw --version  # OpenClaw 2026.4.26

워크스페이스 초기화:

openclaw setup

Gemini 연결

aistudio.google.com 에서 API 키 발급.

Google Cloud Console에서 해당 프로젝트의 Generative Language API 를 활성화해야 한다.
GOOGLE_CLOUD_PROJECT 환경변수는 불필요 — AI Studio 키는 GOOGLE_API_KEY 하나면 됨.

# 1. Gemini API 키 등록
echo 'GOOGLE_API_KEY=AIza...' >> ~/.openclaw/.env
 
# 2. 기본 모델 설정
openclaw config set agents.defaults.model.primary google/gemini-2.5-flash

게이트웨이 실행:

openclaw gateway

Telegram 연결

BotFather에서 봇 생성 후 토큰 발급:

Telegram → @BotFather → /newbot → 토큰 복사

OpenClaw에 봇 토큰 등록:

openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.botToken "봇토큰"

게이트웨이 재시작 후 봇에 /start → 페어링 코드 발급 → 승인:

openclaw pairing approve --channel telegram <페어링코>

이후 봇에 메시지 보내면 Gemini가 응답한다.

openclaw channels login --channel telegram 은 동작하지 않는다. config 직접 설정 방식을 사용할 것.

다음 단계

  • Telegram 연결
  • N100 Proxmox VM으로 이전