Gemini araması

OpenClaw, canlı Google Search sonuçlarıyla desteklenen ve atıflar içeren, yapay zeka tarafından sentezlenmiş yanıtlar döndüren yerleşik Google Search temellendirmesi ile Gemini modellerini destekler.

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, ardından GEMINI_API_KEY değerini, sonra da models.providers.google.apiKey değerini kullanır. Temel URL'ler için, özel plugins.entries.google.config.webSearch.baseUrl değeri models.providers.google.baseUrl değerinden önce gelir.

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

Nasıl çalışır?

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

• Gemini temellendirmesinden gelen atıf URL'leri, Google yönlendirme URL'lerinden doğrudan URL'lere otomatik olarak çözümlenir.
• Yönlendirme çözümlemesi, son atıf URL'sini döndürmeden önce SSRF koruma yolunu (HEAD + yönlendirme kontrolleri + 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 parametrelerini destekler.

count, paylaşılan web_search uyumluluğu için kabul edilir, ancak Gemini temellendirmesi yine de N sonuçlu bir liste yerine atıflar içeren tek bir sentezlenmiş yanıt döndürür.

freshness, day, week, month, year değerlerini ve paylaşılan kısayollar olan pd, pw, pm ve py değerlerini kabul eder. day/pd, katı bir 24 saatlik aralık yerine Gemini sorgusuna güncellik yönergesi ekler. week, month, year ve açık date_after/date_before aralıkları Gemini Google Search temellendirmesinin timeRangeFilter değerini ayarlar. country, language ve domain_filter desteklenmez.

Model seçimi

Varsayılan model gemini-2.5-flash modelidir (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 Search genel bakışı -- tüm sağlayıcılar ve otomatik algılama
• Brave Search -- parçacıklarla yapılandırılmış sonuçlar
• Perplexity Search -- yapılandırılmış sonuçlar + içerik çıkarma