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

Providers

Gateway de IA de Cloudflare

Cloudflare AI Gateway se sitúa delante de las API de los proveedores y añade análisis, almacenamiento en caché y controles. Para Anthropic, OpenClaw utiliza la API Messages de Anthropic a través del endpoint de tu Gateway.

Propiedad Valor
Proveedor cloudflare-ai-gateway
Plugin paquete externo oficial (@openclaw/cloudflare-ai-gateway-provider)
URL base https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
Modelo predeterminado cloudflare-ai-gateway/claude-sonnet-4-6
Clave de API CLOUDFLARE_AI_GATEWAY_API_KEY (tu clave de API del proveedor para solicitudes mediante el Gateway)

Cuando el razonamiento está habilitado para los modelos de Anthropic Messages, OpenClaw elimina los turnos finales de precarga del asistente antes de enviar la carga útil mediante Cloudflare AI Gateway. Anthropic rechaza la precarga de respuestas con razonamiento ampliado, mientras que la precarga ordinaria sin razonamiento sigue estando disponible.

Instalar el Plugin

Instala el Plugin oficial y, después, reinicia el Gateway:

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

Primeros pasos

  • Configurar la clave de API del proveedor y los datos del Gateway

    Ejecuta la incorporación y elige la opción de autenticación de Cloudflare AI Gateway:

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

    Se te solicitarán el ID de tu cuenta, el ID del Gateway y la clave de API.

  • Configurar un modelo predeterminado

    Añade el modelo a tu configuración de OpenClaw:

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

  • Verificar que el modelo esté disponible

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

    • Ejemplo no interactivo

    Para configuraciones mediante scripts o de CI, pasa todos los valores en la línea de comandos:

    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"

    Configuración avanzada

    Gateways autenticados

    Si habilitaste la autenticación del Gateway en Cloudflare, añade el encabezado cf-aig-authorization. Esto se requiere además de la clave de API de tu proveedor.

    json5
    {  models: {    providers: {      "cloudflare-ai-gateway": {        headers: {          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",        },      },    },  },}
    Nota sobre el entorno

    Si el Gateway se ejecuta como demonio (launchd/systemd), asegúrate de que CLOUDFLARE_AI_GATEWAY_API_KEY esté disponible para ese proceso.

    Contenido relacionado

    Selección de modelos

    Cómo elegir proveedores, referencias de modelos y el comportamiento de conmutación por error.
    Solución de problemas

    Solución general de problemas y preguntas frecuentes.
    Was this useful?
    On this page

    On this page