Providers

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 periodos de cuota y un presupuesto opcional de 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 de 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 de administración.

El historial de costes de la API de administración procede de la API de uso y costes de Anthropic. Representa la facturación real del proveedor, separada del coste estimado por OpenClaw a partir de las sesiones.

Primeros pasos

Clave de API

Opción recomendada para: acceso estándar a la API y facturación basada en el uso.

  • Obtener la clave de API

    Cree una clave de API en la consola de Anthropic.

  • Ejecutar la incorporación

    bash
    openclaw onboard# elija: clave de API de Anthropic

    También puede proporcionar la clave directamente:

    bash
    openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
  • Verificar que el modelo esté disponible

    bash
    openclaw models list --provider anthropic
  • Ejemplo de configuración

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

    CLI de Claude

    Opción recomendada para: reutilizar un inicio de sesión existente de la CLI de Claude sin una clave de API independiente.

  • Asegurarse de que la CLI de Claude esté instalada y tenga una sesión iniciada

    Verifíquelo con:

    bash
    claude --version
  • Ejecutar la incorporación

    bash
    openclaw onboard# elija: CLI de Claude

    OpenClaw detecta y reutiliza las credenciales existentes de la CLI de Claude.

  • Verificar que el modelo esté disponible

    bash
    openclaw models list --provider anthropic
  • Obtener un token de configuración

    Ejecute claude setup-token en cualquier máquina que tenga Claude Code instalado. Imprime un token de larga duración que comienza por sk-ant-oat01-.

    Durante la incorporación, pegue el token en la aplicación de macOS seleccionando Token de configuración de Anthropic en Conectar con una clave de API o un token, o utilice:

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

    Ejemplo de configuración

    Se recomienda usar la referencia canónica del modelo de Anthropic junto con una sustitución de ejecución de la CLI:

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

    Las referencias de modelo heredadas claude-cli/claude-opus-4-7 siguen funcionando por compatibilidad, pero las configuraciones nuevas deben mantener la selección del proveedor/modelo como anthropic/* y colocar el backend de ejecución en la política de ejecución del proveedor/modelo.

    Facturación y claude -p

    OpenClaw utiliza la ruta no interactiva claude -p de Claude Code para las ejecuciones de la CLI de Claude. Anthropic trata actualmente esa ruta como uso programático/del Agent SDK:

    • La actualización de soporte de Anthropic del 15 de junio de 2026 suspendió el plan de créditos independientes para el Agent SDK anunciado anteriormente.
    • El uso del Agent SDK de Claude mediante un plan de suscripción, claude -p y las aplicaciones de terceros sigue consumiendo los límites de uso de la suscripción con la sesión iniciada.
    • El crédito mensual del Agent SDK anunciado anteriormente no está disponible mientras Anthropic revisa ese plan.
    • Los inicios de sesión mediante la consola/clave de API utilizan facturación de la API por uso y no reciben el crédito del Agent SDK de la suscripción.

    Consulte el artículo sobre el plan del Agent SDK de Anthropic para obtener información sobre la suspensión, y los artículos sobre los planes de Claude Code para conocer el comportamiento de las suscripciones Pro/Max y Team/Enterprise.

    Anthropic puede modificar la facturación y los límites de frecuencia de Claude Code sin una versión nueva de OpenClaw. Consulte claude auth status, /status y la documentación enlazada de Anthropic cuando sea importante que la facturación sea predecible.

    Sesiones de Claude entre distintos equipos

    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 las sesiones de Claude Code no archivadas en el Gateway y en los hosts de 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 las sesiones interactivas concurrentes que no son de cadenas secundarias (cli) y las sesiones sin interfaz del Agent SDK mediante la CLI (sdk-cli) en ~/.claude/projects/.
    • Las sesiones de Claude Desktop utilizan el título de Desktop, la hora de actividad y el estado de archivado cuando sus metadatos apuntan al mismo ID de sesión de Claude Code.
    • Una sesión exclusiva de la CLI no tiene indicador de archivado, por lo que permanece visible mientras su transcripción esté presente.

    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/. Apruebe 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 responde ese equipo. Vuelve a realizar la conciliación después de cambios en la conectividad de los hosts, cuando la página recupera el foco y, como máximo, cada 30 segundos mientras está visible, por lo 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. Utilice Cargar más sesiones debajo de un grupo de 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 al actualizar. 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. Cualquier elemento individual que supere el límite de seguridad del Node/Gateway se marca claramente como truncado.

    En una fila claude-cli local del Gateway, al escribir en el editor normal se llama a sessions.catalog.continue. OpenClaw vuelve a resolver el registro del catálogo local, crea o reutiliza una sesión nativa fijada al modelo, importa como máximo 200 elementos visibles o 512 KiB e inicializa la vinculación 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 de Node sin interfaz también puede permitir que sus filas de la CLI de Claude se continúen habilitando el siguiente ajuste local del Node y reiniciando el host de Node:

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

    El Node anuncia agent.cli.claude.run.v1 únicamente cuando el ajuste está habilitado 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 y el inicio de sesión de Claude de ese Node. La política de aprobación de ejecución del Node sigue aplicándose; el Gateway no puede forzar la 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 desde una transcripción del Gateway y rechaza archivos adjuntos e imágenes. Las filas de Claude Desktop siguen siendo de solo lectura. Los Node de aplicaciones nativas de 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 del nodo y el límite de seguridad.

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

    anthropic/claude-opus-5 utiliza razonamiento adaptativo con un nivel de esfuerzo high de forma predeterminada. Use /think off para desactivar el razonamiento o /think xhigh|max para los niveles de esfuerzo nativos superiores del modelo. OpenClaw omite los presupuestos manuales de razonamiento, los parámetros de muestreo personalizados, los prefijos precargados del asistente y Priority Tier para Opus 5 porque Anthropic no admite esas características de solicitud en este modelo. El catálogo publica su ventana de contexto de 1,000,000 tokens, su límite de salida de 128,000 tokens, la entrada de imágenes y los precios de entrada/salida $5/$25.

    anthropic/claude-sonnet-5 utiliza los mismos valores predeterminados de razonamiento adaptativo y las mismas restricciones de solicitud. El catálogo utiliza los precios introductorios de entrada/salida $2/$10 de Anthropic hasta el 31 de agosto de 2026; los precios estándar $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 para este modelo, por lo que /think off y /think minimal se asignan 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 quien realiza la llamada. El catálogo publica su ventana de contexto de 1,000,000 tokens, su límite de salida de 128,000 tokens, la entrada de imágenes y los precios de entrada/salida $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 Anthropic para Opus 4.8; los modelos Claude 4.6 (Opus 4.6 y Sonnet 4.6) utilizan adaptive de forma predeterminada.

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

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

    Alternativa ante rechazos de seguridad (Claude Fable 5)

    Por qué existe

    Los clasificadores de Fable 5 devuelven stop_reason: "refusal" en las solicitudes de dominios 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 quienes integran la API que configuren un modelo alternativo.

    Cómo funciona

    1. En cada solicitud directa con clave de API a anthropic/claude-fable-5, OpenClaw envía la habilitación de la alternativa del lado del 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 como antes y pasan por la conmutación por error de modelos normal de OpenClaw.
    3. La recuperación ocurre dentro de la misma llamada. Un rechazo anterior a cualquier salida resulta invisible salvo por la latencia; toda la respuesta procede de Opus 4.8. Si el rechazo ocurre durante la transmisión, el texto parcial se conserva como prefijo desde el que 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 presenta el rechazo como un error, exactamente igual que antes de esta característica.

    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 configurados 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 la alternativa registra un diagnóstico provider_fallback en el mensaje del asistente que identifica fromModel y toModel, y el campo responseModel del mensaje indica claude-opus-4-8.
    • Anthropic factura cada intento: un rechazo anterior 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 la alternativa según las tarifas de Opus para que coincidan.
    • Un rechazo durante la transmisión factura además, por parte de Anthropic, el contenido parcial de Fable ya transmitido; esa parte se indica 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 Claude CLI), las URL base de proxy, Bedrock, Vertex y las solicitudes de Foundry no cambian y siguen presentando los rechazos como errores.

    Verificación en vivo: una indicación 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 indicación 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 indicaciones

    OpenClaw admite la característica de almacenamiento en caché de indicaciones de Anthropic para la autenticación mediante clave de API.

    Valor Duración de la caché Descripción
    "short" (predeterminado) 5 minutos Se aplica automáticamente a la autenticación mediante clave de API
    "long" 1 hora Caché ampliada
    "none" Sin caché Desactiva el almacenamiento en caché de indicaciones
    json5
    {  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": {          params: { cacheRetention: "long" },        },      },    },  },}
    Anulaciones de caché por agente

    Use los parámetros del modelo como base y, a continuación, anule agentes específicos mediante agents.entries.*.params:

    json5
    {  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" } },    ],  },}

    Orden de combinación de la configuración:

    1. agents.defaults.models["provider/model"].params
    2. agents.entries.*.params (coincide con id y anula por clave)

    Esto permite que un agente mantenga una caché de larga duración mientras otro agente del mismo modelo desactiva el almacenamiento en caché para tráfico con ráfagas o poca reutilización.

    Notas sobre Claude en Bedrock
    • Los modelos Claude de Anthropic en Bedrock (amazon-bedrock/*anthropic.claude*) aceptan el paso directo de cacheRetention cuando se configura.
    • Los modelos de Bedrock que no son de Anthropic se fuerzan a cacheRetention: "none" durante la ejecución.
    • Los valores predeterminados inteligentes para claves de API también establecen cacheRetention: "short" para las referencias de Claude en Bedrock cuando no se define ningún valor explícito.

    Configuración avanzada

    Modo rápido

    El conmutador compartido /fast de OpenClaw establece el campo service_tier de Anthropic para el tráfico directo con clave de API a api.anthropic.com.

    Comando Se asigna a
    /fast on service_tier: "auto"
    /fast off service_tier: "standard_only"
    json5
    {  agents: {    defaults: {      models: {        "anthropic/claude-sonnet-4-6": {          params: { fastMode: true },        },      },    },  },}
    Comprensión multimedia (imágenes y PDF)

    El Plugin de Anthropic incluido registra la comprensión de imágenes y PDF. OpenClaw resuelve automáticamente las capacidades multimedia a partir de la autenticación de Anthropic configurada; no se necesita configuración adicional.

    Propiedad Valor
    Modelo predeterminado claude-opus-5
    Entrada admitida Imágenes, documentos PDF

    Cuando se adjunta una imagen o un PDF a una conversación, OpenClaw lo dirige automáticamente a través del proveedor de comprensión multimedia de Anthropic.

    Ventana de contexto de 1M

    Claude Opus 5, Sonnet 5, Mythos 5 y Fable 5 tienen una ventana de entrada exacta de 1,000,000 tokens y admiten hasta 128,000 tokens de salida. La ventana de contexto de 1M de Anthropic también está disponible con carácter general en los modelos Claude 4.x con razonamiento adaptativo: Opus 4.8, Opus 4.7, Opus 4.6 y Sonnet 4.6. OpenClaw dimensiona estos modelos automáticamente, sin necesidad de params.context1m:

    json5
    {  agents: {    defaults: {      models: {        "anthropic/claude-opus-5": {},        "anthropic/claude-sonnet-5": {},        "anthropic/claude-mythos-5": {},        "anthropic/claude-opus-4-6": {},      },    },  },}

    Las configuraciones anteriores pueden conservar params.context1m: true; es una operación nula inocua para estos modelos y OpenClaw ya no envía el encabezado beta retirado context-1m-2025-08-07 en ningún caso. Las entradas de configuración anthropicBeta anteriores con ese valor se eliminan durante la resolución de los encabezados de la solicitud, y los modelos Claude anteriores no compatibles mantienen su ventana de contexto normal.

    params.context1m: true funciona de la misma manera para el backend de Claude CLI (claude-cli/*): los modelos Opus y Sonnet compatibles y disponibles con carácter general ya obtienen automáticamente la ventana de 1M, por lo que el parámetro también es opcional allí.

    Contexto de 1M de Claude Opus 5

    anthropic/claude-opus-5 y su variante claude-cli tienen una ventana de contexto de 1M de forma predeterminada; no se necesita params.context1m: true.

    Solución de problemas

    Errores 401 / token repentinamente no válido

    La autenticación mediante token de Anthropic caduca y puede revocarse. Para instalaciones nuevas, use en su lugar una clave de API de Anthropic.

    No se encontró ninguna clave de API para el proveedor "anthropic"

    La autenticación de Anthropic es por agente; los agentes nuevos no heredan las claves del agente principal. Vuelva a ejecutar la incorporación para ese agente (o configure una clave de API en el host del Gateway) y, a continuación, verifíquela con openclaw models status.

    No se encontraron credenciales para el perfil "anthropic:default"

    Ejecute openclaw models status para ver qué perfil de autenticación está activo. Vuelva a ejecutar la incorporación o configure una clave de API para la ruta de ese perfil.

    No hay ningún perfil de autenticación disponible (todos están en período de espera)

    Consulte openclaw models status --json para auth.unusableProfiles. Los períodos de espera por límites de solicitudes de Anthropic pueden aplicarse a modelos específicos, por lo que es posible que otro modelo de Anthropic siga estando disponible. Añada otro perfil de Anthropic o espere a que finalice el período de espera.

    Contenido relacionado

    Was this useful?
    On this page

    On this page