OpenClaw 설치 & Gemini CLI + Telegram 연동 가이드 (mac)

 

https://youtu.be/ch4EsgfHOJc

 

1. OpenClaw 설치

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

---

2. Gemini API 키 발급 (무료)

1. https://aistudio.google.com/app/apikey 접속
2. Google 계정 로그인
3. Create API key 클릭 → 키 복사

Claude API는 유료(pay-as-you-go)이므로 Gemini 무료 티어 사용 권장

---

3. OpenClaw 설정 (Gemini 연동)

openclaw configure

• Model provider: Google CLI/  Gemini 선택

sudo npm install -g @google/gemini-cli

• 이거 설치해야함
• 발급받은 Gemini API 키 입력
• 기본 모델 추천: google/gemini-2.5-flash
  • gemini-2.5-pro-preview-06-05는 무료 API에서 404 오류 발생하므로 사용 불가

---

4. Telegram 봇 생성

1. Telegram에서 @BotFather 검색
2. /newbot 입력 → 봇 이름 설정 (** 여기 봇으로 들어가야함: 검색으로 자신이 생성한 봇으로 채팅입장)
3. 발급된 Bot Token 복사 → OpenClaw 설정에 입력

 

5. 게이트웨이 실행

openclaw gateway

이미 실행 중인 경우:

openclaw gateway stop   # 먼저 중지
openclaw gateway        # 재시작

---

6. Telegram 봇 페어링

1. Telegram에서 본인이 만든 봇 검색 (BotFather 아님!)
2. 봇에게 /start 전송
3. 봇이 페어링 코드 전송
4. 터미널에서 아래 명령어로 승인:

openclaw pairing approve telegram 페어링코드

---

완료

이제 Telegram에서 본인 봇에게 메시지를 보내면 , 엄청기다리면, Gemini가 응답해요.

---

주요 명령어 정리

명령어 설명

openclaw gateway	게이트웨이 실행
openclaw gateway stop	게이트웨이 중지
openclaw status	게이트웨이 상태 확인
openclaw pairing list	대기 중인 페어링 요청 확인
openclaw pairing approve telegram <코드>	텔레그램 페어링 승인
openclaw models	모델 설정 변경
openclaw doctor	설정 오류 진단
openclaw dashboard	브라우저 대시보드 열기