Anthropic

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

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

Warning

El backend de Claude CLI de OpenClaw ejecuta la CLI de Claude Code instalada en modo de impresión no interactivo. La documentación actual de Claude Code de Anthropic describe claude -p como uso de SDK de Agente/programático. A partir del 15 de junio de 2026, Anthropic indica que el uso del claude -p del plan de suscripción ya no se deduce de los límites normales del plan de Claude; primero se deduce de un crédito mensual separado del SDK de Agente y luego de los créditos de uso a las tarifas estándar de la API cuando esos créditos están habilitados.

Claude Code interactivo aún se deduce de los límites del plan de Claude con sesión iniciada. La autenticación con clave de API sigue siendo facturación directa de API de pago por uso. Para hosts de puerta de enlace de larga duración, automatización compartida y gastos de producción predecibles, use una clave de API de Anthropic.

La documentación pública actual de Anthropic:

• Referencia de la CLI de Claude Code
• Use el SDK de Agente de Claude con su plan de Claude
• Use Claude Code con su plan Pro o Max
• Use Claude Code con su plan de Team o Enterprise
• Gestionar los costos de Claude Code

Para empezar

Clave de APIClaude CLI

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

1. Obtenga su clave de API

   Cree una clave de API en la Consola de Anthropic.

2. Ejecutar la incorporación

   openclaw onboard
   # choose: Anthropic API key

   O pase la clave directamente:

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

3. Verificar que el modelo esté disponible

   openclaw models list --provider anthropic

Ejemplo de configuración

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

Mejor para: reutilizar un inicio de sesión existente de Claude CLI sin una clave de API separada.

1. Asegurarse de que Claude CLI esté instalado y registrado

   Verifique con:

   claude --version

2. Ejecutar la incorporación

   openclaw onboard
   # choose: Claude CLI

   OpenClaw detecta y reutiliza las credenciales existentes de Claude CLI.

3. Verificar que el modelo esté disponible

   openclaw models list --provider anthropic

Note

Los detalles de configuración y tiempo de ejecución del backend de Claude CLI están en CLI Backends.

Warning

La reutilización de Claude CLI espera que el proceso de OpenClaw se ejecute en el mismo host que el inicio de sesión de Claude CLI. Las instalaciones en contenedores como Podman no montan el host ~/.claude en la configuración o el tiempo de ejecución; use una clave de API de Anthropic allí, o elija un proveedor con OAuth administrado por OpenClaw como OpenAI Codex.

Ejemplo de configuración

Prefiera la referencia de modelo canónica de Anthropic más una anulación de tiempo de ejecución de CLI:

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

