Ricerca web di Ollama

OpenClaw supporta Ollama Web Search come provider web_search incluso. Usa l'API di ricerca web di Ollama e restituisce risultati strutturati con titoli, URL e snippet.

Per Ollama locale o self-hosted, questa configurazione non richiede una chiave API per impostazione predefinita. Richiede invece:

• un host Ollama raggiungibile da OpenClaw
• ollama signin

Per la ricerca hosted diretta, imposta l'URL base del provider Ollama su https://ollama.com e fornisci una vera OLLAMA_API_KEY.

# 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",
      },
    },
  },
}

Override facoltativo dell'host Ollama:

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

Se configuri già Ollama come provider di modelli, il provider di ricerca web può riutilizzare invece quell'host:

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

Il provider di modelli Ollama usa baseUrl come chiave canonica. Il provider di ricerca web rispetta anche baseURL su models.providers.ollama per compatibilità con gli esempi di configurazione in stile SDK OpenAI.

Se non è impostato alcun URL base esplicito per Ollama, OpenClaw usa http://127.0.0.1:11434.

Se il tuo host Ollama richiede autenticazione bearer, OpenClaw riutilizza models.providers.ollama.apiKey (o l'autenticazione del provider corrispondente basata su env) per le richieste a quell'host configurato.

Ollama Web Search hosted diretto:

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

# Note

• Per questo provider non è richiesto alcun campo chiave API specifico per la ricerca web.
• Se l'host Ollama è protetto da autenticazione, OpenClaw riutilizza la normale chiave API del provider Ollama quando presente.
• Se baseUrl è https://ollama.com, OpenClaw chiama direttamente https://ollama.com/api/web_search e invia la chiave API Ollama configurata come autenticazione bearer.
• Se l'host configurato non espone la ricerca web e OLLAMA_API_KEY è impostata, OpenClaw può eseguire il fallback a https://ollama.com/api/web_search senza inviare quella chiave env all'host locale.
• OpenClaw avvisa durante la configurazione se Ollama non è raggiungibile o se l'accesso non è stato effettuato, ma non blocca la selezione.
• Il rilevamento automatico a runtime può eseguire il fallback a Ollama Web Search quando non è configurato alcun provider con credenziali a priorità più alta.
• Gli host del daemon Ollama locale usano l'endpoint proxy locale /api/experimental/web_search, che firma e inoltra a Ollama Cloud.
• Gli host https://ollama.com usano direttamente l'endpoint hosted pubblico /api/web_search con autenticazione bearer tramite chiave API.

# Correlati

• Panoramica di Web Search -- tutti i provider e il rilevamento automatico
• Ollama -- configurazione del modello Ollama e modalità cloud/locali