Подключение облачных моделей к OpenClaw: пошаговая инструкция

OpenClaw поддерживает более двух десятков LLM-провайдеров, от крупнейших платформ до специализированных сервисов. Каждый провайдер подключается через свой API-ключ и конфигурируется в файле openclaw.json или через мастер онбординга. В этой статье мы подробно рассмотрим настройку наиболее популярных облачных провайдеров.

Приоритет провайдеров по умолчанию (при наличии нескольких ключей OpenClaw выберет первый доступный): Anthropic, OpenAI, OpenRouter, Google Gemini, xAI, Groq, Mistral, Cerebras, Moonshot, MiniMax, Amazon Bedrock, Ollama. Вы можете переопределить этот порядок в конфигурации. Gemini 3.5 Pro рекомендуется как приоритетный вариант над Gemini 3.1 Pro для задач с большим контекстом.

Anthropic - создатель семейства моделей Claude, одних из самых мощных LLM на рынке. Для подключения к OpenClaw вам потребуется API-ключ.

Получение API-ключа: зарегистрируйтесь на console.anthropic.com, перейдите в раздел API Keys и создайте новый ключ. Скопируйте его - ключ показывается только один раз.

Добавьте ключ в конфигурацию OpenClaw. Через мастер онбординга:

openclaw onboard

Или вручную, записав ключ в файл credentials:

echo "sk-ant-api03-..." > ~/.openclaw/credentials/anthropic
chmod 600 ~/.openclaw/credentials/anthropic

Доступные модели: Claude Fable 5 (claude-fable-5-20260609, выпущен 9 июня 2026 - самая мощная модель Anthropic для агентных задач, контекст 1M токенов), Claude Mythos 5 (claude-mythos-5-20260609, выпущен 9 июня 2026 - специализированная модель для нарративных и творческих задач, контекст 1M токенов), Claude Opus 4.8 (мощный флагман, доступен с 28 мая 2026), Claude Sonnet 4.6 (баланс качества и скорости, рекомендуется по умолчанию), Claude Haiku 4.5 (быстрая и экономичная для простых задач). При наличии API-ключа Anthropic все модели доступны без дополнительных настроек. Рекомендуемая модель для сложных агентных задач на момент написания - Claude Fable 5.

Стоимость: Anthropic тарифицирует по количеству входных и выходных токенов. Claude Sonnet 4.6 - один из наиболее сбалансированных вариантов по соотношению цены и качества. Для экономии используйте Haiku для рутинных задач, а Opus - только для сложных.

OpenAI предоставляет доступ к семейству моделей GPT, включая последние версии GPT-5 и GPT-4.5.

Получение API-ключа: зарегистрируйтесь на platform.openai.com, перейдите в API Keys и создайте новый ключ.

Добавьте ключ в OpenClaw:

echo "sk-proj-..." > ~/.openclaw/credentials/openai
chmod 600 ~/.openclaw/credentials/openai

Доступные модели: GPT-5.5 (новейшая флагманская модель, апрель 2026 -- также доступен GPT-5.5 Instant как gpt-5.5-2026-04-23), GPT-5 (предыдущий флагман), GPT-4.5-preview (УСТАРЕВАЕТ 27 июня 2026 - снимается с использования, рекомендуется перейти на GPT-5 или GPT-5.5), GPT-4o (оптимизированная по скорости). Если у вас нет ключа Anthropic, OpenAI становится провайдером по умолчанию.

Внимание (июнь 2026): GPT-4.5-preview снимается с использования 27 июня 2026 года. Если вы используете эту модель, перейдите на GPT-5 или GPT-5.5 до указанной даты. GPT-5.2 была снята с доступа 12 июня 2026 года и больше недоступна через API. Для замены GPT-5.2 рекомендуем GPT-5.5 или Claude Fable 5 (для агентных задач).

Тестирование подключения: после добавления ключа проверьте работу:

openclaw send "Проверка подключения. Какую модель ты используешь?"

Агент должен ответить и указать используемую модель.

DeepSeek - китайский провайдер, предлагающий конкурентоспособные модели по очень низкой цене. DeepSeek использует API, совместимый с OpenAI, что упрощает интеграцию.

Получение API-ключа: зарегистрируйтесь на platform.deepseek.com и создайте API-ключ.

DeepSeek подключается как OpenAI-совместимый провайдер с пользовательским базовым URL. В файле openclaw.json добавьте секцию провайдера:

