Google · 텍스트

OpenClaw x Gemini

Gemini는 Flash(빠른) 및 Pro(프론티어 추론) 변형으로 제공되는 Google의 멀티모달 플래그십 LLM입니다. RunAPI를 통해 모든 Gemini 모델이 동일한 API 형태와 과금 방식을 공유합니다.

11 variants 최저 $0.10 / 100만 토큰 상업적 사용 지원
API 키 받기 OpenClaw 문서 보기

Prerequisite: npx runapi mcp install

Prompt

프롬프트 모델

작업에 맞는 경우 gemini-2.5-flash를 사용하세요: 속도/비용 최적화; 1M 컨텍스트; 이전 세대 기준.

You have access to RunAPI chat models for Gemini.

Available Gemini models:
- gemini-2.5-flash: 속도/비용 최적화; 1M 컨텍스트; 이전 세대 기준
  chat endpoints: /v1/chat/completions
- gemini-2.5-flash-lite: Gemini 2.5 Flash-Lite; 1M 컨텍스트, 사고 기본값 꺼짐; OpenAI 호환 Chat Completions
  chat endpoints: /v1/chat/completions
- gemini-2.5-pro: 2.5 세대 최고 추론; 1M 컨텍스트
  chat endpoints: /v1/chat/completions
- gemini-3-flash-preview: gemini-3-flash-preview
  chat endpoints: /v1/chat/completions, /v1beta/models/gemini-3-flash-preview:streamGenerateContent
- gemini-3.1-flash-lite: Gemini 3.1 Flash-Lite; 1M 컨텍스트, 조절형 사고; OpenAI 호환 Chat Completions로 텍스트 요청
  chat endpoints: /v1/chat/completions
- gemini-3.1-pro-preview: gemini-3.1-pro-preview
  chat endpoints: /v1/chat/completions
- gemini-3.5-flash: 고용량 프로덕션 워크로드를 위한 빠른 멀티모달 스트리밍
  chat endpoints: /v1/chat/completions, /v1beta/models/gemini-3.5-flash:streamGenerateContent
- gemini-3.5-flash-lite: Chat Completions 또는 네이티브 콘텐츠 스트리밍으로 텍스트를 생성하는 경량 Gemini
  chat endpoints: /v1/chat/completions, /v1beta/models/gemini-3.5-flash-lite:streamGenerateContent
- gemini-3.6-flash: 프로덕션 워크로드를 위한 빠른 멀티모달 채팅, 도구 및 스트리밍
  chat endpoints: /v1/chat/completions, /v1beta/models/gemini-3.6-flash:streamGenerateContent
- gemini-3.7-flash: 사용량 보고를 지원하는 빠른 스트리밍 채팅 및 네이티브 콘텐츠 출력
  chat endpoints: /v1/chat/completions, /v1beta/models/gemini-3.7-flash:streamGenerateContent
- gemini-3.8-flash: 함수 호출과 네이티브 콘텐츠 스트리밍을 지원하는 에이전트용 텍스트 채팅
  chat endpoints: /v1/chat/completions, /v1beta/models/gemini-3.8-flash:streamGenerateContent

Use the model ID and chat endpoint that match the user's request.
Example request: 이 코드베이스를 분석하고 이전/이후 예시와 함께 세 가지 성능 개선 방안을 제안해 주세요.
Verify the active model with: openclaw models status;openclaw models set runapi/<model-id>

공개 버전 및 엔드포인트

모델 ID 엔드포인트 시작 가격 모델 카탈로그
gemini-2.5-flash
/v1/chat/completions
$0.30 / 100만 토큰 모델 상세
gemini-2.5-flash-lite
/v1/chat/completions
$0.10 / 100만 토큰 모델 상세
gemini-2.5-pro
/v1/chat/completions
$1.25 / 100만 토큰 모델 상세
gemini-3-flash-preview
/v1/chat/completions /v1beta/models/gemini-3-flash-preview:streamGenerateContent
$0.30 / 100만 토큰 모델 상세
gemini-3.1-flash-lite
/v1/chat/completions
$0.25 / 100만 토큰 모델 상세
gemini-3.1-pro-preview
/v1/chat/completions
$1.00 / 100만 토큰 모델 상세
gemini-3.5-flash
/v1/chat/completions /v1beta/models/gemini-3.5-flash:streamGenerateContent
$0.90 / 100만 토큰 모델 상세
gemini-3.5-flash-lite
/v1/chat/completions /v1beta/models/gemini-3.5-flash-lite:streamGenerateContent
$0.15 / 100만 토큰 모델 상세
gemini-3.6-flash
/v1/chat/completions /v1beta/models/gemini-3.6-flash:streamGenerateContent
$0.75 / 100만 토큰 모델 상세
gemini-3.7-flash
/v1/chat/completions /v1beta/models/gemini-3.7-flash:streamGenerateContent
$0.45 / 100만 토큰 모델 상세
gemini-3.8-flash
/v1/chat/completions /v1beta/models/gemini-3.8-flash:streamGenerateContent
$0.45 / 100만 토큰 모델 상세

