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

​
API 키 가져오기

1

키 생성

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

키 저장

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

​
설정

{
  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로 정규화되며, 사용자 지정 프록시 경로는 뒤쪽 슬래시를 제거한 뒤 제공된 그대로 유지됩니다.

​
관련