Anthropic

Anthropic desarrolla la familia de modelos Claude. OpenClaw admite dos métodos de autenticación:

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

Seguimiento del uso y los costes

OpenClaw detecta la credencial de Anthropic disponible y selecciona la interfaz de uso correspondiente:

• Las credenciales de suscripción/configuración de Claude muestran los períodos de cuota y el presupuesto opcional para uso adicional.
• ANTHROPIC_ADMIN_KEY o ANTHROPIC_ADMIN_API_KEY muestra 30 días de costes de la organización y uso de la API Messages notificados por el proveedor en Uso de la interfaz de control, incluidos el gasto diario, los totales de tokens/caché, los modelos principales y las categorías de costes.
• Una credencial sk-ant-admin... almacenada en el perfil del proveedor Anthropic se detecta automáticamente como clave de la API Admin.

El historial de costes de la API Admin procede de la API de uso y costes de Anthropic. Refleja la facturación real del proveedor y es independiente del coste estimado por OpenClaw a partir de las sesiones.

Primeros pasos

openclaw onboard# elige: clave de API de Anthropic

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# elige: CLI de Claude

openclaw models list --provider anthropic

openclaw models auth login --provider anthropic --method setup-token

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

Sesiones de Claude entre distintos ordenadores

El Plugin de Anthropic incluido añade un grupo Claude Code a la barra lateral normal de sesiones. Las filas se abren en el panel normal de chat. Detecta sesiones de Claude Code no archivadas en el Gateway y en los hosts Node conectados:

• Las sesiones de la CLI de Claude proceden de registros válidos del índice de proyectos. Para las transcripciones no indexadas, un mecanismo alternativo acotado de metadatos reconoce sesiones interactivas simultáneas que no pertenecen a una cadena secundaria (cli) y sesiones de CLI sin interfaz del Agent SDK (sdk-cli) en ~/.claude/projects/.
• Las sesiones de Claude Desktop utilizan el título de Desktop, la hora de actividad y el estado de archivo cuando sus metadatos apuntan al mismo ID de sesión de Claude Code.
• Una sesión exclusiva de la CLI no tiene indicador de archivo, por lo que permanece visible mientras exista su transcripción.

No se requiere ninguna configuración adicional de OpenClaw para la detección. El Plugin de Anthropic está incluido y habilitado de forma predeterminada; un Node nativo de macOS anuncia los comandos de solo lectura para sesiones de Claude cuando existe el directorio local ~/.claude/projects/. Aprueba la actualización del emparejamiento del Node cuando esos comandos aparezcan por primera vez.

La barra lateral agrupa las filas por su Gateway o por el host del Node emparejado y muestra la página acotada más reciente de cada host en cuanto ese ordenador responde. Vuelve a efectuar la conciliación tras los cambios de conectividad del host, cuando la página recupera el foco y, como máximo, cada 30 segundos mientras está visible, de modo que las sesiones de Claude creadas fuera de OpenClaw aparecen sin necesidad de recargar. Cuando cambia un catálogo, se realiza una pasada de seguimiento más rápida. Utiliza Cargar más sesiones debajo de un grupo del catálogo para añadir la página siguiente de cada host que tenga más historial; las filas añadidas permanecen visibles y se vuelven a obtener con la misma profundidad durante las actualizaciones. Los clientes del catálogo utilizan sessions.catalog.list; al abrir una fila se utiliza sessions.catalog.read.

La toma de control del terminal resuelve claude desde el PATH del shell de inicio de sesión del usuario del host propietario antes que desde el PATH del servicio/demonio. Esto mantiene las sesiones iniciadas desde la aplicación alineadas con la CLI de Claude que obtiene el operador en un terminal normal.

Al seleccionar una fila, se lee primero la página más reciente de la transcripción. Cargar elementos anteriores de la transcripción sigue un cursor de bytes opaco y lee otra sección acotada del archivo JSONL en lugar de cargar todo el historial. Se conserva el contenido normal del usuario, del asistente, de razonamiento, de llamadas a herramientas y de resultados de herramientas. Los elementos individuales que superan el límite de seguridad del Node/Gateway se marcan claramente como truncados.

Para una fila claude-cli local del Gateway, al escribir en el compositor normal se llama a sessions.catalog.continue. OpenClaw vuelve a resolver el registro del catálogo local, crea o reutiliza una sesión nativa bloqueada al modelo, importa como máximo 200 elementos visibles o 512 KiB y establece el enlace de la CLI de Claude. El primer turno se reanuda con --fork-session; Claude asigna a la bifurcación un nuevo ID de sesión, por lo que los turnos posteriores utilizan la bifurcación y la sesión de origen permanece intacta.

Un host Node sin interfaz también puede permitir que sus filas de la CLI de Claude continúen habilitando la siguiente opción local del Node y reiniciando el host Node:

{  nodeHost: {    agentRuns: {      claude: { enabled: true },    },  },}

El Node anuncia agent.cli.claude.run.v1 únicamente cuando la opción está habilitada y se puede resolver su ejecutable local claude. OpenClaw vuelve a resolver el registro del catálogo en ese Node, importa el mismo historial acotado y vincula la sesión adoptada al Node y al directorio de trabajo indicado por el catálogo. Cada turno ejecuta el proceso claude -p real del Node utilizando los archivos de Claude y el inicio de sesión de ese Node. La política de aprobación de ejecución del Node sigue aplicándose; el Gateway no puede forzar esta activación.

La versión 1 de la continuación mediante Node solo permite una ejecución. Omite la configuración MCP de bucle invertido del Gateway y los argumentos del Plugin de Skills del Gateway, no vuelve a inicializar a partir de una transcripción del Gateway y rechaza archivos adjuntos e imágenes. Las filas de Claude Desktop siguen siendo de solo lectura. Los Nodes de la aplicación nativa para macOS también siguen siendo de solo lectura hasta que la aplicación anuncie el comando de ejecución.

