OpenClaw avec Ollama

Ollama est le chemin le plus facile de la documentation vers un modèle local, et sa page s’ouvre sur un avertissement plutôt qu’un accueil : OpenClaw parle à l’API native d’Ollama, et le pointer vers l’URL compatible OpenAI casse les appels d’outils. Trois modes sont pris en charge, cloud plus local via un hôte connecté, cloud seul contre le service d’Ollama, et local seul. Voici ce que le démarrage découvre et ce qu’il refuse de supposer, les règles d’authentification par type d’hôte, la liste de dépannage, et la règle sur les petits modèles qui ne disparaît pas parce que le modèle est gratuit.

N’utilisez pas l’URL compatible OpenAI /v1 (http://host:11434/v1). Elle casse les appels d’outils et les modèles peuvent émettre le JSON brut des appels d’outils comme du texte.

Configuration

• Le démarrage : sélectionnez Ollama et choisissez un mode. Sur une configuration guidée neuve, OpenClaw vérifie l’hôte par défaut ou configuré, et la découverte automatique ne considère que les modèles déjà chargés en mémoire, avec prise en charge des outils et au moins 16K de contexte confirmés ; un modèle installé mais inactif n’est pas candidat, la route exige une vraie complétion avant d’être enregistrée, et la découverte ne télécharge ni ne charge jamais rien.
• Cloud seul demande la clé d’API et suggère des valeurs hébergées par défaut ; cloud plus local et local seul demandent une URL de base et inspectent les modèles installés, et si aucun modèle capable d’outils n’est trouvé, la configuration peut demander la permission d’en télécharger un recommandé. Un modèle annoncé comme réservé aux embeddings ne peut pas devenir le modèle de discussion par défaut.
• À la main : installez Ollama, téléchargez un modèle, connectez-vous sur le même hôte pour l’accès cloud hybride, définissez un identifiant, n’importe quelle valeur pour un hôte local ou LAN et la vraie clé pour le service d’Ollama, puis définissez la référence de modèle comme ollama, barre oblique, le nom du modèle.

Règles d’authentification

Les hôtes en boucle locale, en réseau privé, en point-local et en simple nom d’hôte n’exigent aucun vrai jeton ; OpenClaw utilise un marqueur local pour eux. Les hôtes distants publics et le service d’Ollama exigent un vrai identifiant, et la documentation préfère l’identifiant de fournisseur cloud dédié pour l’usage hébergé direct afin que le routage cloud reste séparé d’un fournisseur local. Une clé d’environnement nue est traitée comme la convention cloud et n’est pas envoyée aux hôtes locaux par défaut, et l’authentification par jeton pour les embeddings de mémoire est limitée à l’hôte pour lequel elle a été déclarée.

Dépannage

• Boucle de plantage WSL2 : l’installateur Linux officiel crée un service avec redémarrage permanent ; sur une configuration CUDA il peut charger un modèle au démarrage, épingler la mémoire de l’hôte, voir la VM arrêtée par Windows, et redémarrer sans fin. Désactivez le service, coupez la récupération automatique de mémoire dans la configuration WSL, ou lancez Ollama à la main avec un maintien court.
• Non détecté : confirmez qu’il tourne et qu’il est dans la portée de modèles de l’agent ; la découverte ambiante sur localhost exige la variable de clé ou un profil d’authentification, et une liste manuelle de modèles non vide saute complètement la découverte.
• Aucun modèle : téléchargez-en un ou définissez-le explicitement. Connexion refusée : vérifiez le processus et redémarrez. JSON d’outils affiché en texte : l’URL compatible OpenAI, l’erreur du haut de la page.

Des modèles gratuits pour OpenClaw place Ollama à côté de LM Studio, llama.cpp et des autres moteurs, et Installer OpenClaw sous Windows est là où commence la configuration WSL2.

La règle qui s’applique toujours

La FAQ des modèles le dit dans le même souffle que le démarrage rapide d’Ollama : les modèles plus petits et fortement quantifiés sont plus vulnérables à l’injection de prompt, utilisez de grands modèles pour tout bot ayant accès à des outils, et si vous utilisez quand même des petits, activez le bac à sable et des listes d’outils strictes. OpenClaw et l’injection de prompt explique l’attaque et Le bac à sable d’OpenClaw expliqué le confinement.

Sur Diali

Sur Diali, il n’y a pas d’Ollama à installer : les modèles sont dans le catalogue géré et payés par les crédits inclus. OpenClaw hébergé sur Diali est l’assistant, et Modèles et fournisseurs d’OpenClaw liste ce que couvre le catalogue.

• L’API native, jamais l’URL compatible OpenAI.
• La découverte ne voit que les modèles chargés ; la configuration ne télécharge rien sans demander.
• Les hôtes locaux exigent un marqueur, les hôtes distants une clé, les petits modèles un bac à sable.