OpenClaw 2.0 (v2026.8.1) 을 설치하고, 코딩 및 에이전트를 위한 가장 빠른 (+300 token/sec) 에이전틱 모델인 Gemini 3.7 Flash 에 연결한 후, Google 검색 근거를 활용한 채팅을 1분 안에 시작할 수 있는 5가지 명령어입니다.
OpenClaw 2.0 이란?
OpenClaw 는 실제로 작업을 수행하는 개인 AI 어시스턴트입니다. 사용자의 기기, 채팅, 규칙에 따라 실행됩니다.
- 어디서나 채팅: 브라우저 제어 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를 전역으로 설치합니다:
1npm install -g openclaw@2026.8.1
설치를 확인합니다:
1openclaw --version# 출력: OpenClaw 2026.8.1 (ea80657)
2. Gemini 인증 구성
현재 셸에서 Gemini API 키를 내보냅니다:
1export GEMINI_API_KEY="your-gemini-api-key-here"
OpenClaw의 로컬 프로필 저장소에 영구 저장하려면:
1openclaw onboard --non-interactive --accept-risk --skip-health \2 --mode local \3 --auth-choice gemini-api-key \4 --gemini-api-key "$GEMINI_API_KEY"
(참고: Brave API 키 구성에 관한 온보딩 팁은 무시해도 됩니다. Gemini의 내장 Google 검색 근거가 자동으로 사용됩니다.)
3. Gemini 3.7 Flash 를 기본 모델로 설정
Gemini 3.7 Flash 를 기본 에이전트 모델로 설정합니다:
1openclaw models set google/gemini-3.7-flash
(참고: OpenClaw가 모델이 로컬 카탈로그에 없다는 경고를 표시해도 안전하게 무시할 수 있습니다. 모델은 다음 단계에서 Google AI Studio에 대해 동적으로 확인되고 검증됩니다.)
모델 검색 및 인증 상태를 확인합니다:
1openclaw models list --provider google
4. CLI를 통한 추론 테스트
터미널에서 독립 실행형 에이전트 턴을 실행합니다:
1openclaw agent --local --agent main --message "안녕하세요! 어떤 모델을 실행 중인가요?"
출력:
1저는 google/gemini-3.7-flash 에서 실행 중입니다.2저는 OpenClaw의 새 어시스턴트입니다! 저를 뭐라고 부르시겠어요?
5. 게이트웨이 시작 및 제어 UI 실행
게이트웨이를 로컬 모드로 설정하고 시작합니다:
1openclaw config set gateway.mode localopenclaw gateway run
(대신 영구적인 백그라운드 데몬으로 실행하려면: `openclaw gateway install && openclaw gateway start`. 중지하려면: `openclaw gateway stop --force`).
브라우저에서 제어 UI를 엽니다:
1openclaw dashboard
브라우저가 로컬 세션 토큰으로 인증된 http://127.0.0.1:18789/ 로 열립니다:
다음 단계
GEMINI_API_KEY 가 있으면 Google 검색 근거가 기본적으로 활성화됩니다. 추가 구성이나 검색 키가 필요하지 않습니다.
- CLI를 통해 직접 테스트: \
openclaw capability web search --query "최신 gemini 모델"\ - 채팅 세션에서 Gemini는 새로운 컨텍스트가 필요할 때마다 인용과 함께 웹 검색을 자율적으로 실행합니다.
다른 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\
전체 채팅 채널 문서.
