Vai al contenuto principale
Ollama Cloud è l’API di modelli ospitata di Ollama. Permette a OpenClaw di chiamare direttamente i modelli ospitati da Ollama, senza installare un server Ollama locale o autenticare un’app Ollama locale in modalità cloud. Usa l’id provider ollama-cloud e riferimenti modello come ollama-cloud/kimi-k2.6. Questa pagina riguarda l’instradamento diretto solo cloud. Il provider usa lo stile nativo /api/chat di Ollama, non la route compatibile con OpenAI /v1. OpenClaw lo registra come id provider separato, così le credenziali solo cloud, la scoperta del catalogo live e la selezione del modello non vengono mescolate con un host ollama locale. Usa questa pagina quando vuoi un instradamento solo cloud. Per Ollama locale, instradamento ibrido cloud più locale, embeddings e dettagli di host personalizzati, vedi Ollama.

​
Configurazione

Crea una chiave API di Ollama Cloud su ollama.com/settings/keys, quindi esegui: 
openclaw onboard --auth-choice ollama-cloud
Oppure imposta: 
export OLLAMA_API_KEY="<your-ollama-cloud-api-key>" # pragma: allowlist secret

​
Valori predefiniti

  • Provider: ollama-cloud
  • URL base: https://ollama.com
  • Variabile di ambiente: OLLAMA_API_KEY
  • Stile API: /api/chat nativo di Ollama
  • Modello di esempio: ollama-cloud/kimi-k2.6

​
Quando scegliere Ollama Cloud

  • Vuoi modelli Ollama ospitati senza eseguire ollama serve in locale.
  • Vuoi la stessa forma dell’API chat nativa di Ollama che OpenClaw usa per Ollama locale, ma puntata a https://ollama.com.
  • Vuoi un percorso cloud semplice per modelli che sono già nel catalogo ospitato di Ollama.
  • Non ti servono pull di modelli locali, controllo GPU locale o inferenza solo LAN.
Usa invece Ollama quando vuoi un instradamento solo locale o cloud più locale tramite un host Ollama autenticato. Usa invece un provider compatibile con OpenAI quando ti servono semantiche /v1/chat/completions o funzionalità in stile OpenAI specifiche del provider.

​
Modelli

OpenClaw scopre i modelli Ollama Cloud dal catalogo ospitato live. Gli id ospitati comunemente disponibili includono:
  • ollama-cloud/gpt-oss:20b
  • ollama-cloud/kimi-k2.6
  • ollama-cloud/deepseek-v4-flash
  • ollama-cloud/minimax-m2.7
  • ollama-cloud/glm-5
Usa un id modello dal tuo catalogo ospitato corrente: 
openclaw models list --provider ollama-cloud
openclaw models set ollama-cloud/kimi-k2.6
Gli id modello sono id del catalogo cloud, non nomi di pull locali. Se un nome modello funziona in un host Ollama locale ma è assente dal catalogo ospitato, usa invece il provider ollama con quell’host locale.

​
Test live

Per smoke test con chiave API di Ollama Cloud, punta il test live di Ollama all’endpoint ospitato e scegli un modello dal tuo catalogo corrente: 
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 \
OPENCLAW_LIVE_OLLAMA_WEB_SEARCH=1 \
pnpm test:live -- extensions/ollama/ollama.live.test.ts
Lo smoke cloud esegue testo, stream nativo e ricerca web. Salta gli embeddings per impostazione predefinita per https://ollama.com perché le chiavi API di Ollama Cloud potrebbero non autorizzare /api/embed.

​
Risoluzione dei problemi

  • Errori Set OLLAMA_API_KEY: fornisci una vera chiave API cloud. Il marker locale ollama-local è solo per host Ollama locali o privati.
  • Errori di modello sconosciuto: esegui openclaw models list --provider ollama-cloud e copia esattamente l’id modello ospitato.
  • Problemi di chiamata strumenti o JSON grezzo su host Ollama personalizzati: controlla se stai usando accidentalmente un URL /v1 compatibile con OpenAI. Le route Ollama dovrebbero usare l’URL base nativo senza suffisso /v1.

​
Correlati