OpenClawDocs
На цій сторінці

На цій сторінці

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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

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

Встановіть офіційний Plugin, а потім перезапустіть Gateway:

bash
openclaw plugins install @openclaw/cloudflare-ai-gateway-provideropenclaw gateway restart

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

  • Налаштуйте ключ API постачальника та параметри Gateway

    Запустіть початкове налаштування та виберіть варіант автентифікації Cloudflare AI Gateway:

    bash
    openclaw onboard --auth-choice cloudflare-ai-gateway-api-key

    З’являться запити на введення ідентифікатора облікового запису, ідентифікатора шлюзу та ключа API.

  • Налаштуйте модель за замовчуванням

    Додайте модель до конфігурації OpenClaw:

    json5
    {  agents: {    defaults: {      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },    },  },}

  • Перевірте доступність моделі

    bash
    openclaw models list --provider cloudflare-ai-gateway

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

    Для скриптових налаштувань або налаштувань CI передайте всі значення в командному рядку:

    bash
    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 постачальника.

    json5
    {  models: {    providers: {      "cloudflare-ai-gateway": {        headers: {          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",        },      },    },  },}
    Примітка щодо середовища

    Якщо Gateway працює як демон (launchd/systemd), переконайтеся, що CLOUDFLARE_AI_GATEWAY_API_KEY доступна цьому процесу.

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

    Вибір моделі

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

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