Перейти до основного вмісту
Cloudflare AI Gateway розташовується перед API постачальників і дає змогу додавати аналітику, кешування та засоби керування. Для Anthropic OpenClaw використовує Anthropic Messages API через вашу кінцеву точку Gateway.
ВластивістьЗначення
Постачальникcloudflare-ai-gateway
Базова 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

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

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

​
Пов’язане

Вибір моделі

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

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

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