Configura Cloudflare AI Gateway con OpenClaw

Lanzar peticiones a una API de IA sin supervisión es como conducir a ciegas. No sabes cuánto gastas ni por qué fallan las peticiones hasta que revisas la factura a final de mes.

Usar un Gateway es la mejor opción para centralizar el tráfico. Cloudflare AI Gateway actúa como un intermediario frente a las API de los proveedores, permitiéndote añadir analíticas, caché y límites de control sin cambiar tu lógica de negocio.

Requisitos previos

• Tu account_id de Cloudflare.
• Tu gateway_id de Cloudflare.
• Una API key de Anthropic.
• OpenClaw instalado en tu entorno.

Inicio rápido

Configura el acceso en menos de 5 minutos siguiendo estos pasos:

1. Ejecuta el comando de configuración para establecer la API key y los detalles del Gateway:

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

2. Define el modelo por defecto en tu archivo de configuración:

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

Si prefieres una configuración automatizada sin prompts, usa este comando:

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"

Gateways autenticados

Si activaste la autenticación específica para el Gateway en tu panel de Cloudflare, debes incluir el header cf-aig-authorization además de tu API key del proveedor:

{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer \<cloudflare-ai-gateway-token\>",
        },
      },
    },
  },
}

Solución de problemas

El proceso no detecta la API key Si ejecutas el Gateway como un demonio a través de launchd o systemd, verifica que la variable CLOUDFLARE_AI_GATEWAY_API_KEY sea accesible para ese proceso. Puedes definirla en ~/.openclaw/.env o cargarla mediante env.shellEnv.

Error de conexión con el endpoint Revisa que el Base URL generado coincida con este formato: https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic

¿Necesitas ayuda con otros proveedores? Prueba el AI Setup Assistant.

Próximos pasos

• Configuración avanzada de OpenClaw
• Uso de modelos de Anthropic