Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 CLI en el mismo host
El personal de Anthropic nos indicó que el uso de Claude CLI al estilo de OpenClaw vuelve a estar permitido, por lo que OpenClaw trata la reutilización de Claude CLI y el uso de claude -p como autorizados salvo que Anthropic publique una nueva política.Para hosts de Gateway de larga duración, las claves de API de Anthropic siguen siendo la ruta de producción más clara y predecible.Documentación pública actual de Anthropic:

​
Primeros pasos

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

Obtén tu clave de API

Crea una clave de API en la Consola de Anthropic.
2

Ejecuta la incorporación

openclaw onboard
# choose: Anthropic API key
O pasa la clave directamente:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

Verifica que el modelo esté disponible

openclaw models list --provider anthropic

​
Ejemplo de configuración

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

​
Valores predeterminados de thinking (Claude 4.6)

Los modelos Claude 4.6 usan adaptive thinking de forma predeterminada en OpenClaw cuando no se establece ningún nivel de thinking explícito. Anúlalo por mensaje con /think:<level> o en los parámetros del modelo: 
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { thinking: "adaptive" },
        },
      },
    },
  },
}
Documentación relacionada de Anthropic:

​
Caché de prompts

OpenClaw admite la función de caché de prompts de Anthropic para autenticación con clave de API.
ValorDuración de cachéDescripción
"short" (predeterminado)5 minutosSe aplica automáticamente para autenticación con clave de API
"long"1 horaCaché extendida
"none"Sin cachéDesactiva la caché de prompts
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}
Usa parámetros a nivel de modelo como base y luego anula agentes específicos mediante 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:
  1. agents.defaults.models["provider/model"].params
  2. agents.list[].params (coincidencia por id, anula por clave)
Esto permite que un agente conserve una caché de larga duración mientras otro agente en el mismo modelo desactiva la caché para tráfico por ráfagas o de baja reutilización.
  • Los modelos Anthropic Claude 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" en runtime.
  • Los valores predeterminados inteligentes de clave de API también inicializan cacheRetention: "short" para referencias de Claude en Bedrock cuando no se establece un valor explícito.

​
Configuración avanzada

El interruptor compartido /fast de OpenClaw admite tráfico directo de Anthropic (clave de API y OAuth a api.anthropic.com).
ComandoSe asigna a
/fast onservice_tier: "auto"
/fast offservice_tier: "standard_only"
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}
  • Solo se inyecta para solicitudes directas a api.anthropic.com. Las rutas proxy dejan service_tier intacto.
  • 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.
El Plugin incluido de Anthropic registra 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.
PropiedadValor
Modelo predeterminadoclaude-opus-4-7
Entrada compatibleImágenes, documentos PDF
Cuando se adjunta una imagen o un PDF a una conversación, OpenClaw la enruta automáticamente mediante el proveedor de comprensión multimedia de Anthropic.
La ventana de contexto de 1M de Anthropic está limitada por beta. Actívala 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 modelos Opus y Sonnet aptos, lo que amplía la ventana de contexto en runtime para esas sesiones de CLI a fin de igualar el comportamiento de la API directa.
Requiere acceso a contexto largo en tu credencial de Anthropic. La autenticación heredada con token (sk-ant-oat-*) se rechaza para solicitudes de contexto de 1M: OpenClaw registra una advertencia y vuelve a la ventana de contexto estándar.
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

La autenticación con token de Anthropic caduca y puede revocarse. Para nuevas configuraciones, usa una clave de API de Anthropic en su lugar.
La autenticación de Anthropic es por agente: los agentes nuevos no heredan las claves del agente principal. Vuelve a ejecutar la incorporación para ese agente (o configura una clave de API en el host de Gateway), luego verifica con openclaw models status.
Ejecuta openclaw models status para ver qué perfil de autenticación está activo. Vuelve a ejecutar la incorporación o configura una clave de API para esa ruta de perfil.
Revisa openclaw models status --json para auth.unusableProfiles. Los enfriamientos por límite de tasa de Anthropic pueden estar acotados por modelo, por lo que un modelo Anthropic hermano aún podría ser utilizable. Añade otro perfil de Anthropic o espera a que termine el enfriamiento.
Más ayuda: Solución de problemas y Preguntas frecuentes.

​
Relacionado

Selección de modelos

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

Backends de CLI

Detalles de configuración y runtime del backend de Claude CLI.

Caché de prompts

Cómo funciona la caché de prompts entre proveedores.

OAuth y autenticación

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