Las referencias de modelo claude-cli/claude-opus-4-7 heredadas todavía funcionan para compatibilidad, pero la nueva configuración debe mantener la selección de proveedor/modelo como anthropic/* y poner el backend de ejecución en la política de tiempo de ejecución del proveedor/modelo.

Facturación y claude -p

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

• Hasta el 15 de junio de 2026, el manejo del plan de suscripción sigue las reglas activas de Claude Code de Anthropic para la cuenta conectada.
• A partir del 15 de junio de 2026, el uso claude -p del plan de suscripción se toma del crédito mensual de Agent SDK del usuario primero, luego de los créditos de uso a las tarifas estándar de API si los créditos de uso están habilitados.
• Los inicios de sesión de consola/clave de API usan la facturación de API de pago por uso y no reciben el crédito de Agent SDK de suscripción.

Anthropic puede cambiar el comportamiento de facturación y limitación de tasa de Claude Code sin un lanzamiento de OpenClaw. Verifique claude auth status, /status, y la documentación vinculada de Anthropic cuando importe la previsibilidad de la facturación.

Tip

Para automatización de producción compartida, use una clave de API de Anthropic en lugar de Claude CLI. OpenClaw también admite opciones estilo suscripción de OpenAI Codex, Qwen Cloud, MiniMax y Z.AI / GLM.

Valores predeterminados de pensamiento (Claude 4.8 y 4.6)

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

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

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

Note

Documentación relacionada de Anthropic:

• Pensamiento adaptativo
• Pensamiento extendido

Almacenamiento en caché del prompt

OpenClaw admite la función de almacenamiento en caché del prompt de Anthropic para la autenticación con clave de API.

Valor	Duración de la caché	Descripción
"short" (predeterminado)	5 minutos	Se aplica automáticamente para la autenticación con clave de API
"long"	1 hora	Caché extendida
"none"	Sin almacenamiento en caché	Desactivar el almacenamiento en caché del prompt

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

Anulaciones de caché por agente

Usa los parámetros a nivel de modelo como base, luego anula agentes específicos a través de agents.list[].params:

{
  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 fusión de configuración:

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

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

Notas de Claude en Bedrock

• Los modelos Anthropic Claude en Bedrock (amazon-bedrock/*anthropic.claude*) aceptan el paso a través de cacheRetention cuando están configurados.
• Los modelos de Bedrock que no son de Anthropic se fuerzan a cacheRetention: "none" en tiempo de ejecución.
• Los valores predeterminados inteligentes de clave de API también inicializan cacheRetention: "short" para referencias de Claude en Bedrock cuando no se establece ningún valor explícito.

Configuración avanzada

Modo rápido

El interruptor compartido /fast de OpenClaw soporta el tráfico directo de Anthropic (API key y OAuth a api.anthropic.com).

Command	Asigna a
/fast on	service_tier: "auto"
/fast off	service_tier: "standard_only"

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

Note

• Solo se inyecta para solicitudes directas a api.anthropic.com. Las rutas de proxy dejan service_tier sin cambios.
• Los parámetros explícitos serviceTier o service_tier anulan /fast cuando ambos están establecidos.
• En cuentas sin capacidad de Priority Tier, service_tier: "auto" puede resolverse como standard.

Comprensión multimedia (imagen y PDF)

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

Property	Valor
Default model	claude-opus-4-8
Supported input	Imágenes, documentos PDF

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

Ventana de contexto de 1M

La ventana de contexto de 1M de Anthropic está disponible en los modelos Claude 4.x con capacidad GA como Opus 4.8, Opus 4.7, Opus 4.6 y Sonnet 4.6. OpenClaw dimensiona esos modelos en 1M automáticamente:

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

Las configuraciones más antiguas pueden conservar params.context1m: true, pero OpenClaw ya no envía el encabezado beta retirado context-1m-2025-08-07. Las entradas de configuración anthropicBeta más antiguas con ese valor se ignoran durante la resolución del encabezado de la solicitud y los modelos Claude más antiguos no compatibles se mantienen en su ventana de contexto normal.

params.context1m: true también se aplica al backend de Claude CLI (claude-cli/*) para los modelos Opus y Sonnet con capacidad GA elegibles, preservando la ventana de contexto en tiempo de ejecución para esas sesiones de CLI para que coincida con el comportamiento de la API directa.

Warning

Requiere acceso a contexto largo en sus credenciales de Anthropic. La autenticación con token de OAuth/suscripción mantiene sus encabezados beta requeridos de Anthropic, pero OpenClaw elimina el encabezado beta de 1M retirado si aún permanece en la configuración antigua.

Contexto de 1M de Claude Opus 4.8

anthropic/claude-opus-4-8 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 inválido de repente

La autenticación de token de Anthropic expira y puede ser revocada. Para nuevas configuraciones, use una clave de API de Anthropic en su lugar.

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

La autenticación de Anthropic es por agente: los nuevos agentes 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 de la puerta de enlace) y luego verifique 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 esa ruta de perfil.

No available auth profile (all in cooldown)

Consulte openclaw models status --json para auth.unusableProfiles. Los períodos de espera de límites de tasa de Anthropic pueden estar limitados al modelo, por lo que un modelo hermano de Anthropic aún puede ser utilizable. Agregue otro perfil de Anthropic o espere el período de espera.

Note

Más ayuda:

Solución de problemas

y

Preguntas frecuentes

.

Relacionado

Model selection

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

CLI backends

Configuración y detalles de tiempo de ejecución del backend de Claude CLI.

Prompt caching

Cómo funciona el almacenamiento en caché de prompts en los diferentes proveedores.

OAuth and auth

Detalles de autenticación y reglas de reutilización de credenciales.