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 è l'API per modelli in hosting di Ollama. Il provider ollama-cloud la chiama direttamente all'indirizzo https://ollama.com tramite l'API nativa /api/chat di Ollama, senza un server Ollama locale e senza un'app Ollama locale connessa in modalità cloud. Usa riferimenti ai modelli come ollama-cloud/kimi-k2.6.

OpenClaw registra ollama-cloud come ID provider autonomo, affinché le credenziali esclusivamente cloud, il rilevamento in tempo reale del catalogo e la selezione dei modelli non vengano mescolati con un host ollama locale. Per Ollama locale, l'instradamento ibrido cloud e locale, gli embedding e i dettagli degli host personalizzati, consulta Ollama.

Configurazione

Crea una chiave API di Ollama Cloud su ollama.com/settings/keys, quindi esegui:

bash
openclaw onboard --auth-choice ollama-cloud

Oppure imposta:

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

L'onboarding non interattivo accetta direttamente la chiave:

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

L'onboarding imposta come modello predefinito ollama-cloud/kimi-k2.5:cloud.

Valori predefiniti

  • Provider: ollama-cloud
  • URL di base: https://ollama.com
  • Variabile d'ambiente: OLLAMA_API_KEY
  • Stile API: /api/chat nativa di Ollama
  • Modello predefinito dell'onboarding: ollama-cloud/kimi-k2.5:cloud

Quando scegliere Ollama Cloud

  • Vuoi modelli Ollama in hosting senza eseguire ollama serve localmente.
  • Vuoi la stessa struttura dell'API di chat nativa di Ollama usata da OpenClaw per Ollama locale, ma indirizzata a https://ollama.com.
  • Vuoi un percorso cloud semplice per i modelli già presenti nel catalogo in hosting di Ollama.
  • Non hai bisogno di scaricare modelli localmente, controllare GPU locali o eseguire inferenza esclusivamente sulla LAN.

Usa invece Ollama quando desideri un instradamento esclusivamente locale o ibrido cloud e locale tramite un host Ollama connesso. Usa invece un provider compatibile con OpenAI quando ti occorre la semantica di /v1/chat/completions o funzionalità specifiche del provider in stile OpenAI.

Modelli

Il provider richiede una chiave API; senza una chiave rimane inattivo. Con una chiave, OpenClaw rileva in tempo reale i modelli Ollama Cloud dal catalogo in hosting:

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

Gli ID in hosting presenti nel catalogo in tempo reale includono deepseek-v4-flash, glm-5, gpt-oss:20b, kimi-k2.6 e minimax-m2.7. Quando il rilevamento in tempo reale non restituisce nulla, OpenClaw ricorre alle voci incluse kimi-k2.5:cloud, minimax-m2.7:cloud, glm-5.1:cloud e glm-5.2:cloud.

Gli ID dei modelli sono ID del catalogo cloud, non nomi per il download locale. Se il nome di un modello funziona in un host Ollama locale ma non è presente nel catalogo in hosting, usa invece il provider ollama con tale host locale.

Test in tempo reale

Per i test di controllo con chiave API di Ollama Cloud, indirizza il test in tempo reale di Ollama all'endpoint in hosting e scegli un modello dal tuo catalogo attuale:

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

Il controllo cloud esegue testo, streaming nativo e ricerca web; imposta OPENCLAW_LIVE_OLLAMA_WEB_SEARCH=0 per saltare la ricerca web. Per impostazione predefinita salta gli embedding per https://ollama.com, perché le chiavi API di Ollama Cloud potrebbero non autorizzare /api/embed; forzali con OPENCLAW_LIVE_OLLAMA_EMBEDDINGS=1.

Risoluzione dei problemi

  • Errori Ollama Cloud requires an API key / Set OLLAMA_API_KEY: fornisci una vera chiave API cloud. Il marcatore locale ollama-local serve solo per host Ollama locali o privati.
  • Errori di modello sconosciuto: esegui openclaw models list --provider ollama-cloud e copia esattamente l'ID del modello in hosting.
  • Problemi con le chiamate agli strumenti o con JSON non elaborato su host Ollama personalizzati: verifica di non stare usando accidentalmente un URL /v1 compatibile con OpenAI. Le route Ollama devono usare l'URL di base nativo senza il suffisso /v1.

Risorse correlate

Was this useful?
On this page

On this page