Saltar al contenido principal

Cloudflare AI Gateway

Cloudflare AI Gateway se sitúa delante de las API de los proveedores y te permite añadir analíticas, caché y controles. Para Anthropic, OpenClaw usa la Anthropic Messages API a través del endpoint de tu Gateway.
  • Proveedor: cloudflare-ai-gateway
  • URL base: https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
  • Modelo predeterminado: cloudflare-ai-gateway/claude-sonnet-4-5
  • Clave de API: CLOUDFLARE_AI_GATEWAY_API_KEY (tu clave de API del proveedor para solicitudes a través del Gateway)
Para modelos de Anthropic, usa tu clave de API de Anthropic.

Inicio rápido

  1. Configura la clave de API del proveedor y los detalles del Gateway:
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
  1. Configura un modelo predeterminado:
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-5" },
    },
  },
}

Ejemplo no interactivo

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 habilitaste la autenticación del Gateway en Cloudflare, añade la cabecera cf-aig-authorization (esto es adicional a tu clave de API del proveedor).
{
  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úrate de que CLOUDFLARE_AI_GATEWAY_API_KEY esté disponible para ese proceso (por ejemplo, en ~/.openclaw/.env o mediante env.shellEnv).