Cloudflare AI Gateway

Cloudflare AI Gateway располагается перед API провайдеров и добавляет аналитику, кэширование и средства управления. Для Anthropic OpenClaw использует Anthropic Messages API через вашу конечную точку Gateway.

Свойство	Значение
Провайдер	`cloudflare-ai-gateway`
Плагин	официальный внешний пакет (`@openclaw/cloudflare-ai-gateway-provider`)
Базовый URL	`https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic`
Модель по умолчанию	`cloudflare-ai-gateway/claude-sonnet-4-6`
Ключ API	`CLOUDFLARE_AI_GATEWAY_API_KEY` (ваш ключ API провайдера для запросов через Gateway)

Для моделей Anthropic, маршрутизируемых через Cloudflare AI Gateway, используйте свой ключ API Anthropic в качестве ключа провайдера.

Когда для моделей Anthropic Messages включён режим рассуждений, OpenClaw удаляет последние предзаполненные реплики ассистента перед отправкой полезной нагрузки через Cloudflare AI Gateway. Anthropic отклоняет предзаполнение ответа при расширенном режиме рассуждений, тогда как обычное предзаполнение без рассуждений остаётся доступным.

Установка плагина

Установите официальный плагин, затем перезапустите Gateway:

openclaw plugins install @openclaw/cloudflare-ai-gateway-provider
openclaw gateway restart

Начало работы

Укажите ключ API провайдера и параметры Gateway

Запустите первоначальную настройку и выберите вариант аутентификации Cloudflare AI Gateway:

openclaw onboard --auth-choice cloudflare-ai-gateway-api-key

Система запросит идентификатор вашей учётной записи, идентификатор шлюза и ключ API.

Укажите модель по умолчанию

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

{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
    },
  },
}

Убедитесь, что модель доступна

openclaw models list --provider cloudflare-ai-gateway

Пример неинтерактивной настройки

Для сценариев автоматизации или CI передайте все значения в командной строке:

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice cloudflare-ai-gateway-api-key \
  --cloudflare-ai-gateway-account-id "your-account-id" \
  --cloudflare-ai-gateway-gateway-id "your-gateway-id" \
  --cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY"

Расширенная конфигурация

Шлюзы с аутентификацией

Если вы включили аутентификацию Gateway в Cloudflare, добавьте заголовок cf-aig-authorization. Он необходим в дополнение к ключу API провайдера.

{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}

Заголовок cf-aig-authorization выполняет аутентификацию непосредственно в Cloudflare Gateway, а ключ API провайдера (например, ваш ключ Anthropic) — у вышестоящего провайдера.

Примечание об окружении

Если Gateway работает как фоновая служба (launchd/systemd), убедитесь, что CLOUDFLARE_AI_GATEWAY_API_KEY доступен этому процессу.

Ключ, экспортированный только в интерактивной оболочке, не будет доступен службе launchd/systemd, если это окружение также не импортировано в неё. Задайте ключ в ~/.openclaw/.env или через env.shellEnv, чтобы процесс Gateway мог его прочитать.

Связанные материалы

Выбор модели

Выбор провайдеров, ссылок на модели и поведения при переключении после сбоя.

Устранение неполадок

Общие рекомендации по устранению неполадок и часто задаваемые вопросы.

Overview

Concepts and configuration

Providers

Cloudflare AI Gateway

Установка плагина

Начало работы

Пример неинтерактивной настройки

Расширенная конфигурация

Связанные материалы

Выбор модели

Устранение неполадок

​Установка плагина

​Начало работы

​Пример неинтерактивной настройки

​Расширенная конфигурация

​Связанные материалы

Выбор модели

Устранение неполадок

Установка плагина

Начало работы

Пример неинтерактивной настройки

Расширенная конфигурация

Связанные материалы