Skip to main content
Ollama Cloud — це розміщений у хмарі API моделей від Ollama. Провайдер ollama-cloud звертається до нього безпосередньо за адресою https://ollama.com через нативний API Ollama /api/chat, без локального сервера Ollama та без локального застосунку Ollama, у якому виконано вхід у хмарний режим. Використовуйте посилання на моделі на кшталт ollama-cloud/kimi-k2.6. OpenClaw реєструє ollama-cloud як окремий ідентифікатор провайдера, щоб облікові дані, призначені лише для хмари, динамічне виявлення каталогу та вибір моделей не змішувалися з локальним хостом ollama. Відомості про локальний Ollama, гібридну маршрутизацію між хмарою та локальним середовищем, вбудовування й налаштування власного хоста див. у розділі Ollama.

​
Налаштування

Створіть ключ API Ollama Cloud на сторінці ollama.com/settings/keys, а потім виконайте:
Або задайте:
У неінтерактивному початковому налаштуванні ключ можна передати безпосередньо:
Початкове налаштування встановлює моделлю за замовчуванням ollama-cloud/kimi-k2.5:cloud.

​
Значення за замовчуванням

  • Провайдер: ollama-cloud
  • Базова URL-адреса: https://ollama.com
  • Змінна середовища: OLLAMA_API_KEY
  • Стиль API: нативний API Ollama /api/chat
  • Модель за замовчуванням під час початкового налаштування: ollama-cloud/kimi-k2.5:cloud

​
Коли варто вибрати Ollama Cloud

  • Вам потрібні розміщені в хмарі моделі Ollama без локального запуску ollama serve.
  • Вам потрібна та сама нативна структура API чату Ollama, яку OpenClaw використовує для локального Ollama, але з адресою https://ollama.com.
  • Вам потрібен простий хмарний доступ до моделей, які вже є в розміщеному каталозі Ollama.
  • Вам не потрібні локальне завантаження моделей, локальне керування GPU або виконання інференсу лише в локальній мережі.
Натомість використовуйте Ollama, якщо вам потрібна суто локальна або хмарно-локальна маршрутизація через хост Ollama, у якому виконано вхід. Використовуйте OpenAI-сумісного провайдера, якщо вам потрібна семантика /v1/chat/completions або специфічні для провайдера можливості в стилі OpenAI.

​
Моделі

Провайдер потребує ключа API; без нього він залишається неактивним. За наявності ключа OpenClaw динамічно виявляє моделі Ollama Cloud у розміщеному каталозі:
Розміщені ідентифікатори в актуальному каталозі включають deepseek-v4-flash, glm-5, gpt-oss:20b, kimi-k2.6 і minimax-m2.7. Якщо динамічне виявлення не повертає нічого, OpenClaw використовує резервні вбудовані записи kimi-k2.5:cloud, minimax-m2.7:cloud, glm-5.1:cloud і glm-5.2:cloud. Ідентифікатори моделей — це ідентифікатори хмарного каталогу, а не назви для локального завантаження. Якщо назва моделі працює на локальному хості Ollama, але відсутня в розміщеному каталозі, натомість використовуйте провайдер ollama із цим локальним хостом.

​
Перевірка в реальному середовищі

Для базових перевірок Ollama Cloud із ключем API спрямуйте перевірку Ollama в реальному середовищі на розміщену кінцеву точку та виберіть модель зі свого поточного каталогу:
Хмарна базова перевірка тестує текст, нативне потокове передавання та вебпошук; задайте OPENCLAW_LIVE_OLLAMA_WEB_SEARCH=0, щоб пропустити вебпошук. За замовчуванням вона пропускає вбудовування для https://ollama.com, оскільки ключі API Ollama Cloud можуть не надавати доступ до /api/embed; примусово ввімкніть їх за допомогою OPENCLAW_LIVE_OLLAMA_EMBEDDINGS=1.

​
Усунення несправностей

  • Помилки Ollama Cloud requires an API key / Set OLLAMA_API_KEY: надайте справжній ключ хмарного API. Маркер ollama-local призначений лише для локальних або приватних хостів Ollama.
  • Помилки невідомої моделі: виконайте openclaw models list --provider ollama-cloud і точно скопіюйте ідентифікатор розміщеної моделі.
  • Проблеми з викликами інструментів або необробленим JSON на власних хостах Ollama: перевірте, чи ви випадково не використовуєте OpenAI-сумісну URL-адресу /v1. Маршрути Ollama мають використовувати нативну базову URL-адресу без суфікса /v1.

​
Пов’язані матеріали