Gemini araması

OpenClaw, yerleşik Google Search temellendirmesi ile Gemini modellerini destekler. Bu özellik, canlı Google Search sonuçlarıyla desteklenen ve alıntılar içeren, yapay zekâ 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...", // 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, models.providers.google.baseUrl değerinden önce gelir.

Gateway kurulumunda ortam anahtarlarını ~/.openclaw/.env içine yerleştirin.

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 alıntılarla yapay zekâ tarafından sentezlenmiş yanıtlar üretmek için Google Search temellendirmesini kullanır. Sonuçlar hem sentezlenmiş yanıtı hem de kaynak URL'lerini içerir.

• Gemini temellendirmesinden gelen alıntı URL'leri, OpenClaw'ın SSRF korumalı getirme yolu üzerinden yapılan bir HEAD isteğiyle Google yönlendirme URL'lerinden doğrudan URL'lere otomatik olarak çözümlenir (yönlendirmeleri izleme, http/https doğrulaması).
• Yönlendirme çözümlemesi katı SSRF varsayılanlarını kullanır; bu nedenle özel/dahili hedeflere yapılan 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 N sonuçlu bir liste yerine yine de alıntılar içeren tek bir sentezlenmiş yanıt döndürür.

freshness; day, week, month, year ve paylaşılan kısayollar olan pd, pw, pm ve py değerlerini kabul eder. day/pd, kesin bir 24 saatlik aralık yerine Gemini sorgusuna bir güncellik talimatı ekler. week, month, year ve açıkça belirtilen 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 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, Gemini uyumlu bir 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 değerine normalleştirilir; özel proxy yolları ise sondaki eğik çizgiler kaldırıldıktan sonra sağlandıkları biçimde korunur.

İlgili

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