Pesquisa na web do Ollama

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

ollama signin

openclaw configure --section web

Se você já usa o Ollama para modelos, a Pesquisa na Web do Ollama reutiliza o mesmo host configurado.

Configuração

{  tools: {    web: {      search: {        provider: "ollama",      },    },  },}

Substituição opcional do host, limitada apenas à pesquisa na web:

{  plugins: {    entries: {      ollama: {        config: {          webSearch: {            baseUrl: "http://ollama-host:11434",          },        },      },    },  },}

Ou reutilize o host já configurado para o provedor de modelos Ollama:

{  models: {    providers: {      ollama: {        baseUrl: "http://ollama-host:11434",      },    },  },}

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):

{  models: {    providers: {      ollama: {        baseUrl: "https://ollama.com",        apiKey: "OLLAMA_API_KEY",      },    },  },  tools: {    web: {      search: {        provider: "ollama",      },    },  },}

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.baseUrl → models.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

• Visão geral da pesquisa na web -- todos os provedores e detecção automática
• Ollama -- configuração de modelos Ollama e modos locais/na nuvem