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 ist die gehostete Modell-API von Ollama. Der Provider ollama-cloud ruft sie direkt unter https://ollama.com über Ollamas native /api/chat-API auf, ohne lokalen Ollama-Server und ohne lokale Ollama-App, die im Cloud-Modus angemeldet ist. Verwenden Sie Modellreferenzen wie ollama-cloud/kimi-k2.6.

OpenClaw registriert ollama-cloud als eigene Provider-ID, damit reine Cloud- Anmeldedaten, die Live-Katalogerkennung und die Modellauswahl nicht mit einem lokalen ollama-Host vermischt werden. Informationen zu lokalem Ollama, hybridem Cloud-und-lokal-Routing, Embeddings und Details zu benutzerdefinierten Hosts finden Sie unter Ollama.

Einrichtung

Erstellen Sie unter ollama.com/settings/keys einen Ollama-Cloud-API-Schlüssel und führen Sie anschließend Folgendes aus:

bash
openclaw onboard --auth-choice ollama-cloud

Oder legen Sie Folgendes fest:

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

Beim nicht interaktiven Onboarding kann der Schlüssel direkt angegeben werden:

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

Beim Onboarding wird das Standardmodell auf ollama-cloud/kimi-k2.5:cloud festgelegt.

Standardwerte

  • Provider: ollama-cloud
  • Basis-URL: https://ollama.com
  • Umgebungsvariable: OLLAMA_API_KEY
  • API-Stil: native Ollama-API /api/chat
  • Standardmodell beim Onboarding: ollama-cloud/kimi-k2.5:cloud

Wann Ollama Cloud gewählt werden sollte

  • Sie möchten gehostete Ollama-Modelle verwenden, ohne ollama serve lokal auszuführen.
  • Sie möchten dieselbe Struktur der nativen Ollama-Chat-API verwenden, die OpenClaw für lokales Ollama nutzt, jedoch auf https://ollama.com ausgerichtet.
  • Sie möchten einen einfachen Cloud-Zugriff auf Modelle, die bereits im gehosteten Katalog von Ollama enthalten sind.
  • Sie benötigen weder lokale Modell-Downloads noch lokale GPU-Steuerung oder eine Inferenz ausschließlich im LAN.

Verwenden Sie stattdessen Ollama, wenn Sie reines lokales Routing oder Cloud-und-lokal-Routing über einen angemeldeten Ollama-Host wünschen. Verwenden Sie stattdessen einen OpenAI-kompatiblen Provider, wenn Sie /v1/chat/completions- Semantik oder providerspezifische Funktionen im OpenAI-Stil benötigen.

Modelle

Der Provider erfordert einen API-Schlüssel; ohne Schlüssel bleibt er inaktiv. Mit einem Schlüssel erkennt OpenClaw Ollama-Cloud-Modelle live aus dem gehosteten Katalog:

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

Zu den gehosteten IDs im Live-Katalog gehören deepseek-v4-flash, glm-5, gpt-oss:20b, kimi-k2.6 und minimax-m2.7. Wenn die Live-Erkennung keine Ergebnisse liefert, greift OpenClaw auf die mitgelieferten Einträge kimi-k2.5:cloud, minimax-m2.7:cloud, glm-5.1:cloud und glm-5.2:cloud zurück.

Modell-IDs sind IDs aus dem Cloud-Katalog, keine lokalen Namen für Modell-Downloads. Wenn ein Modellname auf einem lokalen Ollama-Host funktioniert, aber nicht im gehosteten Katalog enthalten ist, verwenden Sie stattdessen den Provider ollama mit diesem lokalen Host.

Live-Test

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

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

Der Cloud-Smoke-Test prüft Text, natives Streaming und Websuche; setzen Sie OPENCLAW_LIVE_OLLAMA_WEB_SEARCH=0, um die Websuche zu überspringen. Embeddings werden für https://ollama.com standardmäßig übersprungen, da Ollama-Cloud-API-Schlüssel /api/embed möglicherweise nicht autorisieren; erzwingen Sie sie mit OPENCLAW_LIVE_OLLAMA_EMBEDDINGS=1.

Fehlerbehebung

  • Ollama Cloud requires an API key- / Set OLLAMA_API_KEY-Fehler: Geben Sie einen echten Cloud-API-Schlüssel an. Die lokale Markierung ollama-local ist nur für lokale oder private Ollama-Hosts vorgesehen.
  • Fehler aufgrund unbekannter Modelle: Führen Sie openclaw models list --provider ollama-cloud aus und kopieren Sie die gehostete Modell-ID exakt.
  • Probleme mit Tool-Aufrufen oder unverarbeitetem 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 das Suffix /v1 verwenden.

Verwandte Themen

Was this useful?
On this page

On this page