Pencarian Gemini

OpenClaw mendukung model Gemini dengan grounding Google Search bawaan, yang mengembalikan jawaban yang disintesis AI dan didukung oleh hasil Google Search langsung dengan sitasi.

# Dapatkan kunci API

openclaw configure --section web

# Konfigurasi

{
  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",
      },
    },
  },
}

Prioritas kredensial: Pencarian web Gemini menggunakan plugins.entries.google.config.webSearch.apiKey terlebih dahulu, lalu GEMINI_API_KEY, lalu models.providers.google.apiKey. Untuk URL dasar, nilai khusus plugins.entries.google.config.webSearch.baseUrl diutamakan sebelum models.providers.google.baseUrl.

Untuk instalasi Gateway, letakkan kunci env di ~/.openclaw/.env.

# Cara kerjanya

Tidak seperti penyedia pencarian tradisional yang mengembalikan daftar tautan dan cuplikan, Gemini menggunakan grounding Google Search untuk menghasilkan jawaban yang disintesis AI dengan sitasi inline. Hasilnya mencakup jawaban yang disintesis dan URL sumber.

• URL sitasi dari grounding Gemini secara otomatis diselesaikan dari URL pengalihan Google menjadi URL langsung.
• Penyelesaian pengalihan menggunakan jalur pelindung SSRF (HEAD + pemeriksaan pengalihan + validasi http/https) sebelum mengembalikan URL sitasi final.
• Penyelesaian pengalihan menggunakan default SSRF yang ketat, sehingga pengalihan ke target privat/internal diblokir.

# Parameter yang didukung

Pencarian Gemini mendukung query, freshness, date_after, dan date_before.

count diterima untuk kompatibilitas web_search bersama, tetapi grounding Gemini tetap mengembalikan satu jawaban yang disintesis dengan sitasi, bukan daftar N hasil.

freshness menerima day, week, month, year, dan pintasan bersama pd, pw, pm, dan py. OpenClaw mengonversi nilai-nilai ini, atau rentang eksplisit date_after/date_before, menjadi timeRangeFilter milik grounding Google Search Gemini. country, language, dan domain_filter tidak didukung.

# Pemilihan model

Model default adalah gemini-2.5-flash (cepat dan hemat biaya). Model Gemini apa pun yang mendukung grounding dapat digunakan melalui plugins.entries.google.config.webSearch.model.

# Override URL dasar

Atur plugins.entries.google.config.webSearch.baseUrl ketika pencarian web Gemini harus dirutekan melalui proksi operator atau endpoint kustom yang kompatibel dengan Gemini. Jika itu tidak diatur, pencarian web Gemini menggunakan ulang models.providers.google.baseUrl. Nilai biasa https://generativelanguage.googleapis.com dinormalisasi menjadi https://generativelanguage.googleapis.com/v1beta; jalur proksi kustom dipertahankan sebagaimana diberikan setelah memangkas garis miring penutup.

# Terkait

• Ringkasan Web Search -- semua penyedia dan deteksi otomatis
• Brave Search -- hasil terstruktur dengan cuplikan
• Perplexity Search -- hasil terstruktur + ekstraksi konten