Перейти до основного вмісту

​
Cloudflare AI Gateway

Cloudflare AI Gateway розташовується перед API провайдерів і дає змогу додавати аналітику, кешування та елементи керування. Для Anthropic OpenClaw використовує Anthropic Messages API через вашу кінцеву точку Gateway.
ВластивістьЗначення
Провайдерcloudflare-ai-gateway
Базовий URLhttps://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
Типова модельcloudflare-ai-gateway/claude-sonnet-4-5
Ключ APICLOUDFLARE_AI_GATEWAY_API_KEY (ваш ключ API провайдера для запитів через Gateway)
Для моделей Anthropic, що маршрутизуються через Cloudflare AI Gateway, використовуйте свій ключ API Anthropic як ключ провайдера.

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

1

Укажіть ключ API провайдера та дані Gateway

Запустіть онбординг і виберіть варіант автентифікації Cloudflare AI Gateway:
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
Буде запитано ID вашого облікового запису, ID Gateway і ключ API.
2

Установіть типову модель

Додайте модель до конфігурації OpenClaw:
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-5" },
    },
  },
}
3

Перевірте, що модель доступна

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 доступний для цього процесу.
Ключ, що зберігається лише в ~/.profile, не допоможе демону launchd/systemd, якщо це середовище не імпортовано також туди. Установіть ключ у ~/.openclaw/.env або через env.shellEnv, щоб процес gateway міг його прочитати.

​
Пов’язане

Вибір моделі

Вибір провайдерів, посилань на моделі та поведінки перемикання на резервний варіант.

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

Загальне усунення несправностей і поширені запитання.