검증

Task가 최종 상태에 도달할 때까지 폴링합니다

<model-id>를 선택하면 검증 명령을 생성합니다.

설정

가이드 엔드포인트: <endpoint>

<model-id>를 선택하면 엔드포인트의 공개 입력 계약에 맞는 요청을 생성합니다.
사용 절차

3단계로 시작하기

  1. 모델 ID 선택

    공개 모델 ID를 선택하고 엔드포인트와 현재 시작 가격을 확인합니다.

  2. RunAPI 설정

    이 Agent의 Provider 설정을 추가합니다.

  3. 결과 검증

    아래 Agent 상태 및 모델 선택 명령을 실행합니다.

OpenClaw + Gemini로 만들 수 있는 것

  • 멀티모달 애플리케이션

    텍스트 프롬프트와 함께 이미지, PDF, 오디오, 영상을 보내 Gemini가 한 번의 호출로 분석, 설명, 구조화된 데이터 추출을 하도록 합니다.

  • 긴 문서 분석

    대규모 코드베이스, 법률 문서 모음, 연구 자료를 한 번의 요청으로 Gemini에 전달해 분석하고 요약합니다.

  • 빠른 에이전트 루프

    최고 수준의 추론 품질보다 지연 시간이 중요한, 속도에 민감한 도구 호출 체인에서 Gemini의 Flash 버전을 사용합니다.

Gemini을(를) RunAPI + OpenClaw로 사용하는 이유

  • 11개 변형 모델, 하나의 API 키

    하나의 RunAPI 연결에서 사용 가능한 모델 변형을 선택할 수 있어 통합 방식을 바꿀 필요가 없습니다.

  • 명확한 사용 요금

    요청을 보내기 전에 현재 카탈로그 요금을 확인하세요. 구독이나 최소 사용 금액이 없습니다.

  • 즉시 응답

    동기 호출은 같은 응답 안에 결과를 반환하므로 에이전트가 작업 상태를 폴링하지 않고 바로 결과를 사용할 수 있습니다.

OpenClaw + Gemini 자주 묻는 질문

Google Cloud 프로젝트 없이 OpenClaw에서 Gemini를 사용할 수 있나요?

네. RunAPI는 OpenAI 호환 엔드포인트로 Gemini를 제공합니다. RunAPI API 키만 있으면 되고, Google Cloud 프로젝트, 서비스 계정, Vertex AI 결제 설정은 필요 없습니다.

Gemini Flash와 Pro는 언제 사용하나요?

Flash 버전은 더 빠르고 저렴해 에이전트 루프, 분류, 도구 호출에 적합합니다. Pro 버전은 복잡한 추론과 긴 컨텍스트 분석을 처리합니다.

RunAPI를 통한 Gemini는 function calling을 지원하나요?

네. RunAPI는 OpenAI 호환 tools와 tool_choice를 Gemini에 전달하고, Gemini는 어시스턴트 메시지에 도구 호출을 반환합니다. OpenClaw는 이를 다른 모델의 도구 호출과 같은 방식으로 처리합니다.

어떤 모델 ID를 사용해야 하나요?

버전 표에서 공개 모델 ID를 선택하세요. 각 ID가 제공하는 엔드포인트는 해당 행에 표시됩니다.

이 가이드는 채팅 모델을 설정하나요?

예. 이 Model Line은 클라이언트용 LLM 프로토콜을 지원합니다.

OpenClaw에서 Gemini 사용 시작하기

API 키 받기 빠른 시작 읽기

팀과 함께 구축하고 계신가요?

엔터프라이즈 설정, 통합, 기술 문의를 도와드립니다.

문의하기