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 — reutiliza un inicio de sesión existente de Claude CLI en el mismo host

Para empezar

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

Obtén tu clave de API
Crea una clave de API en la Consola de Anthropic.

Ejecuta la incorporación

openclaw onboard
# choose: Anthropic API key

O pasa la clave directamente:

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

Verifica que el modelo esté disponible
Ventana de terminal
```
openclaw models list --provider anthropic
```

Ejemplo de configuración

{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

Lo mejor para: reutilizar un inicio de sesión existente de Claude CLI sin una clave de API por separado.

Asegúrese de que Claude CLI esté instalado y haya iniciado sesión
Verifíquelo con:
Ventana de terminal
```
claude --version
```
Ejecute la incorporación
Ventana de terminal
```
openclaw onboard
# choose: Claude CLI
```
OpenClaw detecta y reutiliza las credenciales existentes de Claude CLI.
Verifique que el modelo esté disponible
Ventana de terminal
```
openclaw models list --provider anthropic
```

Ejemplo de configuración

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

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

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

Valores predeterminados de pensamiento (Claude 4.6)

Los modelos Claude 4.6 tienen por defecto el pensamiento adaptive en OpenClaw cuando no se establece un nivel de pensamiento explícito.

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

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

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

Utilice los parámetros a nivel de modelo como línea base y luego anule 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 combinación de configuración:

agents.defaults.models["provider/model"].params
agents.list[].params (que 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 el 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 ven obligados a cacheRetention: "none" en tiempo de ejecución.
Los valores predeterminados inteligentes de clave de API también proporcionan cacheRetention: "short" para las 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 admite el tráfico directo de Anthropic (clave de API y OAuth hacia api.anthropic.com).

Comando	Se asigna a
`/fast on`	`service_tier: "auto"`
`/fast off`	`service_tier: "standard_only"`

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

Comprensión de medios (imagen y PDF)

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

Propiedad	Valor
Modelo por defecto	`claude-opus-4-7`
Entrada admitida	Imágenes, documentos PDF

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

Ventana de contexto de 1M (beta)

La ventana de contexto de 1M de Anthropic está restringida a beta. Actívela por modelo:

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

OpenClaw asigna esto a anthropic-beta: context-1m-2025-08-07 en las solicitudes.

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

Contexto 1M de Claude Opus 4.7

anthropic/claude-opus-4.7 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ó API key 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 integración para ese agente (o configure una API key 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 integración o configure una API key para esa ruta de perfil.

No available auth profile (all in cooldown)

Consulte openclaw models status --json para obtener auth.unusableProfiles. Los períodos de enfriamiento por límites de velocidad de Anthropic pueden ser específicos del modelo, por lo que es posible que un modelo hermano de Anthropic aún se pueda usar. Agregue otro perfil de Anthropic o espere el enfriamiento.

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.