Ana içeriğe atla

Gemini Arama

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

API anahtarı alma

1

Bir anahtar oluşturun

Google AI Studio adresine gidin ve bir API anahtarı oluşturun.
2

Anahtarı saklayın

Gateway ortamında GEMINI_API_KEY ayarlayın veya şu yolla yapılandırın:
openclaw configure --section web

Yapılandırma

{
  plugins: {
    entries: {
      google: {
        config: {
          webSearch: {
            apiKey: "AIza...", // GEMINI_API_KEY ayarlıysa isteğe bağlı
            model: "gemini-2.5-flash", // varsayılan
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "gemini",
      },
    },
  },
}
Ortam alternatifi: Gateway ortamında GEMINI_API_KEY ayarlayın. Bir gateway kurulumu için bunu ~/.openclaw/.env içine koyun.

Nasıl çalışır

Bağlantı ve snippet listesi döndüren geleneksel arama sağlayıcılarının aksine, Gemini, satır içi alıntılarla AI tarafından sentezlenmiş yanıtlar üretmek için Google Search grounding kullanır. Sonuçlar hem sentezlenmiş yanıtı hem de kaynak URL’leri içerir.
  • Gemini grounding’den gelen alıntı URL’leri, Google yönlendirme URL’lerinden doğrudan URL’lere otomatik olarak çözümlenir.
  • Son yönlendirme URL’si döndürülmeden önce yönlendirme çözümleme, SSRF koruma yolunu (HEAD + yönlendirme denetimleri + http/https doğrulaması) kullanır.
  • Yönlendirme çözümleme katı SSRF varsayılanlarını kullanır; bu nedenle özel/iç hedeflere yapılan yönlendirmeler engellenir.

Desteklenen parametreler

Gemini arama query parametresini destekler. count, paylaşılan web_search uyumluluğu için kabul edilir, ancak Gemini grounding yine de N sonuçlu bir liste yerine alıntılar içeren tek bir sentezlenmiş yanıt döndürür. country, language, freshness ve domain_filter gibi sağlayıcıya özgü filtreler desteklenmez.

Model seçimi

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

İlgili