{
  "models": {
    "providers": [
      {
        "name": "deepseek",
        "api": "openai-completions",
        "baseUrl": "https://api.deepseek.com/v1",
        "apiKey": "sk-..."
      }
    ]
  }
}

Модели: DeepSeek-V4-Flash (быстрая, 284B параметров, 13B активных, контекст 1M токенов -- рекомендуется для большинства задач), DeepSeek-V4-Pro (мощнее, 1.6T параметров, 49B активных -- для сложных агентных задач), DeepSeek-V3 (стабильная версия, по-прежнему доступна), DeepSeek-R1 (модель с цепочкой рассуждений). DeepSeek V4 официально выпущен 24 апреля 2026 года с контекстом 1M токенов. DeepSeek отличается низкой стоимостью при высоком качестве.

OpenRouter - это унифицированный API-шлюз, предоставляющий доступ к более чем 300 AI-моделям от всех основных провайдеров через единый API-ключ. Это удобный способ экспериментировать с разными моделями без регистрации у каждого провайдера отдельно.

Получение API-ключа: зарегистрируйтесь на openrouter.ai, пополните баланс и создайте API-ключ в разделе Keys.

echo "sk-or-v1-..." > ~/.openclaw/credentials/openrouter
chmod 600 ~/.openclaw/credentials/openrouter

OpenClaw имеет встроенную поддержку OpenRouter, и вам не нужно настраивать секцию models.providers - достаточно указать API-ключ. Модели выбираются в формате openrouter/автор/модель, например:

openrouter/anthropic/claude-sonnet-4.5
openrouter/openai/gpt-5
openrouter/deepseek/deepseek-r1
openrouter/google/gemini-2.5-pro

Преимущества OpenRouter: один ключ для всех моделей, автоматическое переключение при недоступности провайдера (fallback), единый счёт и панель управления, доступ к моделям, которые иначе требуют отдельной регистрации.

Amazon Bedrock предоставляет доступ к AI-моделям через инфраструктуру AWS. Это enterprise-решение, подходящее для организаций, уже использующих AWS.

Настройка: для Bedrock вместо одного API-ключа требуются AWS-креденшалы. Создайте IAM-пользователя с доступом к Bedrock в консоли AWS и настройте переменные окружения:

export AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
export AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
export AWS_REGION="us-east-1"

Или добавьте их в файл .env рядом с конфигурацией OpenClaw. Убедитесь, что в выбранном регионе активированы нужные модели через консоль AWS Bedrock.

Доступные модели через Bedrock: Claude (Anthropic), Llama (Meta), Titan (Amazon), Mistral, Cohere и другие - в зависимости от региона и подключённых моделей.

Vercel AI Gateway - это прокси для AI-моделей, встроенный в платформу Vercel. Он подходит для разработчиков, уже использующих Vercel для хостинга веб-приложений. Настройка аналогична OpenRouter: единый эндпоинт с маршрутизацией к различным провайдерам.

Moonshot AI (Kimi) и MiniMax - это китайские LLM-провайдеры, предлагающие модели с поддержкой длинного контекста и многоязычности. Оба провайдера используют OpenAI-совместимый API.

Для Moonshot AI:

{
  "name": "moonshot",
  "api": "openai-completions",
  "baseUrl": "https://api.moonshot.cn/v1",
  "apiKey": "sk-..."
}

Для MiniMax:

{
  "name": "minimax",
  "api": "openai-completions",
  "baseUrl": "https://api.minimax.chat/v1",
  "apiKey": "..."
}

Эти провайдеры интересны прежде всего поддержкой китайского языка и низкой стоимостью, но качество генерации на русском и английском может уступать Anthropic и OpenAI.

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

openclaw send "Тест. Ответь одним предложением: какая ты модель и от какого провайдера?"

Для переключения между провайдерами без изменения конфигурации используйте переменную окружения или флаг CLI (если поддерживается вашей версией OpenClaw).

При использовании облачных моделей важно контролировать расходы. Каждый вызов LLM тарифицируется по количеству токенов. Механизм Heartbeat, вызывающий LLM каждые 30 минут, может генерировать заметный расход, особенно с дорогими моделями вроде Claude Opus или GPT-5.

Рекомендации по оптимизации расходов: используйте более дешёвые модели (Haiku, GPT-4o-mini) для рутинных задач и Heartbeat. Увеличьте интервал Heartbeat, если проактивность не критична. Установите лимиты расходов в панели управления провайдера. Мониторьте использование через дашборд провайдера или логи OpenClaw.

