Pular para o conteúdo principal
O OpenClaw oferece suporte à Pesquisa Web do Ollama como um provedor web_search integrado. Ele usa a API de pesquisa web do Ollama e retorna resultados estruturados com títulos, URLs e trechos. Para Ollama local ou auto-hospedado, essa configuração não precisa de uma chave de API por padrão. Ela exige:
  • um host Ollama acessível pelo OpenClaw
  • ollama signin
Para pesquisa hospedada direta, defina a URL base do provedor Ollama como https://ollama.com e forneça uma OLLAMA_API_KEY real.

​
Configuração

1

Iniciar o Ollama

Certifique-se de que o Ollama esteja instalado e em execução.
2

Fazer login

Execute:
ollama signin
3

Escolher a Pesquisa Web do Ollama

Execute:
openclaw configure --section web
Em seguida, selecione Pesquisa Web do Ollama como o provedor.
Se você já usa o Ollama para modelos, a Pesquisa Web do Ollama reutiliza o mesmo host configurado.

​
Configuração

{
  tools: {
    web: {
      search: {
        provider: "ollama",
      },
    },
  },
}
Substituição opcional do host Ollama: 
{
  plugins: {
    entries: {
      ollama: {
        config: {
          webSearch: {
            baseUrl: "http://ollama-host:11434",
          },
        },
      },
    },
  },
}
Se você já configura o Ollama como provedor de modelos, o provedor de pesquisa web pode reutilizar esse host: 
{
  models: {
    providers: {
      ollama: {
        baseUrl: "http://ollama-host:11434",
      },
    },
  },
}
O provedor de modelos Ollama usa baseUrl como a chave canônica. O provedor de pesquisa web também respeita baseURL em models.providers.ollama para compatibilidade com exemplos de configuração no estilo do SDK da OpenAI. Se nenhuma URL base explícita do Ollama for definida, o OpenClaw usa http://127.0.0.1:11434. Se o host Ollama espera autenticação bearer, o OpenClaw reutiliza models.providers.ollama.apiKey (ou a autenticação de provedor correspondente baseada em env) para solicitações a esse host configurado. Pesquisa Web do Ollama hospedada direta: 
{
  models: {
    providers: {
      ollama: {
        baseUrl: "https://ollama.com",
        apiKey: "OLLAMA_API_KEY",
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "ollama",
      },
    },
  },
}

​
Observações

  • Nenhum campo de chave de API específico de pesquisa web é necessário para este provedor.
  • Se o host Ollama estiver protegido por autenticação, o OpenClaw reutiliza a chave de API normal do provedor Ollama quando presente.
  • Se baseUrl for https://ollama.com, o OpenClaw chama https://ollama.com/api/web_search diretamente e envia a chave de API Ollama configurada como autenticação bearer.
  • Se o host configurado não expuser pesquisa web e OLLAMA_API_KEY estiver definida, o OpenClaw pode recorrer a https://ollama.com/api/web_search sem enviar essa chave env para o host local.
  • O OpenClaw avisa durante a configuração se o Ollama estiver inacessível ou sem login, mas não bloqueia a seleção.
  • O OpenClaw não seleciona automaticamente a Pesquisa Web do Ollama quando nenhum provedor credenciado de prioridade mais alta está configurado; escolha-o explicitamente com tools.web.search.provider: "ollama".
  • Hosts do daemon local do Ollama usam o endpoint de proxy local /api/experimental/web_search, que assina e encaminha para a Nuvem Ollama.
  • Hosts https://ollama.com usam o endpoint hospedado público /api/web_search diretamente com autenticação bearer por chave de API.

​
Relacionados