60초 만에 끝내는 OpenClaw 2.0과 Gemini 연동 설정

OpenClaw 2.0이란?

OpenClaw는 실제로 일을 처리하는 개인 AI 어시스턴트다. 내 기기에서, 내 채팅 앱 안에서, 내가 정한 규칙대로 작동한다.

• 어디서나 대화: 브라우저 Control UI, Telegram, Discord, WhatsApp, Slack 어디서든 대화할 수 있다.
• 통합 도구: 브라우저 자동화, 터미널 실행, 파일시스템 접근, 웹 검색 그라운딩을 지원한다.
• 기억: 세션이 바뀌어도 선호 설정, 프로젝트, 관련 인물을 기억한다.

OpenClaw 2.0(v2026.8.1)은 역대 최대 규모의 업데이트다. 설치가 더 간편해졌고, 대화 화면으로 바로 열리는 브라우저 앱이 새롭게 만들어졌으며, Claw와 대화하는 것만으로 초기 설정을 끝낼 수 있다. 전체 릴리스 노트: v2026.8.1.

사전 준비

• Node.js: Node 26(권장) 또는 Node 22.22.3+ / 24.15+ (node --version).
• Gemini API 키: Google AI Studio에서 무료 키를 발급받는다.

1. OpenClaw 2.0 설치

npm으로 OpenClaw를 전역 설치한다:

npm install -g openclaw@2026.8.1

설치를 확인한다:

openclaw --version
# Output: OpenClaw 2026.8.1 (ea80657)

2. Gemini 인증 설정

현재 셸에 Gemini API 키를 환경 변수로 등록한다:

export GEMINI_API_KEY="your-gemini-api-key-here"

OpenClaw의 로컬 프로필 저장소에 영구적으로 저장하려면:

openclaw onboard --non-interactive --accept-risk --skip-health \
  --mode local \
  --auth-choice gemini-api-key \
  --gemini-api-key "$GEMINI_API_KEY"

(참고: 온보딩 중 Brave API 키 설정 안내가 표시되더라도 무시해도 된다. Gemini의 기본 내장 Google Search 그라운딩이 자동으로 적용된다.)

3. Gemini 3.7 Flash를 기본 모델로 설정

Gemini 3.7 Flash를 기본 에이전트 모델로 설정한다:

openclaw models set google/gemini-3.7-flash

(참고: OpenClaw에서 해당 모델이 로컬 카탈로그에 없다는 경고가 표시되더라도 무시해도 된다. 다음 단계에서 Google AI Studio를 통해 동적으로 모델을 탐색하고 검증한다.)

모델 탐색 및 인증 상태를 확인한다:

openclaw models list --provider google

4. CLI에서 추론 테스트

터미널에서 에이전트를 단독으로 실행해 본다:

openclaw agent --local --agent main --message "Hello! What model are you running?"

출력:

I'm running on google/gemini-3.7-flash.
I'm your new assistant here in OpenClaw! What would you like to call me?

5. 게이트웨이 시작 및 Control UI 실행

게이트웨이를 로컬 모드로 설정하고 시작한다:

openclaw config set gateway.mode local
openclaw gateway run

(백그라운드 데몬으로 상시 실행하려면: openclaw gateway install && openclaw gateway start. 중지하려면: openclaw gateway stop --force)

브라우저에서 Control UI를 연다:

openclaw dashboard

브라우저가 열리면서 http://127.0.0.1:18789/ 주소로 이동하며, 로컬 세션 토큰으로 자동 인증된다:

다음 단계

Google Search 그라운딩(기본 활성화)

GEMINI_API_KEY이 설정되어 있으면 Google Search 그라운딩이 기본으로 활성화된다. 별도 설정이나 검색 키는 필요하지 않다.

• CLI에서 직접 테스트할 수 있다:

  Bash

  openclaw capability web search --query "Latest gemini models"

• 대화 세션에서 최신 정보가 필요할 때마다 Gemini가 자동으로 웹 검색을 실행하고 출처를 함께 제공한다.

• 참고: OpenClaw의 Google Search 그라운딩

다른 Gemini 기능 활용하기

• 이미지 생성: openclaw models set-image google/gemini-3.1-flash-image로 Google의 이미지 모델을 설정한다.
• 비디오 생성: google/veo-3.1-fast-generate-preview으로 4~8초 분량의 영상을 생성한다.
• 음악 생성: google/lyria-3-clip-preview를 통해 프롬프트 기반 음악을 만든다.
• 텍스트 음성 변환: 자연어 스타일 프롬프트를 활용한 Gemini 배치 TTS (gemini-3.1-flash-tts-preview).
• 실시간 음성: Gemini Live API를 통한 저지연 양방향 음성 스트림 (gemini-3.1-flash-live-preview).

전체 Google 문서 참고.

채팅 채널 연결

간단한 CLI 명령어로 Gemini 어시스턴트를 원하는 메시지 앱에 연결할 수 있다:

• 전체 채널 보기: openclaw channels list --all
• 대화형 설정: openclaw channels add
• Telegram: openclaw channels add --channel telegram --token "<BOT_TOKEN>"
• WhatsApp (QR 코드): openclaw channels login --channel whatsapp
• Discord: openclaw channels add --channel discord --token "<BOT_TOKEN>"
• 채널 상태 확인: openclaw channels status --probe

전체 채팅 채널 문서 참고.