Перейти к основному содержанию
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-6
Ключ APICLOUDFLARE_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
Будет запрошен ваш идентификатор учетной записи, идентификатор 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 мог его прочитать.

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

Выбор модели

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

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

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