Saltar al contenido principal

​
Cloudflare AI Gateway

Cloudflare AI Gateway se sitúa delante de las API de proveedores y te permite añadir analíticas, caché y controles. Para Anthropic, OpenClaw usa la API de mensajes de Anthropic a través del endpoint de tu Gateway.
PropertyValue
Proveedorcloudflare-ai-gateway
URL basehttps://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
Modelo predeterminadocloudflare-ai-gateway/claude-sonnet-4-5
Clave de APICLOUDFLARE_AI_GATEWAY_API_KEY (tu clave de API del proveedor para solicitudes a través del Gateway)
Para modelos de Anthropic enrutados a través de Cloudflare AI Gateway, usa tu clave de API de Anthropic como clave del proveedor.

​
Primeros pasos

1

Establecer la clave de API del proveedor y los detalles de Gateway

Ejecuta onboarding y elige la opción de autenticación de Cloudflare AI Gateway:
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
Esto solicita tu ID de cuenta, ID de Gateway y clave de API.
2

Establecer un modelo predeterminado

Agrega el modelo a tu configuración de OpenClaw:
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-5" },
    },
  },
}
3

Verificar que el modelo esté disponible

openclaw models list --provider cloudflare-ai-gateway

​
Ejemplo no interactivo

Para configuraciones con scripts o CI, pasa todos los valores en la línea de comandos: 
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

Si habilitaste la autenticación de Gateway en Cloudflare, agrega el encabezado cf-aig-authorization. Esto es además de tu clave de API del proveedor.
{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}
El encabezado cf-aig-authorization autentica con el propio Cloudflare Gateway, mientras que la clave de API del proveedor (por ejemplo, tu clave de Anthropic) autentica con el proveedor ascendente.
Si Gateway se ejecuta como daemon (launchd/systemd), asegúrate de que CLOUDFLARE_AI_GATEWAY_API_KEY esté disponible para ese proceso.
Una clave presente solo en ~/.profile no ayudará a un daemon launchd/systemd a menos que ese entorno también se importe allí. Establece la clave en ~/.openclaw/.env o mediante env.shellEnv para garantizar que el proceso de Gateway pueda leerla.

​
Relacionado

Selección de modelo

Elegir proveedores, referencias de modelos y comportamiento de failover.

Solución de problemas

Solución general de problemas y preguntas frecuentes.