Pesquisa do Gemini

OpenClaw oferece suporte a modelos Gemini com fundamentação integrada do Google Search, que retorna respostas sintetizadas por IA apoiadas por resultados ativos do Google Search com citações.

Obter uma chave de API

openclaw configure --section web

Configuração

{  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",      },    },  },}

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

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

Como funciona

Diferentemente dos provedores de pesquisa tradicionais que retornam uma lista de links e trechos, o Gemini usa a fundamentação do Google Search para produzir respostas sintetizadas por IA com citações em linha. Os resultados incluem tanto a resposta sintetizada quanto os URLs de origem.

• URLs de citação da fundamentação do Gemini são resolvidos automaticamente dos URLs de redirecionamento do Google para URLs diretos.
• A resolução de redirecionamento usa o caminho de proteção contra SSRF (HEAD + verificações de redirecionamento + validação de http/https) antes de retornar o URL final da citação.
• A resolução de redirecionamento usa padrões rigorosos de SSRF, portanto redirecionamentos para destinos privados/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 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 do Google Search do Gemini. country, language e domain_filter não são compatíveis.

Seleção de 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 via plugins.entries.google.config.webSearch.model.

Substituições de URL base

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

Relacionado

• 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