Gemini araması

OpenClaw, canlı Google Arama sonuçlarıyla desteklenen ve kaynak gösterimleri içeren, yapay zekâ tarafından sentezlenmiş yanıtlar döndüren yerleşik Google Arama temellendirmesine sahip Gemini modellerini destekler.

API anahtarı edinme

openclaw configure --section web

Yapılandırma

{  plugins: {    entries: {      google: {        config: {          webSearch: {            apiKey: "AIza...", // GEMINI_API_KEY veya models.providers.google.apiKey ayarlanmışsa isteğe bağlıdır            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // isteğe bağlıdır; models.providers.google.baseUrl değerine geri döner            model: "gemini-2.5-flash", // varsayılan          },        },      },    },  },  tools: {    web: {      search: {        provider: "gemini",      },    },  },}

Kimlik bilgisi önceliği: Gemini web araması önce plugins.entries.google.config.webSearch.apiKey, ardından GEMINI_API_KEY, son olarak 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.

Gateway kurulumunda ortam anahtarlarını ~/.openclaw/.env dosyasına yerleştirin.

Nasıl çalışır?

Bağlantı ve özet parçacıklarından oluşan bir liste döndüren geleneksel arama sağlayıcılarının aksine Gemini, satır içi kaynak gösterimleriyle yapay zekâ tarafından sentezlenmiş yanıtlar üretmek için Google Arama temellendirmesini kullanır. Sonuçlar hem sentezlenmiş yanıtı hem de kaynak URL'lerini içerir.

• Gemini temellendirmesindeki kaynak gösterimi URL'leri, OpenClaw'ın SSRF korumalı getirme yolu (yönlendirmeleri izleme, http/https doğrulaması) üzerinden yapılan bir HEAD isteğiyle Google yönlendirme URL'lerinden doğrudan URL'lere otomatik olarak çözümlenir.
• 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, ortak web_search uyumluluğu için kabul edilir; ancak Gemini temellendirmesi N sonuçlu bir liste yerine kaynak gösterimleri içeren tek bir sentezlenmiş yanıt döndürmeye devam eder.

freshness; day, week, month, year ve ortak kısayollar olan pd, pw, pm ile py değerlerini kabul eder. day/pd, katı bir 24 saatlik aralık yerine Gemini sorgusuna güncellik talimatı ekler. week, month, year ve açık date_after/date_before aralıkları, Gemini Google Arama 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 uygun maliyetli). 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 bir Gemini uyumlu uç nokta üzerinden yönlendirilmesi gerektiğinde plugins.entries.google.config.webSearch.baseUrl değerini ayarlayın. Bu değer 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 kaldırıldıktan sonra sağlandığı biçimde korunur.

İlgili içerikler

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