OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Облако Ollama

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, затем выполните:

bash
openclaw onboard --auth-choice ollama-cloud

Или задайте:

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

При неинтерактивной первоначальной настройке ключ можно передать напрямую:

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

При первоначальной настройке моделью по умолчанию становится 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 в размещённом каталоге:

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

Идентификаторы в размещённом динамическом каталоге включают 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 в рабочей среде и выберите модель из текущего каталога:

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

Облачный дымовой тест проверяет текст, нативную потоковую передачу и веб-поиск; задайте 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.

См. также

Was this useful?
On this page

On this page