Ollama Cloud

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-cloudopenclaw 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

• Ollama
• Provider di modelli
• Tutti i provider