OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Ollama Cloud

Ollama Cloud est l’API de modèles hébergée d’Ollama. Le fournisseur ollama-cloud l’appelle directement à l’adresse https://ollama.com via l’API native /api/chat d’Ollama, sans serveur Ollama local ni application Ollama locale connectée en mode cloud. Utilisez des références de modèle telles que ollama-cloud/kimi-k2.6.

OpenClaw enregistre ollama-cloud avec son propre identifiant de fournisseur afin que les identifiants cloud uniquement, la découverte en direct du catalogue et la sélection des modèles ne soient pas mélangés avec un hôte ollama local. Pour Ollama en local, le routage hybride cloud et local, les plongements et les détails d’un hôte personnalisé, consultez Ollama.

Configuration

Créez une clé d’API Ollama Cloud sur ollama.com/settings/keys, puis exécutez :

bash
openclaw onboard --auth-choice ollama-cloud

Ou définissez :

bash
export OLLAMA_API_KEY="<your-ollama-cloud-api-key>" # pragma: allowlist secret

L’intégration non interactive accepte directement la clé :

bash
openclaw onboard --auth-choice ollama-cloud --ollama-cloud-api-key "<key>"

L’intégration définit le modèle par défaut sur ollama-cloud/kimi-k2.5:cloud.

Valeurs par défaut

  • Fournisseur : ollama-cloud
  • URL de base : https://ollama.com
  • Variable d’environnement : OLLAMA_API_KEY
  • Style d’API : API native Ollama /api/chat
  • Modèle par défaut de l’intégration : ollama-cloud/kimi-k2.5:cloud

Quand choisir Ollama Cloud

  • Vous souhaitez utiliser des modèles Ollama hébergés sans exécuter ollama serve localement.
  • Vous souhaitez utiliser la même structure d’API de conversation native d’Ollama qu’OpenClaw emploie pour Ollama en local, mais en ciblant https://ollama.com.
  • Vous souhaitez un accès cloud simple aux modèles déjà présents dans le catalogue hébergé d’Ollama.
  • Vous n’avez pas besoin de télécharger les modèles localement, de contrôler un GPU local ni d’effectuer l’inférence uniquement sur le réseau local.

Utilisez plutôt Ollama si vous souhaitez un routage uniquement local ou hybride cloud et local via un hôte Ollama connecté. Utilisez plutôt un fournisseur compatible avec OpenAI si vous avez besoin de la sémantique de /v1/chat/completions ou de fonctionnalités propres au fournisseur dans le style d’OpenAI.

Modèles

Le fournisseur nécessite une clé d’API ; sans elle, il reste inactif. Lorsqu’une clé est disponible, OpenClaw découvre en direct les modèles Ollama Cloud dans le catalogue hébergé :

bash
openclaw models list --provider ollama-cloudopenclaw models set ollama-cloud/kimi-k2.6

Les identifiants hébergés du catalogue en direct comprennent deepseek-v4-flash, glm-5, gpt-oss:20b, kimi-k2.6 et minimax-m2.7. Lorsque la découverte en direct ne renvoie rien, OpenClaw utilise comme solution de repli les entrées intégrées kimi-k2.5:cloud, minimax-m2.7:cloud, glm-5.1:cloud et glm-5.2:cloud.

Les identifiants de modèles sont ceux du catalogue cloud, et non les noms utilisés pour les téléchargements locaux. Si un nom de modèle fonctionne sur un hôte Ollama local, mais ne figure pas dans le catalogue hébergé, utilisez plutôt le fournisseur ollama avec cet hôte local.

Test en direct

Pour les tests de bon fonctionnement d’Ollama Cloud avec une clé d’API, faites pointer le test en direct d’Ollama vers le point de terminaison hébergé et choisissez un modèle dans votre catalogue actuel :

bash
export OLLAMA_API_KEY="<your-ollama-cloud-api-key>" # pragma: allowlist secret OPENCLAW_LIVE_TEST=1 \OPENCLAW_LIVE_OLLAMA=1 \OPENCLAW_LIVE_OLLAMA_BASE_URL=https://ollama.com \OPENCLAW_LIVE_OLLAMA_MODEL=kimi-k2.6 \pnpm test:live -- extensions/ollama/ollama.live.test.ts

Le test de bon fonctionnement du cloud vérifie le texte, le flux natif et la recherche sur le Web ; définissez OPENCLAW_LIVE_OLLAMA_WEB_SEARCH=0 pour ignorer la recherche sur le Web. Il ignore par défaut les plongements pour https://ollama.com, car les clés d’API Ollama Cloud peuvent ne pas autoriser /api/embed ; forcez leur test avec OPENCLAW_LIVE_OLLAMA_EMBEDDINGS=1.

Dépannage

  • Erreurs Ollama Cloud requires an API key / Set OLLAMA_API_KEY : fournissez une véritable clé d’API cloud. Le marqueur local ollama-local est réservé aux hôtes Ollama locaux ou privés.
  • Erreurs de modèle inconnu : exécutez openclaw models list --provider ollama-cloud et copiez exactement l’identifiant du modèle hébergé.
  • Problèmes d’appel d’outil ou de JSON brut sur des hôtes Ollama personnalisés : vérifiez que vous n’utilisez pas accidentellement une URL /v1 compatible avec OpenAI. Les routes Ollama doivent utiliser l’URL de base native sans suffixe /v1.

Pages connexes

Was this useful?
On this page

On this page