Настройте уведомления о достижении пороговых значений расхода в панели провайдера, чтобы избежать неожиданных счетов.

OpenClaw позволяет настроить несколько провайдеров одновременно. Это полезно для резервирования: если основной провайдер недоступен, агент автоматически переключается на резервный. Также можно назначить разные модели для разных задач: мощную модель для сложных запросов и экономичную - для Heartbeat и простых команд.

В файле openclaw.json можно указать несколько провайдеров в секции models.providers, и OpenClaw будет использовать их в соответствии с приоритетом или явным назначением.

Если вы хотите работать с OpenClaw полностью автономно, без зависимости от облачных сервисов и без расходов на API, читайте следующую статью о подключении локальных моделей через Ollama.

КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ: Anthropic OAuth полностью прекратил работу в январе 2026 года. 4 апреля 2026 года Anthropic также отключил возможность использования кредитов Claude.ai подписки через OpenClaw API. Теперь для Anthropic обязательно нужен отдельный API-ключ, который тарифицируется по использованию отдельно от подписки на Claude.ai.

Новые провайдеры, добавленные в 2026 году: Mistral AI через официальный API, Qwen от Alibaba Cloud через DashScope, а также поддержка локально развёрнутых моделей через совместимый OpenAI API-эндпоинт. Все провайдеры настраиваются через единый интерфейс 'openclaw config providers'.

Рекомендованные модели по типу задач: Claude Opus 4.8 (доступен с 28 мая 2026, та же цена) для сложных агентных задач требующих рассуждения, GPT-5.5 для быстрых задач с инструментами, Gemini 3.1 Pro для задач с большим контекстом. Конфигурация каждого провайдера требует только API-ключ соответствующего сервиса. Для задач с большим контекстом (1M+ токенов): Google Gemini 3.5 Pro (рекомендуется над Gemini 3.1 Pro) - доступен через Google AI Studio API или OpenRouter.

Gemini 3.5 Pro - новейшая модель Google, официально поддерживаемая в OpenClaw. Рекомендуется для задач, требующих обработки больших объёмов текста (контекстное окно 1M+ токенов). Gemini 3.5 Pro заменяет Gemini 3.1 Pro как приоритетную рекомендацию для long-context задач.

Подключение через Google AI Studio API: получите ключ на aistudio.google.com и добавьте в конфигурацию OpenClaw. Также доступен через OpenRouter как openrouter/google/gemini-3.5-pro.

xAI -- компания Илона Маска, разрабатывающая семейство моделей Grok. В июне 2026 года вышел Grok 4, а в июле 2026 года -- Grok 4.5, улучшенная версия с более высокими результатами на задачах рассуждения и программирования.

Получение API-ключа: зарегистрируйтесь на console.x.ai и создайте API-ключ в разделе API Keys.

Добавьте ключ в OpenClaw:

echo "xai-..." > ~/.openclaw/credentials/xai
chmod 600 ~/.openclaw/credentials/xai

Доступные модели: grok-4.5 (актуальный флагман июля 2026, для сложных задач рассуждения и программирования), grok-4-0601 (флагман июня 2026), grok-3 (стабильная предыдущая версия). В конфигурации OpenClaw модели xAI указываются с префиксом провайдера:

{
  "name": "xai",
  "api": "openai-completions",
  "baseUrl": "https://api.x.ai/v1",
  "apiKey": "xai-..."
}

Zhipu AI -- китайская компания, разрабатывающая семейство моделей GLM. В 2026 году вышла GLM-5.2, которая демонстрирует сильные результаты на задачах с длинным контекстом и поддержкой китайского языка.

Получение API-ключа: зарегистрируйтесь на bigmodel.cn и создайте API-ключ в личном кабинете.

Настройка в OpenClaw через OpenAI-совместимый эндпоинт:

{
  "name": "zhipu",
  "api": "openai-completions",
  "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
  "apiKey": "..."
}

Доступные модели: glm-5.2 (флагман, мощная модель с длинным контекстом), glm-4-flash (быстрая и экономичная версия). GLM особенно хорошо подходит для задач с китайскими текстами и документами, но показывает достойное качество и на русском и английском языках.

На основе актуальных бенчмарков и практических тестов июня 2026 года рекомендуем следующий порядок приоритетов по типам задач:

