> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cloudflare AI Gateway

[Cloudflare AI Gateway](https://developers.cloudflare.com/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) |

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

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

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/cloudflare-ai-gateway-provider
openclaw gateway restart
```

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

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
```

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

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

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

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
    },
  },
}
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --provider cloudflare-ai-gateway
```

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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"
```

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

> [accordion] Шлюзы с аутентификацией
>
> Если вы включили аутентификацию Gateway в Cloudflare, добавьте заголовок `cf-aig-authorization`. Он необходим **в дополнение к** ключу API провайдера.
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   models: {
>     providers: {
>       "cloudflare-ai-gateway": {
>         headers: {
>           "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
>         },
>       },
>     },
>   },
> }
> ```
>
> > [!TIP]
> >
> > Заголовок `cf-aig-authorization` выполняет аутентификацию непосредственно в Cloudflare Gateway, а ключ API провайдера (например, ваш ключ Anthropic) — у вышестоящего провайдера.

> [accordion] Примечание об окружении
>
> Если Gateway работает как фоновая служба (launchd/systemd), убедитесь, что `CLOUDFLARE_AI_GATEWAY_API_KEY` доступен этому процессу.
>
> > [!WARNING]
> >
> > Ключ, экспортированный только в интерактивной оболочке, не будет доступен службе launchd/systemd, если это окружение также не импортировано в неё. Задайте ключ в `~/.openclaw/.env` или через `env.shellEnv`, чтобы процесс Gateway мог его прочитать.

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

> [card] [Выбор модели](https://docs2.openclaw.ai/ru/concepts/model-providers.md)
>
> Выбор провайдеров, ссылок на модели и поведения при переключении после сбоя.

> [card] [Устранение неполадок](https://docs2.openclaw.ai/ru/help/troubleshooting.md)
>
> Общие рекомендации по устранению неполадок и часто задаваемые вопросы.