Providers

Anthropic

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

Primeros pasos

Clave de API

Ideal para: acceso estándar a la API y facturación basada en 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

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

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

    Claude CLI

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

  • Asegúrate de que Claude CLI esté instalado y con sesión iniciada

    Verifica con:

    claude --version
    
  • Ejecuta la incorporación

    openclaw onboard
    # choose: Claude CLI
    

    OpenClaw detecta y reutiliza las credenciales existentes de Claude CLI.

  • Verifica que el modelo esté disponible

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

    Prefiere la referencia canónica del modelo de Anthropic más una anulación de runtime de CLI:

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

    Las referencias de modelo heredadas claude-cli/claude-opus-4-7 siguen funcionando 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 agentRuntime.id.

    Valores predeterminados de pensamiento (Claude 4.6)

    Los modelos Claude 4.6 usan de forma predeterminada el pensamiento adaptive en OpenClaw cuando no se define un nivel de pensamiento explícito.

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

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

    Caché de prompts

    OpenClaw admite la función de caché de prompts de Anthropic para autenticación con clave de API.

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

    Usa los parámetros de 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 (id coincidente, anula por clave)

    Esto permite que un agente mantenga una caché de larga duración mientras otro agente en el mismo modelo desactiva la caché para tráfico con picos y poca reutilización.

    Notas de Bedrock Claude
    • Los modelos Anthropic Claude en Bedrock (amazon-bedrock/*anthropic.claude*) aceptan el paso directo de cacheRetention cuando se configuran.
    • 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 define un valor explícito.

    Configuración avanzada

    Modo rápido

    El interruptor compartido /fast de OpenClaw admite tráfico directo de Anthropic (clave de API y OAuth a 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 Plugin de Anthropic incluido registra comprensión de imágenes y PDF. OpenClaw resuelve automáticamente las capacidades de medios a partir de la autenticación de Anthropic configurada; no se necesita configuración adicional.

    Propiedad Valor
    Modelo predeterminado 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á protegida por beta. Habilítala 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 elegibles, ampliando la ventana de contexto en runtime para esas sesiones de CLI a fin de igualar el comportamiento de la API directa.

    Contexto de 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 repentinamente inválido

    La autenticación con token de Anthropic caduca y puede revocarse. Para configuraciones nuevas, usa 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 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 Gateway) y luego verifica con openclaw models status.

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

    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.

    No hay ningún perfil de autenticación disponible (todos en enfriamiento)

    Revisa openclaw models status --json para auth.unusableProfiles. Los enfriamientos por límite de tasa de Anthropic pueden tener alcance de modelo, por lo que un modelo Anthropic relacionado aún podría ser utilizable. Agrega otro perfil de Anthropic o espera a que termine el enfriamiento.

    Relacionado