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 analíticas, almacenamiento en caché y controles. Para Anthropic, OpenClaw utiliza la API Messages de Anthropic mediante el endpoint de 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 (la clave de API del proveedor para las solicitudes mediante el Gateway)

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

Instalar el Plugin

Instale el Plugin oficial y, a continuación, reinicie 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

    Ejecute la incorporación y elija la opción de autenticación de Cloudflare AI Gateway:

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

    Se solicitarán el ID de la cuenta, el ID del gateway y la clave de API.

  • Configurar un modelo predeterminado

    Añada el modelo a la 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 automatizadas o de CI, pase todos los valores mediante 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 ha habilitado la autenticación del Gateway en Cloudflare, añada la cabecera cf-aig-authorization. Esto se requiere además de la clave de API del 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 daemon (launchd/systemd), asegúrese de que CLOUDFLARE_AI_GATEWAY_API_KEY esté disponible para ese proceso.

    Contenido relacionado

    Selección de modelos

    Elección de proveedores, referencias de modelos y 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