Tools

Búsqueda web de Ollama

OpenClaw admite Ollama Web Search como proveedor web_search incluido. Usa la API de búsqueda web de Ollama y devuelve resultados estructurados con títulos, URL y fragmentos.

Para Ollama local o autoalojado, esta configuración no necesita una clave de API de forma predeterminada. Sí requiere:

  • un host de Ollama accesible desde OpenClaw
  • ollama signin

Para búsqueda alojada directa, establece la URL base del proveedor Ollama en https://ollama.com y proporciona una OLLAMA_API_KEY real.

Configuración

  • Iniciar Ollama

    Asegúrate de que Ollama esté instalado y en ejecución.

  • Iniciar sesión

    Ejecuta:

    bash
    ollama signin
  • Elegir Ollama Web Search

    Ejecuta:

    bash
    openclaw configure --section web

    Luego selecciona Ollama Web Search como proveedor.

  • Si ya usas Ollama para modelos, Ollama Web Search reutiliza el mismo host configurado.

    Configuración

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

    Anulación opcional del host de Ollama:

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

    Si ya configuras Ollama como proveedor de modelos, el proveedor de búsqueda web puede reutilizar ese host en su lugar:

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

    El proveedor de modelos Ollama usa baseUrl como clave canónica. El proveedor de búsqueda web también respeta baseURL en models.providers.ollama para compatibilidad con ejemplos de configuración de estilo SDK de OpenAI.

    Si no se establece ninguna URL base explícita de Ollama, OpenClaw usa http://127.0.0.1:11434.

    Si tu host de Ollama espera autenticación bearer, OpenClaw reutiliza models.providers.ollama.apiKey (o la autenticación de proveedor respaldada por la variable de entorno correspondiente) para las solicitudes a ese host configurado.

    Ollama Web Search alojado directo:

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

    Notas

    • No se requiere ningún campo de clave de API específico de búsqueda web para este proveedor.
    • Si el host de Ollama está protegido con autenticación, OpenClaw reutiliza la clave de API normal del proveedor Ollama cuando está presente.
    • Si baseUrl es https://ollama.com, OpenClaw llama directamente a https://ollama.com/api/web_search y envía la clave de API de Ollama configurada como autenticación bearer.
    • Si el host configurado no expone búsqueda web y OLLAMA_API_KEY está definido, OpenClaw puede recurrir a https://ollama.com/api/web_search sin enviar esa clave de entorno al host local.
    • OpenClaw advierte durante la configuración si Ollama no es accesible o no tiene sesión iniciada, pero no bloquea la selección.
    • OpenClaw no selecciona automáticamente Ollama Web Search cuando no hay configurado ningún proveedor con credenciales de mayor prioridad; elígelo explícitamente con tools.web.search.provider: "ollama".
    • Los hosts locales del daemon Ollama usan el endpoint de proxy local /api/experimental/web_search, que firma y reenvía a Ollama Cloud.
    • Los hosts https://ollama.com usan directamente el endpoint público alojado /api/web_search con autenticación de clave de API bearer.

    Relacionado

    Was this useful?
    On this page

    On this page