Saltar al contenido principal
Cloudflare AI Gateway se sitúa delante de las API de proveedores y añade análisis, caché y controles. Para Anthropic, OpenClaw usa la API Anthropic Messages mediante tu endpoint de Gateway.
PropiedadValor
Proveedorcloudflare-ai-gateway
Pluginpaquete externo oficial (@openclaw/cloudflare-ai-gateway-provider)
URL basehttps://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
Modelo predeterminadocloudflare-ai-gateway/claude-sonnet-4-6
Clave de APICLOUDFLARE_AI_GATEWAY_API_KEY (tu clave de API de proveedor para solicitudes mediante el Gateway)
Para los modelos de Anthropic enrutados mediante Cloudflare AI Gateway, usa tu clave de API de Anthropic como clave del proveedor.
Cuando el razonamiento está activado para modelos 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 extendido, mientras que la precarga ordinaria sin razonamiento sigue disponible.

​
Instalar Plugin

Instala el Plugin oficial y luego reinicia Gateway: 
openclaw plugins install @openclaw/cloudflare-ai-gateway-provider
openclaw gateway restart

​
Primeros pasos

1

Set the provider API key and Gateway details

Ejecuta la incorporación 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

Set a default model

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

Verify the model is available

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 activaste la autenticación de Gateway en Cloudflare, añade el encabezado 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>",
        },
      },
    },
  },
}
El encabezado cf-aig-authorization se autentica con el Gateway de Cloudflare, mientras que la clave de API del proveedor (por ejemplo, tu clave de Anthropic) se autentica con el proveedor upstream.
Si Gateway se ejecuta como demonio (launchd/systemd), asegúrate de que CLOUDFLARE_AI_GATEWAY_API_KEY esté disponible para ese proceso.
Una clave exportada solo en un shell interactivo no ayudará a un demonio launchd/systemd a menos que ese entorno también se importe allí. Define la clave en ~/.openclaw/.env o mediante env.shellEnv para garantizar que el proceso de Gateway pueda leerla.

​
Relacionado

Model selection

Elección de proveedores, referencias de modelo y comportamiento de conmutación por error.

Troubleshooting

Resolución general de problemas y preguntas frecuentes.