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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 увімкнено thinking, OpenClaw видаляє кінцеві попередньо заповнені ходи assistant перед надсиланням корисного навантаження через Cloudflare AI Gateway. Anthropic відхиляє попереднє заповнення відповіді з extended thinking, тоді як звичайне попереднє заповнення без thinking залишається доступним.

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

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

​
Пов’язане

Вибір моделі

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

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

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