Ricerca web di Ollama

OpenClaw supporta Ollama Web Search come provider web_search integrato, restituendo titoli, URL ed estratti dall'API di ricerca web di Ollama.

Per impostazione predefinita, Ollama locale/auto-ospitato non richiede una chiave API; sono necessari un host Ollama raggiungibile e ollama signin. La ricerca ospitata diretta (senza Ollama locale) richiede baseUrl: "https://ollama.com" e una chiave OLLAMA_API_KEY reale.

Configurazione

ollama signin

openclaw configure --section web

Se usi già Ollama per i modelli, Ollama Web Search riutilizza lo stesso host configurato.

Configurazione

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

Sostituzione facoltativa dell'host, limitata esclusivamente alla ricerca web:

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

In alternativa, riutilizza l'host già configurato per il provider di modelli Ollama:

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

models.providers.ollama.baseUrl è la chiave canonica; il provider di ricerca web accetta anche baseURL in tale posizione per compatibilità con gli esempi di configurazione in stile OpenAI SDK. Se non è impostato nulla, OpenClaw usa per impostazione predefinita http://127.0.0.1:11434.

Ollama Web Search ospitato diretto (senza Ollama locale):

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

Autenticazione e instradamento delle richieste

• Non esiste un campo per la chiave API specifico per la ricerca web; il provider riutilizza models.providers.ollama.apiKey (o l'autenticazione corrispondente del provider basata su variabili d'ambiente) quando l'host configurato è protetto da autenticazione.
• Ordine di risoluzione dell'host: plugins.entries.ollama.config.webSearch.baseUrl → models.providers.ollama.baseUrl (o baseURL) → http://127.0.0.1:11434.
• Se l'host risolto è https://ollama.com, OpenClaw chiama direttamente https://ollama.com/api/web_search usando la chiave API per l'autenticazione bearer.
• In caso contrario, OpenClaw chiama prima l'endpoint proxy locale /api/experimental/web_search (che firma e inoltra la richiesta a Ollama Cloud), quindi, in caso di errore, ripiega su /api/web_search sullo stesso host. Se entrambi falliscono e OLLAMA_API_KEY è impostata, esegue un solo nuovo tentativo verso https://ollama.com/api/web_search con tale chiave, senza inviarla all'host locale.
• Durante la configurazione, OpenClaw mostra un avviso se Ollama non è raggiungibile o non è autenticato, ma non impedisce di selezionare il provider.

Contenuti correlati

• Panoramica della ricerca web -- tutti i provider e il rilevamento automatico
• Ollama -- configurazione dei modelli Ollama e modalità cloud/locale