Gemini araması

OpenClaw, yerleşik Google Search ile temellendirme özelliğine sahip Gemini modellerini destekler; bu özellik, canlı Google Search sonuçlarıyla desteklenen ve alıntılar içeren, yapay zeka tarafından sentezlenmiş yanıtlar döndürür.

# API anahtarı alma

openclaw configure --section web

# Yapılandırma

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

Kimlik bilgisi önceliği: Gemini web araması önce plugins.entries.google.config.webSearch.apiKey değerini, sonra GEMINI_API_KEY değerini, ardından models.providers.google.apiKey değerini kullanır. Temel URL'ler için özel plugins.entries.google.config.webSearch.baseUrl, models.providers.google.baseUrl öncesinde öncelik kazanır.

Bir gateway kurulumu için ortam anahtarlarını ~/.openclaw/.env içine koyun.

# Nasıl çalışır

Bağlantı ve kısa parçacık listesi döndüren geleneksel arama sağlayıcılarının aksine Gemini, satır içi alıntılarla yapay zeka tarafından sentezlenmiş yanıtlar üretmek için Google Search ile temellendirmeyi kullanır. Sonuçlar hem sentezlenmiş yanıtı hem de kaynak URL'leri içerir.

• Gemini temellendirmesinden gelen alıntı URL'leri, Google yönlendirme URL'lerinden otomatik olarak doğrudan URL'lere çözümlenir.
• Yönlendirme çözümlemesi, son alıntı URL'sini döndürmeden önce SSRF koruma yolunu (HEAD + yönlendirme denetimleri + http/https doğrulaması) kullanır.
• Yönlendirme çözümlemesi katı SSRF varsayılanlarını kullanır, bu nedenle özel/dahili hedeflere yönlendirmeler engellenir.

# Desteklenen parametreler

Gemini araması query, freshness, date_after ve date_before değerlerini destekler.

count, paylaşılan web_search uyumluluğu için kabul edilir, ancak Gemini temellendirmesi N sonuçlu bir liste yerine alıntılar içeren tek bir sentezlenmiş yanıt döndürmeye devam eder.

freshness, day, week, month, year ve paylaşılan kısayollar olan pd, pw, pm ve py değerlerini kabul eder. OpenClaw bu değerleri veya açık bir date_after/date_before aralığını Gemini Google Search temellendirmesinin timeRangeFilter değerine dönüştürür. country, language ve domain_filter desteklenmez.

# Model seçimi

Varsayılan model gemini-2.5-flash değeridir (hızlı ve maliyet açısından verimli). Temellendirmeyi destekleyen herhangi bir Gemini modeli plugins.entries.google.config.webSearch.model üzerinden kullanılabilir.

# Temel URL geçersiz kılmaları

Gemini web aramasının bir operatör proxy'si veya özel Gemini uyumlu uç nokta üzerinden yönlendirilmesi gerektiğinde plugins.entries.google.config.webSearch.baseUrl değerini ayarlayın. Bu ayarlanmamışsa Gemini web araması models.providers.google.baseUrl değerini yeniden kullanır. Düz bir https://generativelanguage.googleapis.com değeri https://generativelanguage.googleapis.com/v1beta olarak normalleştirilir; özel proxy yolları ise sondaki eğik çizgiler kırpıldıktan sonra sağlandığı gibi korunur.

# İlgili

• Web Araması genel bakışı -- tüm sağlayıcılar ve otomatik algılama
• Brave Search -- kısa parçacıklarla yapılandırılmış sonuçlar
• Perplexity Search -- yapılandırılmış sonuçlar + içerik çıkarma