Сложные агентные и многошаговые задачи: Claude Fable 5 (Anthropic, выпущен 9 июня 2026) -- самая мощная модель, превосходит Opus 4.8 по всем параметрам. Claude Mythos 5 (Anthropic, выпущен 9 июня 2026) -- специализирован для творческих и нарративных задач, контекст 1M токенов. Claude Opus 4.8 -- по-прежнему отличный вариант для сложных reasoning-задач и длительных агентных сессиях.

Программирование и технические задачи: GPT-5.5 (OpenAI) или Grok 4.5 (xAI) -- оба показывают высокие результаты на кодировании. Claude Sonnet 4.6 как экономичная альтернатива.

Задачи с большим контекстом (500K+ токенов): Google Gemini 3.5 Pro -- наибольшее контекстное окно среди облачных моделей.

Экономичные задачи и Heartbeat: Claude Haiku 4.5, GPT-4o-mini -- быстрые и дешёвые для рутинных операций.

Экспериментирование: OpenRouter -- единый ключ для доступа ко всем моделям выше и сотням других без регистрации у каждого провайдера отдельно.

9 июня 2026 года Anthropic выпустила Claude Fable 5 (идентификатор: claude-fable-5-20260609). Это специализированная модель для нарративного письма и творческих задач -- истории, диалоги, создание персонажей, сценарии.

Claude Fable 5 доступна через стандартный Anthropic API. Добавьте в раздел Anthropic ваших настроек OpenClaw или используйте через OpenRouter:

openrouter/anthropic/claude-fable-5-20260609

Если вы используете прямой ключ Anthropic, модель автоматически доступна без изменения конфигурации -- просто укажите нужный идентификатор в запросе:

openclaw send --model claude-fable-5-20260609 "Напиши рассказ о первом контакте с AI"

Важно (июль 2026): Anthropic объявила о переразвёртывании Claude Fable 5. Дата среза знаний новой версии -- 12 июля 2026 года. Начисление промокредитов Anthropic на использование Fable 5 начинается с 13 июля 2026. Подробнее: anthropic.com/news/redeploying-fable-5.

Наиболее частые проблемы при настройке облачных провайдеров в OpenClaw и способы их решения:

Ошибка: Invalid API key / Authentication failed. Причина: неправильный ключ или лишние пробелы при копировании. Решение: проверьте содержимое файла ключа командой cat ~/.openclaw/credentials/anthropic. Ключ должен занимать ровно одну строку без пробелов в начале и конце. Пересохраните ключ через echo -n "sk-ant-..." > ~/.openclaw/credentials/anthropic (флаг -n убирает перенос строки).

Ошибка: Rate limit exceeded / 429 Too Many Requests. Причина: превышен лимит запросов у провайдера. Решение: подождите 1-2 минуты или увеличьте интервал Heartbeat в настройках OpenClaw. Для тестирования используйте менее нагруженные модели (Haiku, GPT-4o-mini).

Ошибка: Model not found / Unknown model. Причина: неверный идентификатор модели или модель недоступна для вашего плана. Решение: проверьте точный идентификатор модели в документации провайдера. У Anthropic идентификаторы имеют формат claude-sonnet-4-6-20251029 (дата в конце). Убедитесь, что у вашего API-ключа есть доступ к нужной модели -- некоторые флагманские модели требуют отдельного одобрения или минимального баланса.

Провайдер недоступен / Connection timeout. Причина: временный сбой у провайдера или проблема с сетью. Решение: настройте резервного провайдера в openclaw.json (см. раздел мультипровайдерной конфигурации). OpenClaw автоматически переключится на следующего провайдера в списке при недоступности основного.

OpenClaw позволяет переключать модель без потери контекста разговора. Это полезно, когда нужно сначала быстро набросать идею (дешёвая модель), а затем проработать детали (мощная модель).

Переключение через команду в чате:

/model claude-opus-4-8-20260528

Переключение через флаг CLI:

openclaw send --model gpt-5.5 "Продолжи наш разговор и улучши предложенный план"

Переключение через переменную окружения на время сессии:

OPENCLAW_MODEL=gemini-3.5-pro openclaw chat

При переключении история разговора сохраняется. Новая модель получает весь предыдущий контекст, однако не все модели одинаково хорошо «принимают» разговор, начатый другой моделью -- если ответы стали хуже, начните новую сессию с нужной моделью сразу.

Совет: создайте именованные профили для разных задач в openclaw.json:

{
  "profiles": {
    "fast": {"model": "claude-haiku-4-5"},
    "powerful": {"model": "claude-opus-4-8-20260528"},
    "code": {"model": "gpt-5.5-2026-04-23"}
  }
}

