Recherche web Ollama

OpenClaw prend en charge Ollama Web Search comme fournisseur web_search intégré, qui renvoie les titres, les URL et des extraits provenant de l’API de recherche web d’Ollama.

Par défaut, Ollama local ou auto-hébergé ne nécessite aucune clé API ; il requiert un hôte Ollama accessible ainsi que ollama signin. La recherche hébergée directe (sans Ollama local) nécessite baseUrl: "https://ollama.com" et une véritable clé OLLAMA_API_KEY.

Configuration

ollama signin

openclaw configure --section web

Si vous utilisez déjà Ollama pour les modèles, Ollama Web Search réutilise le même hôte configuré.

Configuration

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

Remplacement facultatif de l’hôte, limité à la recherche web :

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

Vous pouvez aussi réutiliser l’hôte déjà configuré pour le fournisseur de modèles Ollama :

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

models.providers.ollama.baseUrl est la clé canonique ; le fournisseur de recherche web y accepte également baseURL pour assurer la compatibilité avec les exemples de configuration de style SDK OpenAI. Si rien n’est défini, OpenClaw utilise par défaut http://127.0.0.1:11434.

Ollama Web Search hébergé direct (sans Ollama local) :

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

Authentification et routage des requêtes

• Il n’existe aucun champ de clé API propre à la recherche web ; le fournisseur réutilise models.providers.ollama.apiKey (ou l’authentification correspondante du fournisseur issue de l’environnement) lorsque l’hôte configuré est protégé par authentification.
• Ordre de résolution de l’hôte : plugins.entries.ollama.config.webSearch.baseUrl → models.providers.ollama.baseUrl (ou baseURL) → http://127.0.0.1:11434.
• Si l’hôte résolu est https://ollama.com, OpenClaw appelle directement https://ollama.com/api/web_search en utilisant la clé API comme authentification par jeton porteur.
• Sinon, OpenClaw appelle d’abord le point de terminaison du proxy local /api/experimental/web_search (qui signe la requête et la transmet à Ollama Cloud), puis se replie sur /api/web_search sur le même hôte. Si les deux échouent et que OLLAMA_API_KEY est définie, il réessaie une fois auprès de https://ollama.com/api/web_search avec cette clé, sans l’envoyer à l’hôte local.
• OpenClaw affiche un avertissement pendant la configuration si Ollama est inaccessible ou si aucune session n’y est ouverte, mais n’empêche pas la sélection du fournisseur.

Voir aussi

• Présentation de la recherche web -- tous les fournisseurs et la détection automatique
• Ollama -- configuration des modèles Ollama et modes cloud/local