Pesquisa do Gemini

O OpenClaw oferece suporte a modelos Gemini com fundamentação na Pesquisa Google integrada, que retorna respostas sintetizadas por IA, respaldadas por resultados em tempo real da Pesquisa Google e acompanhadas de citações.

Obter uma chave de API

openclaw configure --section web

Configuração

{  plugins: {    entries: {      google: {        config: {          webSearch: {            apiKey: "AIza...", // opcional se GEMINI_API_KEY ou models.providers.google.apiKey estiver definido            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // opcional; recorre a models.providers.google.baseUrl            model: "gemini-2.5-flash", // padrão          },        },      },    },  },  tools: {    web: {      search: {        provider: "gemini",      },    },  },}

Precedência de credenciais: a pesquisa na web do Gemini usa primeiro plugins.entries.google.config.webSearch.apiKey, depois GEMINI_API_KEY e, por fim, models.providers.google.apiKey. Para URLs base, a configuração dedicada plugins.entries.google.config.webSearch.baseUrl tem precedência sobre models.providers.google.baseUrl.

Em uma instalação do Gateway, coloque as chaves de ambiente em ~/.openclaw/.env.

Como funciona

Ao contrário dos provedores de pesquisa tradicionais, que retornam uma lista de links e trechos, o Gemini usa a fundamentação na Pesquisa Google para produzir respostas sintetizadas por IA com citações em linha. Os resultados incluem tanto a resposta sintetizada quanto os URLs das fontes.

• Os URLs de citação da fundamentação do Gemini são resolvidos automaticamente, de URLs de redirecionamento do Google para URLs diretos, por meio de uma solicitação HEAD no caminho de busca do OpenClaw protegido contra SSRF (seguimento de redirecionamentos e validação de http/https).
• A resolução de redirecionamentos usa padrões rigorosos de proteção contra SSRF; portanto, redirecionamentos para destinos privados ou internos são bloqueados.

Parâmetros compatíveis

A pesquisa do Gemini oferece suporte a query, freshness, date_after e date_before.

count é aceito para compatibilidade com o web_search compartilhado, mas a fundamentação do Gemini ainda retorna uma única resposta sintetizada com citações, em vez de uma lista com N resultados.

freshness aceita day, week, month, year e os atalhos compartilhados pd, pw, pm e py. day/pd adiciona uma instrução de recência à consulta do Gemini, em vez de um intervalo rígido de 24 horas. week, month, year e intervalos explícitos de date_after/date_before definem o timeRangeFilter da fundamentação na Pesquisa Google do Gemini. country, language e domain_filter não são compatíveis.

Seleção do modelo

O modelo padrão é gemini-2.5-flash (rápido e econômico). Qualquer modelo Gemini compatível com fundamentação pode ser usado por meio de plugins.entries.google.config.webSearch.model.

Substituições do URL base

Defina plugins.entries.google.config.webSearch.baseUrl quando a pesquisa na web do Gemini precisar ser encaminhada por um proxy do operador ou por um endpoint personalizado compatível com o Gemini. Se essa opção não estiver definida, a pesquisa na web do Gemini reutilizará models.providers.google.baseUrl. Um valor simples como https://generativelanguage.googleapis.com é normalizado para https://generativelanguage.googleapis.com/v1beta; caminhos de proxy personalizados são mantidos conforme fornecidos após a remoção das barras finais.

Relacionados

• Visão geral da pesquisa na web -- todos os provedores e detecção automática
• Brave Search -- resultados estruturados com trechos
• Perplexity Search -- resultados estruturados + extração de conteúdo