Pular para o conteúdo principal

​
Gemini Search

O OpenClaw oferece suporte a modelos Gemini com grounding do Google Search integrado, que retorna respostas sintetizadas por IA com base em resultados ao vivo do Google Search e com citações.

​
Obter uma chave de API

1

Criar uma chave

Vá para o Google AI Studio e crie uma chave de API.
2

Armazenar a chave

Defina GEMINI_API_KEY no ambiente do Gateway ou configure via:
openclaw configure --section web

​
Configuração

{
  plugins: {
    entries: {
      google: {
        config: {
          webSearch: {
            apiKey: "AIza...", // opcional se GEMINI_API_KEY estiver definida
            model: "gemini-2.5-flash", // padrão
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "gemini",
      },
    },
  },
}
Alternativa por ambiente: defina GEMINI_API_KEY no ambiente do Gateway. Para uma instalação do gateway, coloque-a em ~/.openclaw/.env.

​
Como funciona

Ao contrário de provedores de busca tradicionais que retornam uma lista de links e snippets, o Gemini usa grounding do Google Search para produzir respostas sintetizadas por IA com citações embutidas. Os resultados incluem tanto a resposta sintetizada quanto as URLs de origem.
  • URLs de citação do grounding do Gemini são automaticamente resolvidas de URLs de redirecionamento do Google para URLs diretas.
  • A resolução de redirecionamento usa o caminho de proteção SSRF (HEAD + verificações de redirecionamento + validação de http/https) antes de retornar a URL de citação final.
  • A resolução de redirecionamento usa padrões estritos de SSRF, portanto redirecionamentos para destinos privados/internos são bloqueados.

​
Parâmetros compatíveis

A busca Gemini oferece suporte a query. count é aceito para compatibilidade compartilhada com web_search, mas o grounding do Gemini ainda retorna uma única resposta sintetizada com citações em vez de uma lista com N resultados. Filtros específicos do provedor como country, language, freshness e domain_filter não são compatíveis.

​
Seleção de modelo

O modelo padrão é gemini-2.5-flash (rápido e com bom custo-benefício). Qualquer modelo Gemini que ofereça suporte a grounding pode ser usado via plugins.entries.google.config.webSearch.model.

​
Relacionado