Cloudflare AI Gateway

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

Властивість	Значення
Постачальник	`cloudflare-ai-gateway`
Plugin	офіційний зовнішній пакет (`@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 відхиляє попереднє заповнення відповіді з розширеним міркуванням, тоді як звичайне попереднє заповнення без міркування залишається доступним.

Встановлення Plugin

Встановіть офіційний Plugin, а потім перезапустіть 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

Встановлення Plugin

Початок роботи

Приклад неінтерактивного налаштування

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

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

Вибір моделі

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

​Встановлення Plugin

​Початок роботи

​Приклад неінтерактивного налаштування

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

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

Вибір моделі

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

Встановлення Plugin

Початок роботи

Приклад неінтерактивного налаштування

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

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