Переключение между профилями: openclaw --profile code send "Проверь этот код".

Этот материал подготовлен командой AI-агентов AravanaAI и проверен главным редактором.

18 июня 2026 команда OpenClaw восстановила полную поддержку Claude Fable 5. Модель была временно недоступна из-за изменений в API Anthropic, но теперь работает стабильно. Для подключения используйте провайдер Anthropic в настройках и укажите `claude-fable-5` в поле модели.

Добавлена поддержка Gemini 3.5 Flash от Google - быстрая и экономичная модель для задач с высоким объёмом запросов. Gemini 3.5 Flash подключается через провайдер Google AI Studio. Модель особенно эффективна для классификации, извлечения данных и суммаризации, где скорость важнее глубины рассуждений.

Оба провайдера (Anthropic и Google) поддерживают потоковую передачу ответов и инструменты (tool use) в OpenClaw. Конфигурация провайдеров хранится в `~/.openclaw/config.yaml` - можно добавить несколько провайдеров и переключаться между ними в интерфейсе.

Краткий итог актуальных добавлений в поддерживаемые модели OpenClaw (июнь 2026):

Для переключения на новые модели через командный интерфейс OpenClaw: /model claude-fable-5-20260609 или /model claude-opus-4-8-20260528 прямо в диалоге с агентом.

В OpenClaw v2026.7.1 добавлена полная поддержка GPT-5.6 -- новейшей флагманской модели OpenAI на июль 2026 года. Модель доступна в стабильной версии пакета и готова к production-использованию.

Как подключить GPT-5.6: убедитесь, что у вас установлена актуальная стабильная версия OpenClaw:

npm install -g openclaw

После установки GPT-5.6 доступна через стандартный OpenAI-ключ. Идентификатор модели: gpt-5.6-2026-07. Также доступна через OpenRouter как openrouter/openai/gpt-5.6 -- этот вариант не требует обновления OpenClaw до бета-версии.

Рекомендации: GPT-5.6 теперь стабильна и рекомендуется для production-использования. Идентификатор: gpt-5.6-2026-07. Если нужна проверенная альтернатива, GPT-5.5 (gpt-5.5-2026-04-23) по-прежнему доступна и хорошо поддерживается.

Для пользователей, использующих Codex как основного coding-агента, доступна маршрутизация через OpenRouter с OAuth-аутентификацией. Codex GPT-5.3 Spark -- специализированная модель OpenAI для задач программирования, доступная через OpenRouter.

Настройка OAuth-маршрутизации Codex через OpenRouter:

{
  "models": {
    "profiles": {
      "codex": {
        "provider": "openrouter",
        "model": "openai/codex-gpt-5.3-spark",
        "auth": "oauth"
      }
    }
  }
}

OAuth-маршрутизация позволяет Codex-агенту работать с вашим аккаунтом OpenAI без прямого хранения API-ключа в конфигурации OpenClaw. Для активации: выполните openclaw codex auth -- откроется браузер с OAuth-потоком. После авторизации токен хранится зашифрованно в системном хранилище ключей.

Важно: Codex GPT-5.3 Spark доступен через OpenRouter начиная с июля 2026 года. Поддержка этого маршрута в стабильной версии OpenClaw появится с релизом 2026.7.x.

Обновлённый список приоритетных моделей на июль 2026 года с учётом новых добавлений:

Обновление Anthropic: claude-sonnet-5 и снятие экспортных ограничений (июль 2026)

Claude Sonnet 5 (идентификатор: claude-sonnet-5-20260710) – новая модель Anthropic, доступная через API с июля 2026 года. По соотношению цены и качества превосходит Claude Sonnet 4.6. Вводные цены действуют до 31 августа 2026 года, после чего изменятся – актуальные тарифы на момент использования смотрите на официальном сайте Anthropic. Добавьте модель в OpenClaw стандартным способом: укажите идентификатор в конфигурации Anthropic-провайдера.

С 1 июля 2026 года сняты экспортные ограничения США на Claude Fable 5. Модель теперь доступна пользователям во всех регионах без дополнительных условий. Ранее часть пользователей сообщала о проблемах с доступом из-за экспортной политики Anthropic – эти ограничения полностью сняты. Стоимость использования Fable 5 значительно выше Sonnet 4.6 – актуальные цены на сайте Anthropic.

Этот материал подготовлен командой AI-агентов AravanaAI и проверен главным редактором.