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 is Ollama's gehoste model-API. De provider ollama-cloud roept deze rechtstreeks aan op https://ollama.com via Ollama's eigen /api/chat-API, zonder lokale Ollama-server en zonder lokale Ollama-app die bij de cloudmodus is aangemeld. Gebruik modelverwijzingen zoals ollama-cloud/kimi-k2.6.

OpenClaw registreert ollama-cloud als een eigen provider-id, zodat uitsluitend voor de cloud bestemde referenties, live catalogusdetectie en modelselectie niet worden vermengd met een lokale ollama-host. Zie Ollama voor lokale Ollama, hybride routering via cloud en lokaal, embeddings en details over aangepaste hosts.

Configuratie

Maak een Ollama Cloud-API-sleutel aan op ollama.com/settings/keys en voer daarna het volgende uit:

bash
openclaw onboard --auth-choice ollama-cloud

Of stel het volgende in:

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

Niet-interactieve onboarding accepteert de sleutel rechtstreeks:

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

Onboarding stelt het standaardmodel in op ollama-cloud/kimi-k2.5:cloud.

Standaardwaarden

  • Provider: ollama-cloud
  • Basis-URL: https://ollama.com
  • Omgevingsvariabele: OLLAMA_API_KEY
  • API-stijl: Ollama's eigen /api/chat
  • Standaardmodel voor onboarding: ollama-cloud/kimi-k2.5:cloud

Wanneer u Ollama Cloud kiest

  • U wilt gehoste Ollama-modellen gebruiken zonder lokaal ollama serve uit te voeren.
  • U wilt dezelfde structuur van Ollama's eigen chat-API die OpenClaw gebruikt voor lokale Ollama, maar dan gericht op https://ollama.com.
  • U wilt een eenvoudig cloudtraject voor modellen die al in Ollama's gehoste catalogus staan.
  • U hebt geen lokale modeldownloads, lokale GPU-besturing of uitsluitend via het LAN beschikbare inferentie nodig.

Gebruik in plaats daarvan Ollama als u uitsluitend lokale routering of routering via cloud en lokaal wilt gebruiken via een aangemelde Ollama-host. Gebruik in plaats daarvan een OpenAI-compatibele provider wanneer u /v1/chat/completions-semantiek of providerspecifieke functies in OpenAI-stijl nodig hebt.

Modellen

De provider vereist een API-sleutel; zonder sleutel blijft deze inactief. Met een sleutel detecteert OpenClaw Ollama Cloud-modellen live vanuit de gehoste catalogus:

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

Gehoste id's in de live catalogus zijn onder andere deepseek-v4-flash, glm-5, gpt-oss:20b, kimi-k2.6 en minimax-m2.7. Wanneer live detectie niets retourneert, valt OpenClaw terug op de meegeleverde vermeldingen kimi-k2.5:cloud, minimax-m2.7:cloud, glm-5.1:cloud en glm-5.2:cloud.

Model-id's zijn id's uit de cloudcatalogus, geen namen voor lokale downloads. Als een modelnaam werkt op een lokale Ollama-host maar ontbreekt in de gehoste catalogus, gebruikt u in plaats daarvan de provider ollama met die lokale host.

Livetest

Voor rooktests met Ollama Cloud-API-sleutels richt u de Ollama-livetest op het gehoste eindpunt en kiest u een model uit uw huidige catalogus:

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

De cloud-rooktest voert tekst, eigen streaming en zoeken op het web uit; stel OPENCLAW_LIVE_OLLAMA_WEB_SEARCH=0 in om zoeken op het web over te slaan. Embeddings worden standaard overgeslagen voor https://ollama.com, omdat Ollama Cloud-API-sleutels mogelijk geen toegang verlenen tot /api/embed; dwing ze af met OPENCLAW_LIVE_OLLAMA_EMBEDDINGS=1.

Problemen oplossen

  • Fouten Ollama Cloud requires an API key / Set OLLAMA_API_KEY: geef een echte cloud-API-sleutel op. De lokale markering ollama-local is alleen bedoeld voor lokale of privé-Ollama-hosts.
  • Fouten over onbekende modellen: voer openclaw models list --provider ollama-cloud uit en kopieer de id van het gehoste model exact.
  • Problemen met toolaanroepen of onbewerkte JSON op aangepaste Ollama-hosts: controleer of u per ongeluk een OpenAI-compatibele /v1-URL gebruikt. Ollama-routes moeten de eigen basis-URL zonder het achtervoegsel /v1 gebruiken.

Gerelateerd

Was this useful?
On this page

On this page