Consulte Nodos: sesiones y transcripciones de Claude para conocer el comando de Node y el límite de seguridad.

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

anthropic/claude-sonnet-5 utiliza razonamiento adaptativo con un nivel de esfuerzo high de forma predeterminada. Utilice /think off para desactivar el razonamiento, o /think xhigh|max para los niveles de esfuerzo nativos superiores del modelo. OpenClaw omite los presupuestos de razonamiento manual, los parámetros de muestreo personalizados, los prefijos del asistente y Priority Tier para Sonnet 5 porque Anthropic no admite esas funciones de solicitud en este modelo. El catálogo utiliza los precios introductorios de entrada/salida de Anthropic de $2/$10 hasta el 31 de agosto de 2026; los precios estándar de $3/$15 comienzan el 1 de septiembre de 2026.

anthropic/claude-fable-5 siempre utiliza razonamiento adaptativo y adopta de forma predeterminada un nivel de esfuerzo high. Anthropic no permite desactivar el razonamiento en este modelo, por lo que /think off y /think minimal se asignan en su lugar al nivel de esfuerzo low. OpenClaw también omite los valores de temperatura personalizados en las solicitudes de Fable 5, ya que Anthropic rechaza la modificación de la temperatura en cualquier solicitud con el razonamiento activado.

anthropic/claude-mythos-5 es un modelo de acceso limitado con el mismo contrato de razonamiento adaptativo siempre activo. OpenClaw utiliza high de forma predeterminada, asigna /think off y /think minimal a low y omite los parámetros de muestreo seleccionados por el solicitante. El catálogo publica su ventana de contexto de 1,000,000 tokens, el límite de salida de 128,000 tokens, la entrada de imágenes y los precios de entrada/salida de $10/$50.

Claude Opus 4.8 mantiene el razonamiento desactivado de forma predeterminada en OpenClaw. Cuando se activa 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 (Opus 4.6 y Sonnet 4.6) utilizan adaptive de forma predeterminada.

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

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

Alternativa ante rechazos de seguridad (Claude Fable 5)

Por qué existe

Los clasificadores de Fable 5 devuelven stop_reason: "refusal" para las solicitudes de ámbitos restringidos y también producen falsos positivos en trabajos benignos relacionados (herramientas de seguridad, ciencias biológicas o incluso solicitudes para que el modelo reproduzca su razonamiento sin procesar). Sin una alternativa, el turno termina con un error aunque otro modelo Claude podría atenderlo sin problemas; el propio mensaje de rechazo de Anthropic indica a los integradores de la API que configuren un modelo alternativo.

Cómo funciona

1. Para cada solicitud directa con clave de API a anthropic/claude-fable-5, OpenClaw envía la habilitación de la alternativa en el servidor de Anthropic: el encabezado beta server-side-fallback-2026-06-01 junto con fallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8 es el único destino alternativo que Anthropic permite para Fable 5.
2. Solo un rechazo del clasificador de seguridad activa la alternativa. Los límites de frecuencia, las sobrecargas y los errores del servidor se comportan exactamente igual que antes y pasan por la conmutación por error de modelos normal de OpenClaw.
3. La recuperación sucede dentro de la misma llamada. Un rechazo previo a cualquier salida es invisible salvo por la latencia; toda la respuesta procede de Opus 4.8. En caso de un rechazo a mitad de la transmisión, el texto parcial se conserva como prefijo desde el cual continúa el modelo alternativo, mientras que el razonamiento y las llamadas a herramientas del modelo que rechazó la solicitud se descartan conforme a las reglas de reproducción de Anthropic (no deben devolverse ni ejecutarse).
4. Si Claude Opus 4.8 también rechaza la solicitud, el turno muestra el rechazo como un error, exactamente igual que antes de esta función.

La alternativa se aplica en el nivel de la API de Anthropic, por lo que claude-opus-4-8 no necesita estar en la lista de modelos configurada ni en la cadena de alternativas: una clave de API compatible con Fable siempre puede utilizar Opus.

Observabilidad y facturación

• Un turno atendido por el modelo alternativo registra un diagnóstico provider_fallback en el mensaje del asistente que indica fromModel y toModel, y el responseModel del mensaje informa de claude-opus-4-8.
• Anthropic factura por intento: un rechazo previo a la salida es gratuito y la recuperación se factura según las tarifas de Claude Opus 4.8 (actualmente la mitad de las tarifas de Fable 5). La estimación de costes por turno de OpenClaw calcula los turnos atendidos por el modelo alternativo según las tarifas de Opus.
• Un rechazo a mitad de la transmisión factura además el fragmento de Fable ya transmitido por parte de Anthropic; esa parte se informa en el uso por intento de la API, pero no se incorpora a la estimación por turno de OpenClaw.

Alcance

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

Verificación en vivo: una solicitud benigna que pide a Fable 5 que reproduzca su cadena de pensamiento sin procesar se rechaza con category: "reasoning_extraction" cuando se envía sin alternativas, mientras que la misma solicitud a través de OpenClaw devuelve una respuesta normal atendida por Opus con el diagnóstico provider_fallback adjunto.

Consulte la guía de rechazos y alternativas de Anthropic para conocer el comportamiento subyacente.

Almacenamiento en caché de prompts

OpenClaw admite la función de almacenamiento en caché de prompts de Anthropic para la autenticación mediante 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-sonnet-5": {},        "anthropic/claude-mythos-5": {},        "anthropic/claude-opus-4-6": {},      },    },  },}

Solución de problemas

Relacionado