Ollama Cloud

Ollama Cloud ist Ollamas gehostete Modell-API. Damit kann OpenClaw Ollama-gehostete Modelle direkt aufrufen, ohne einen lokalen Ollama-Server zu installieren oder eine lokale Ollama-App im Cloud-Modus anzumelden. Verwenden Sie die Provider-ID ollama-cloud und Modellreferenzen wie ollama-cloud/kimi-k2.6.

Diese Seite behandelt direktes, ausschließlich cloudbasiertes Routing. Der Provider verwendet Ollamas nativen /api/chat-Stil, nicht die OpenAI-kompatible /v1-Route. OpenClaw registriert ihn als separate Provider-ID, damit reine Cloud-Anmeldedaten, Live-Katalogerkennung und Modellauswahl nicht mit einem lokalen ollama-Host vermischt werden.

Verwenden Sie diese Seite, wenn Sie ausschließlich cloudbasiertes Routing möchten. Für lokales Ollama, hybrides Cloud-plus-lokal-Routing, Embeddings und Details zu benutzerdefinierten Hosts siehe Ollama.

Einrichtung

Erstellen Sie einen Ollama Cloud-API-Schlüssel unter ollama.com/settings/keys, und führen Sie dann aus:

openclaw onboard --auth-choice ollama-cloud

Oder setzen Sie:

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

Standardwerte

• Provider: ollama-cloud
• Basis-URL: https://ollama.com
• Umgebungsvariable: OLLAMA_API_KEY
• API-Stil: nativ Ollama /api/chat
• Beispielmodell: ollama-cloud/kimi-k2.6

Wann Sie Ollama Cloud wählen sollten

• Sie möchten gehostete Ollama-Modelle nutzen, ohne ollama serve lokal auszuführen.
• Sie möchten dieselbe native Ollama-Chat-API-Struktur, die OpenClaw für lokales Ollama verwendet, aber auf https://ollama.com ausgerichtet.
• Sie möchten einen einfachen Cloud-Pfad für Modelle, die bereits im gehosteten Katalog von Ollama enthalten sind.
• Sie benötigen keine lokalen Modell-Downloads, keine lokale GPU-Steuerung und keine reine LAN-Inferenz.

Verwenden Sie stattdessen Ollama, wenn Sie ausschließlich lokales oder Cloud-plus-lokales Routing über einen angemeldeten Ollama-Host möchten. Verwenden Sie stattdessen einen OpenAI-kompatiblen Provider, wenn Sie /v1/chat/completions- Semantik oder Provider-spezifische Funktionen im OpenAI-Stil benötigen.

Modelle

OpenClaw erkennt Ollama Cloud-Modelle aus dem live gehosteten Katalog. Häufig verfügbare gehostete IDs sind unter anderem:

• ollama-cloud/gpt-oss:20b
• ollama-cloud/kimi-k2.6
• ollama-cloud/deepseek-v4-flash
• ollama-cloud/minimax-m2.7
• ollama-cloud/glm-5

Verwenden Sie eine Modell-ID aus Ihrem aktuellen gehosteten Katalog:

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

Modell-IDs sind Cloud-Katalog-IDs, keine lokalen Pull-Namen. Wenn ein Modellname in einem lokalen Ollama-Host funktioniert, aber im gehosteten Katalog fehlt, verwenden Sie stattdessen den ollama- Provider mit diesem lokalen Host.

Live-Test

Für Smoke-Tests mit Ollama Cloud-API-Schlüssel richten Sie den Ollama-Live-Test auf den gehosteten Endpunkt aus und wählen ein Modell aus Ihrem aktuellen Katalog aus:

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

Der Cloud-Smoke-Test führt Text, natives Streaming und Websuche aus. Embeddings werden standardmäßig für https://ollama.com übersprungen, da Ollama Cloud-API-Schlüssel /api/embed möglicherweise nicht autorisieren.

Fehlerbehebung

• Set OLLAMA_API_KEY-Fehler: Geben Sie einen echten Cloud-API-Schlüssel an. Die lokale ollama-local-Markierung ist nur für lokale oder private Ollama-Hosts vorgesehen.
• Fehler bei unbekanntem Modell: Führen Sie openclaw models list --provider ollama-cloud aus und kopieren Sie die gehostete Modell-ID exakt.
• Probleme mit Tool-Aufrufen oder rohem JSON auf benutzerdefinierten Ollama-Hosts: Prüfen Sie, ob Sie versehentlich eine OpenAI-kompatible /v1-URL verwenden. Ollama-Routen sollten die native Basis-URL ohne /v1-Suffix verwenden.

Verwandt

• Ollama
• Modell-Provider
• Alle Provider