Saltar al contenido principal
OpenClaw admite Búsqueda web de Ollama como proveedor web_search incluido, que devuelve títulos, URL y fragmentos de la API de búsqueda web de Ollama. Ollama local/autohospedado no necesita clave de API de forma predeterminada; requiere un host de Ollama accesible además de ollama signin. La búsqueda alojada directa (sin Ollama local) necesita baseUrl: "https://ollama.com" y una OLLAMA_API_KEY real.

Configuración

1

Inicia Ollama

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

Inicia sesión

ollama signin
3

Elige Búsqueda web de Ollama

openclaw configure --section web
Selecciona Búsqueda web de Ollama como proveedor.
Si ya usas Ollama para modelos, Búsqueda web de Ollama reutiliza el mismo host configurado.
OpenClaw nunca selecciona automáticamente Búsqueda web de Ollama sobre un proveedor con credenciales de mayor prioridad; debes elegirlo explícitamente con tools.web.search.provider: "ollama".

Configuración

{
  tools: {
    web: {
      search: {
        provider: "ollama",
      },
    },
  },
}
Anulación opcional del host, limitada solo a la búsqueda web:
{
  plugins: {
    entries: {
      ollama: {
        config: {
          webSearch: {
            baseUrl: "http://ollama-host:11434",
          },
        },
      },
    },
  },
}
O reutiliza el host ya configurado para el proveedor de modelos 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 de estilo OpenAI SDK. Si no se configura nada, OpenClaw usa de forma predeterminada http://127.0.0.1:11434. Búsqueda web de Ollama alojada directa (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 del proveedor correspondiente respaldada por el entorno) cuando el host configurado está protegido con autenticación.
  • Orden de resolución del host: plugins.entries.ollama.config.webSearch.baseUrlmodels.providers.ollama.baseUrl (o baseURL) → http://127.0.0.1:11434.
  • Si el host resuelto es https://ollama.com, OpenClaw llama a https://ollama.com/api/web_search directamente con la clave de API como autenticación bearer.
  • De lo contrario, OpenClaw llama primero al endpoint de proxy local /api/experimental/web_search (que firma y reenvía a Ollama Cloud), y luego recurre a /api/web_search en el mismo host. Si ambos fallan y OLLAMA_API_KEY está configurada, reintenta una vez contra https://ollama.com/api/web_search con esa clave, sin enviarla al host local.
  • OpenClaw advierte durante la configuración si Ollama no está accesible o no tiene una sesión iniciada, pero no bloquea la selección del proveedor.

Relacionado