Skip to main content
O OpenClaw oferece suporte à Pesquisa na Web do Ollama como um provedor web_search integrado, retornando títulos, URLs e trechos da API de pesquisa na web do Ollama. Por padrão, o Ollama local/auto-hospedado não precisa de chave de API; ele requer um host Ollama acessível e a execução de ollama signin. A pesquisa hospedada direta (sem Ollama local) requer baseUrl: "https://ollama.com" e uma OLLAMA_API_KEY válida.

Configuração

1

Iniciar o Ollama

Verifique se o Ollama está instalado e em execução.
2

Fazer login

3

Escolher a Pesquisa na Web do Ollama

Selecione Ollama Web Search como provedor.
Se você já usa o Ollama para modelos, a Pesquisa na Web do Ollama reutiliza o mesmo host configurado.
O OpenClaw nunca seleciona automaticamente a Pesquisa na Web do Ollama em vez de um provedor com credenciais e de prioridade mais alta; você deve escolhê-la explicitamente com tools.web.search.provider: "ollama".

Configuração

Substituição opcional do host, limitada apenas à pesquisa na web:
Ou reutilize o host já configurado para o provedor de modelos Ollama:
models.providers.ollama.baseUrl é a chave canônica; o provedor de pesquisa na web também aceita baseURL nesse local para compatibilidade com exemplos de configuração no estilo do SDK da OpenAI. Se nada estiver definido, o OpenClaw usará como padrão http://127.0.0.1:11434. Pesquisa na Web do Ollama hospedada diretamente (sem Ollama local):

Autenticação e roteamento de solicitações

  • Não existe um campo de chave de API específico para pesquisa na web; o provedor reutiliza models.providers.ollama.apiKey (ou a autenticação correspondente do provedor baseada em variável de ambiente) quando o host configurado é protegido por autenticação.
  • Ordem de resolução do host: plugins.entries.ollama.config.webSearch.baseUrlmodels.providers.ollama.baseUrl (ou baseURL) → http://127.0.0.1:11434.
  • Se o host resolvido for https://ollama.com, o OpenClaw chamará https://ollama.com/api/web_search diretamente, usando a chave de API como autenticação do tipo bearer.
  • Caso contrário, o OpenClaw chamará primeiro o endpoint de proxy local /api/experimental/web_search (que assina e encaminha a solicitação para o Ollama Cloud) e, em seguida, usará como alternativa /api/web_search no mesmo host. Se ambos falharem e OLLAMA_API_KEY estiver definida, ele tentará novamente uma vez em https://ollama.com/api/web_search com essa chave — sem enviá-la ao host local.
  • Durante a configuração, o OpenClaw exibirá um aviso se o Ollama estiver inacessível ou se o login não tiver sido feito, mas não impedirá a seleção do provedor.

Conteúdo relacionado