Tools

Gemini 검색

OpenClaw은 실시간 Google Search 결과와 인용을 바탕으로 AI가 합성한 답변을 반환하는 기본 제공 Google Search grounding을 통해 Gemini 모델을 지원합니다.

API 키 가져오기

키 생성

Google AI Studio로 이동하여 API 키를 생성합니다.

키 저장

Gateway 환경에 GEMINI_API_KEY를 설정하거나, models.providers.google.apiKey를 재사용하거나, 다음을 통해 전용 웹 검색 키를 구성합니다.

bash

openclaw configure --section web

설정

json5

{  plugins: {    entries: {      google: {        config: {          webSearch: {            apiKey: "AIza...", // optional if GEMINI_API_KEY or models.providers.google.apiKey is set            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // optional; falls back to models.providers.google.baseUrl            model: "gemini-2.5-flash", // default          },        },      },    },  },  tools: {    web: {      search: {        provider: "gemini",      },    },  },}

자격 증명 우선순위: Gemini 웹 검색은 먼저 plugins.entries.google.config.webSearch.apiKey를 사용한 다음, GEMINI_API_KEY, 그다음 models.providers.google.apiKey를 사용합니다. 기본 URL의 경우 전용 plugins.entries.google.config.webSearch.baseUrl이 models.providers.google.baseUrl보다 우선합니다.

Gateway 설치에서는 환경 키를 ~/.openclaw/.env에 넣습니다.

작동 방식

링크 및 스니펫 목록을 반환하는 기존 검색 제공자와 달리, Gemini는 Google Search grounding을 사용하여 인라인 인용이 포함된 AI 합성 답변을 생성합니다. 결과에는 합성된 답변과 소스 URL이 모두 포함됩니다.

Gemini grounding의 인용 URL은 Google 리디렉션 URL에서 직접 URL로 자동 해석됩니다.
리디렉션 해석은 최종 인용 URL을 반환하기 전에 SSRF 가드 경로(HEAD + 리디렉션 검사 + http/https 검증)를 사용합니다.
리디렉션 해석은 엄격한 SSRF 기본값을 사용하므로, 비공개/내부 대상으로의 리디렉션은 차단됩니다.

지원되는 매개변수

Gemini 검색은 query, freshness, date_after, date_before를 지원합니다.

count는 공유 web_search 호환성을 위해 허용되지만, Gemini grounding은 N개 결과 목록이 아니라 인용이 포함된 하나의 합성 답변을 반환합니다.

freshness는 day, week, month, year 및 공유 단축어 pd, pw, pm, py를 허용합니다. day/pd는 엄격한 24시간 범위 대신 Gemini 쿼리에 최신성 지시를 추가합니다. week, month, year 및 명시적 date_after/date_before 범위는 Gemini Google Search grounding의 timeRangeFilter를 설정합니다. country, language, domain_filter는 지원되지 않습니다.

모델 선택

기본 모델은 gemini-2.5-flash입니다(빠르고 비용 효율적). grounding을 지원하는 모든 Gemini 모델은 plugins.entries.google.config.webSearch.model을 통해 사용할 수 있습니다.

기본 URL 재정의

Gemini 웹 검색이 운영자 프록시 또는 사용자 지정 Gemini 호환 엔드포인트를 통해 라우팅되어야 하는 경우 plugins.entries.google.config.webSearch.baseUrl을 설정합니다. 이것이 설정되지 않은 경우 Gemini 웹 검색은 models.providers.google.baseUrl을 재사용합니다. 일반 https://generativelanguage.googleapis.com 값은 https://generativelanguage.googleapis.com/v1beta로 정규화되며, 사용자 지정 프록시 경로는 뒤쪽 슬래시를 제거한 뒤 제공된 그대로 유지됩니다.