Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Cloudflare AI Gateway se sitúa delante de las API de proveedores y te permite añadir análisis, almacenamiento en caché y controles. Para Anthropic, OpenClaw usa la Anthropic Messages API a través de tu endpoint de Gateway.
PropiedadValor
Proveedorcloudflare-ai-gateway
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 a través del Gateway)
Para los modelos de Anthropic enrutados a través de Cloudflare AI Gateway, usa tu clave de API de Anthropic como clave del proveedor.
Cuando el razonamiento está habilitado para los modelos Anthropic Messages, OpenClaw elimina los turnos finales de prellenado del asistente antes de enviar la carga útil a través de Cloudflare AI Gateway. Anthropic rechaza el prellenado de respuestas con razonamiento extendido, mientras que el prellenado ordinario sin razonamiento sigue estando disponible.

​
Primeros pasos

1

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

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

Configurar un modelo predeterminado

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

Verificar que el modelo está disponible

openclaw models list --provider cloudflare-ai-gateway

​
Ejemplo no interactivo

Para configuraciones con scripts o de 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, añade 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 Gateway de Cloudflare en sí, mientras que la clave de API del proveedor (por ejemplo, tu clave de Anthropic) autentica con el proveedor ascendente.
Si el Gateway se ejecuta como un demonio (launchd/systemd), asegúrate de que CLOUDFLARE_AI_GATEWAY_API_KEY esté disponible para ese proceso.
Una clave que solo esté en ~/.profile no ayudará a un demonio launchd/systemd a menos que ese entorno también se importe allí. Configura la clave en ~/.openclaw/.env o mediante env.shellEnv para asegurarte de que el proceso del gateway pueda leerla.

​
Relacionado

Selección de modelo

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.