Búsqueda web de Ollama

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

De forma predeterminada, Ollama local o autoalojado no necesita una clave de API; requiere un host de Ollama accesible y ejecutar ollama signin. La búsqueda alojada directa (sin Ollama local) necesita baseUrl: "https://ollama.com" y una OLLAMA_API_KEY real.

Configuración

ollama signin

openclaw configure --section web

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

Configuración

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

Modificación opcional del host, limitada únicamente a la búsqueda web:

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

También puedes reutilizar el host ya configurado para el proveedor de modelos de Ollama:

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

models.providers.ollama.baseUrl es la clave canónica; el proveedor de búsqueda web también acepta baseURL allí por compatibilidad con ejemplos de configuración del estilo del SDK de OpenAI. Si no se configura nada, OpenClaw usa de forma predeterminada http://127.0.0.1:11434.

Ollama Web Search alojado directo (sin Ollama local):

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

Autenticación y enrutamiento de solicitudes

• No existe ningún campo de clave de API específico para la búsqueda web; el proveedor reutiliza models.providers.ollama.apiKey (o la autenticación correspondiente del proveedor respaldada por una variable de entorno) cuando el host configurado está protegido mediante autenticación.
• Orden de resolución del host: plugins.entries.ollama.config.webSearch.baseUrl → models.providers.ollama.baseUrl (o baseURL) → http://127.0.0.1:11434.
• Si el host resuelto es https://ollama.com, OpenClaw llama directamente a https://ollama.com/api/web_search con la clave de API como autenticación de portador.
• De lo contrario, OpenClaw llama primero al punto de conexión del proxy local /api/experimental/web_search (que firma y reenvía la solicitud a Ollama Cloud) y, si falla, recurre a /api/web_search en el mismo host. Si ambos fallan y OLLAMA_API_KEY está configurada, vuelve a intentarlo una vez contra https://ollama.com/api/web_search con esa clave, sin enviarla al host local.
• OpenClaw muestra una advertencia durante la configuración si Ollama no es accesible o no se ha iniciado sesión, pero no impide seleccionar el proveedor.

Contenido relacionado

• Descripción general de la búsqueda web -- todos los proveedores y la detección automática
• Ollama -- configuración de modelos de Ollama y modos locales/en la nube