Anthropic

Anthropic crea la familia de modelos Claude. OpenClaw admite dos rutas de autenticación:

• clave de API — acceso directo a la API de Anthropic con facturación basada en uso (modelos anthropic/*)
• Claude CLI — reutiliza un inicio de sesión existente de Claude Code en el mismo host

Primeros pasos

openclaw onboard# choose: Anthropic API key

openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

openclaw models list --provider anthropic

{  env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" },  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },}

claude --version

openclaw onboard# choose: Claude CLI

openclaw models list --provider anthropic

{  agents: {    defaults: {      model: { primary: "anthropic/claude-opus-4-8" },      models: {        "anthropic/claude-opus-4-8": {          agentRuntime: { id: "claude-cli" },        },      },    },  },}

Valores predeterminados de razonamiento (Claude Fable 5, 4.8 y 4.6)

anthropic/claude-fable-5 siempre usa razonamiento adaptativo y tiene como valor predeterminado el esfuerzo high. Como Anthropic no permite desactivar el razonamiento para este modelo, /think off y /think minimal usan esfuerzo low. OpenClaw también omite valores de temperatura personalizados para las solicitudes de Fable 5.

Claude Opus 4.8 mantiene el razonamiento desactivado de forma predeterminada en OpenClaw. Cuando habilitas explícitamente el razonamiento adaptativo con /think high|xhigh|max, OpenClaw envía los valores de esfuerzo de Opus 4.8 de Anthropic; los modelos Claude 4.6 usan adaptive de forma predeterminada.

Anula por mensaje con /think:<level> o en los parámetros del modelo:

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-8": {          params: { thinking: "high" },        },      },    },  },}

Fallback por negativa de seguridad (Claude Fable 5)

Por qué existe

Los clasificadores de Fable 5 devuelven stop_reason: "refusal" en solicitudes de dominios restringidos, y también producen falsos positivos en trabajos benignos cercanos (herramientas de seguridad, ciencias de la vida o incluso pedir al modelo que reproduzca su razonamiento sin procesar). Sin fallback, el turno termina con un error aunque otro modelo Claude lo atendería sin problemas: el propio mensaje de negativa de Anthropic indica a los integradores de API que configuren un modelo de fallback.

Cómo funciona

1. Para cada solicitud directa con clave de API a anthropic/claude-fable-5, OpenClaw envía la opción de fallback del lado del servidor de Anthropic: el encabezado beta server-side-fallback-2026-06-01 más fallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8 es el único destino de fallback que Anthropic permite para Fable 5.
2. Solo una negativa de un clasificador de seguridad activa el fallback. Los límites de tasa, las sobrecargas y los errores del servidor se comportan exactamente igual que antes y pasan por el failover de modelo normal de OpenClaw.
3. El rescate ocurre dentro de la misma llamada. Una negativa antes de cualquier salida es invisible salvo por la latencia; toda la respuesta proviene de Opus 4.8. En una negativa a mitad del stream, el texto parcial se conserva como prefijo desde el que continúa el modelo de fallback, mientras que el razonamiento y las llamadas a herramientas del modelo rechazado se descartan según las reglas de reproducción de Anthropic (no deben devolverse ni ejecutarse).
4. Si Claude Opus 4.8 también se niega, el turno muestra la negativa como un error, exactamente igual que antes de esta función.

El fallback ocurre a nivel de la API de Anthropic, por lo que claude-opus-4-8 no necesita estar en tu lista de modelos configurados ni en la cadena de fallback: una clave de API compatible con Fable siempre puede atender Opus.

Observabilidad y facturación

• Un turno atendido por fallback registra un diagnóstico provider_fallback en el mensaje del asistente que nombra fromModel y toModel, y el responseModel del mensaje informa claude-opus-4-8.
• Anthropic factura por intento: una negativa antes de la salida es gratuita, y el rescate se factura a las tarifas de Claude Opus 4.8 (actualmente la mitad de las tarifas de Fable 5). La estimación de costo por turno de OpenClaw valora los turnos atendidos por fallback a tarifas de Opus para coincidir.
• Una negativa a mitad del stream factura además el parcial de Fable ya transmitido del lado de Anthropic; esa parte se informa en el uso por intento de la API, pero no se incorpora en la estimación por turno de OpenClaw.

Alcance

Se aplica a anthropic/claude-fable-5 con autenticación por clave de API contra api.anthropic.com. OAuth (reutilización de suscripción de Claude CLI), URL base de proxy, solicitudes de Bedrock, Vertex y Foundry no cambian y siguen mostrando las negativas como errores allí.

Verificado en vivo: un prompt benigno que pide a Fable 5 reproducir su cadena de pensamiento sin procesar se rechaza con category: "reasoning_extraction" cuando se envía sin fallbacks, y el mismo prompt a través de OpenClaw devuelve una respuesta normal atendida por Opus con el diagnóstico provider_fallback adjunto.

Consulta la guía de negativas y fallback de Anthropic para el comportamiento subyacente.

Caché de prompts

OpenClaw admite la función de caché de prompts de Anthropic para autenticación con clave de API.

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": {          params: { cacheRetention: "long" },        },      },    },  },}

{  agents: {    defaults: {      model: { primary: "anthropic/claude-opus-4-6" },      models: {        "anthropic/claude-opus-4-6": {          params: { cacheRetention: "long" },        },      },    },    list: [      { id: "research", default: true },      { id: "alerts", params: { cacheRetention: "none" } },    ],  },}

Configuración avanzada

{  agents: {    defaults: {      models: {        "anthropic/claude-sonnet-4-6": {          params: { fastMode: true },        },      },    },  },}

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": {},      },    },  },}

Solución de problemas

Relacionado