Ollama Cloud

Ollama Cloud, Ollama'nın barındırılan model API'sidir. ollama-cloud sağlayıcısı, yerel bir Ollama sunucusu ve bulut modunda oturum açmış yerel bir Ollama uygulaması olmadan, Ollama'nın yerel /api/chat API'si üzerinden doğrudan https://ollama.com adresini çağırır. ollama-cloud/kimi-k2.6 gibi model referansları kullanın.

OpenClaw, yalnızca buluta ait kimlik bilgilerinin, canlı katalog keşfinin ve model seçiminin yerel bir ollama ana bilgisayarıyla karışmaması için ollama-cloud değerini kendi sağlayıcı kimliği olarak kaydeder. Yerel Ollama, hibrit bulut-artı-yerel yönlendirme, gömmeler ve özel ana bilgisayar ayrıntıları için Ollama bölümüne bakın.

Kurulum

ollama.com/settings/keys adresinde bir Ollama Cloud API anahtarı oluşturun, ardından şunu çalıştırın:

openclaw onboard --auth-choice ollama-cloud

Veya şunu ayarlayın:

export OLLAMA_API_KEY="<your-ollama-cloud-api-key>" # pragma: izin listesi gizli değeri

Etkileşimsiz ilk katılım, anahtarı doğrudan kabul eder:

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

İlk katılım, varsayılan modeli ollama-cloud/kimi-k2.5:cloud olarak ayarlar.

Varsayılanlar

• Sağlayıcı: ollama-cloud
• Temel URL: https://ollama.com
• Ortam değişkeni: OLLAMA_API_KEY
• API biçimi: Ollama yerel /api/chat
• İlk katılım varsayılan modeli: ollama-cloud/kimi-k2.5:cloud

Ollama Cloud ne zaman seçilmeli?

• Yerel olarak ollama serve çalıştırmadan barındırılan Ollama modellerini kullanmak istiyorsanız.
• OpenClaw'ın yerel Ollama için kullandığı yerel Ollama sohbet API'si biçiminin aynısını, ancak https://ollama.com adresine yönlendirilmiş olarak istiyorsanız.
• Ollama'nın barındırılan kataloğunda zaten bulunan modeller için basit bir bulut yolu istiyorsanız.
• Yerel model indirmelerine, yerel GPU denetimine veya yalnızca LAN üzerinden çıkarıma ihtiyacınız yoksa.

Oturum açılmış bir Ollama ana bilgisayarı üzerinden yalnızca yerel veya bulut-artı-yerel yönlendirme istediğinizde bunun yerine Ollama kullanın. /v1/chat/completions semantiğine veya sağlayıcıya özgü OpenAI tarzı özelliklere ihtiyacınız olduğunda bunun yerine OpenAI uyumlu bir sağlayıcı kullanın.

Modeller

Sağlayıcı bir API anahtarı gerektirir; anahtar olmadan etkin değildir. Bir anahtar olduğunda OpenClaw, Ollama Cloud modellerini barındırılan katalogdan canlı olarak keşfeder:

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

Canlı katalogdaki barındırılan kimlikler arasında deepseek-v4-flash, glm-5, gpt-oss:20b, kimi-k2.6 ve minimax-m2.7 bulunur. Canlı keşif hiçbir sonuç döndürmediğinde OpenClaw, paketle gelen kimi-k2.5:cloud, minimax-m2.7:cloud, glm-5.1:cloud ve glm-5.2:cloud satırlarına geri döner.

Model kimlikleri yerel indirme adları değil, bulut kataloğu kimlikleridir. Bir model adı yerel bir Ollama ana bilgisayarında çalışıyor ancak barındırılan katalogda bulunmuyorsa bunun yerine söz konusu yerel ana bilgisayarla ollama sağlayıcısını kullanın.

Canlı test

Ollama Cloud API anahtarı duman testleri için Ollama canlı testini barındırılan uç noktaya yönlendirin ve mevcut kataloğunuzdan bir model seçin:

export OLLAMA_API_KEY="<your-ollama-cloud-api-key>" # pragma: izin listesi gizli değeri 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

Bulut duman testi metin, yerel akış ve web araması çalıştırır; web aramasını atlamak için OPENCLAW_LIVE_OLLAMA_WEB_SEARCH=0 değerini ayarlayın. Ollama Cloud API anahtarları /api/embed için yetki vermeyebileceğinden, https://ollama.com için gömmeleri varsayılan olarak atlar; bunları OPENCLAW_LIVE_OLLAMA_EMBEDDINGS=1 ile zorlayın.

Sorun giderme

• Ollama Cloud requires an API key / Set OLLAMA_API_KEY hataları: gerçek bir bulut API anahtarı sağlayın. Yerel ollama-local işaretçisi yalnızca yerel veya özel Ollama ana bilgisayarları içindir.
• Bilinmeyen model hataları: openclaw models list --provider ollama-cloud komutunu çalıştırın ve barındırılan model kimliğini tam olarak kopyalayın.
• Özel Ollama ana bilgisayarlarında araç çağrısı veya ham JSON sorunları: yanlışlıkla OpenAI uyumlu bir /v1 URL'si kullanıp kullanmadığınızı kontrol edin. Ollama rotaları, /v1 son eki olmadan yerel temel URL'yi kullanmalıdır.

İlgili

• Ollama
• Model sağlayıcıları
• Tüm sağlayıcılar