Anthropic (Claude)

Anthropic desarrolla la familia de modelos Claude y ofrece acceso a traves de una API. En OpenClaw puedes autenticarte con una clave API o un setup-token.

Opcion A: Clave API de Anthropic

Ideal para: acceso estandar a la API con facturacion por uso. Crea tu clave API en la consola de Anthropic.

Configuracion por CLI

openclaw onboard
# elige: Anthropic API key

# o de forma no interactiva
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

Fragmento de configuracion

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

Valores por defecto de pensamiento (Claude 4.6)

Los modelos Anthropic Claude 4.6 usan pensamiento adaptive por defecto en OpenClaw cuando no se establece un nivel explicito.
Puedes cambiarlo por mensaje (/think:<level>) o en los parametros del modelo: agents.defaults.models["anthropic/<model>"].params.thinking.
Documentacion relacionada de Anthropic:
- Adaptive thinking
- Extended thinking

Modo rapido (API de Anthropic)

El toggle compartido /fast de OpenClaw tambien es compatible con el trafico directo de claves API de Anthropic.

/fast on equivale a service_tier: "auto"
/fast off equivale a service_tier: "standard_only"
Valor por defecto en la configuracion:

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

Limites importantes:

Esto funciona solo con clave API. La autenticacion por setup-token / OAuth de Anthropic no respeta la inyeccion de tier del modo rapido de OpenClaw.
OpenClaw solo inyecta los tiers de servicio de Anthropic para solicitudes directas a api.anthropic.com. Si enrutas anthropic/* a traves de un proxy o gateway, /fast deja service_tier sin modificar.
Anthropic reporta el tier efectivo en la respuesta bajo usage.service_tier. En cuentas sin capacidad de Priority Tier, service_tier: "auto" puede resolverse como standard.

Cache de prompts (API de Anthropic)

OpenClaw soporta la funcion de cache de prompts de Anthropic. Esto es solo para la API; la autenticacion por suscripcion no respeta la configuracion de cache.

Configuracion

Usa el parametro cacheRetention en la configuracion de tu modelo:

Valor	Duracion del cache	Descripcion
`none`	Sin cache	Desactiva el cache de prompts
`short`	5 minutos	Valor por defecto para autenticacion con clave API
`long`	1 hora	Cache extendido (requiere flag beta)

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

Valores por defecto

Cuando usas autenticacion con clave API de Anthropic, OpenClaw aplica automaticamente cacheRetention: "short" (cache de 5 minutos) para todos los modelos de Anthropic. Puedes cambiar esto estableciendo cacheRetention de forma explicita en tu configuracion.

Sobreescrituras de cacheRetention por agente

Usa los parametros a nivel de modelo como base y luego sobreescribe agentes especificos con agents.list[].params.

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" }, // base para la mayoria de los agentes
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // sobreescritura solo para este agente
    ],
  },
}

Orden de fusion de la configuracion para parametros de cache:

agents.defaults.models["provider/model"].params
agents.list[].params (coincidencia por id, sobreescribe por clave)

Esto permite que un agente mantenga un cache de larga duracion mientras otro agente con el mismo modelo desactive el cache para evitar costos de escritura en trafico con alta variabilidad y baja reutilizacion.

Notas sobre Bedrock Claude

Los modelos Anthropic Claude en Bedrock (amazon-bedrock/*anthropic.claude*) aceptan el paso de cacheRetention cuando se configura.
Los modelos de Bedrock que no son de Anthropic se fuerzan a cacheRetention: "none" en tiempo de ejecucion.
Los valores por defecto inteligentes de la clave API de Anthropic tambien establecen cacheRetention: "short" para las referencias de modelos Claude-on-Bedrock cuando no se establece un valor explicito.

Parametro heredado

El parametro anterior cacheControlTtl aun se soporta por compatibilidad:

"5m" equivale a short
"1h" equivale a long

Recomendamos migrar al nuevo parametro cacheRetention.

OpenClaw incluye el flag beta extended-cache-ttl-2025-04-11 para las solicitudes a la API de Anthropic; mantenlo si sobreescribes los headers del proveedor (consulta /gateway/configuration).

Ventana de contexto de 1M (beta de Anthropic)

La ventana de contexto de 1M de Anthropic esta restringida por una flag beta. En OpenClaw, activala por modelo con params.context1m: true para los modelos Opus/Sonnet compatibles.

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

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

Esto solo se activa cuando params.context1m se establece explicitamente como true para ese modelo.

Requisito: Anthropic debe permitir el uso de contexto largo en esa credencial (normalmente facturacion por clave API, o una cuenta de suscripcion con Extra Usage activado). De lo contrario, Anthropic devuelve: HTTP 429: rate_limit_error: Extra usage is required for long context requests.

Nota: Anthropic actualmente rechaza las solicitudes beta de context-1m-* cuando se usan tokens OAuth/suscripcion (sk-ant-oat-*). OpenClaw omite automaticamente el header beta de context1m para la autenticacion OAuth y mantiene los betas requeridos para OAuth.

Opcion B: Setup-token de Claude

Ideal para: usar tu suscripcion de Claude.

Donde obtener un setup-token

Los setup-tokens se crean con el CLI de Claude Code, no con la consola de Anthropic. Puedes ejecutar esto en cualquier maquina:

claude setup-token

Pega el token en OpenClaw (asistente: Anthropic token (paste setup-token)), o ejecutalo en el host del gateway:

openclaw models auth setup-token --provider anthropic

Si generaste el token en otra maquina, pegalo:

openclaw models auth paste-token --provider anthropic

Configuracion por CLI (setup-token)

# Pega un setup-token durante el onboarding
openclaw onboard --auth-choice setup-token

Fragmento de configuracion (setup-token)

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

Notas

Genera el setup-token con claude setup-token y pegalo, o ejecuta openclaw models auth setup-token en el host del gateway.
Si ves “OAuth token refresh failed …” en una suscripcion de Claude, vuelve a autenticarte con un setup-token. Consulta /gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription.
Los detalles de autenticacion y reglas de reutilizacion estan en /concepts/oauth.

Solucion de problemas

Errores 401 / token invalido de repente

La autenticacion de suscripcion de Claude puede expirar o ser revocada. Vuelve a ejecutar claude setup-token y pegalo en el host del gateway.
Si el login del CLI de Claude esta en otra maquina, usa openclaw models auth paste-token --provider anthropic en el host del gateway.

No API key found for provider “anthropic”

La autenticacion es por agente. Los agentes nuevos no heredan las claves del agente principal.
Vuelve a ejecutar el onboarding para ese agente, o pega un setup-token / clave API en el host del gateway, y luego verifica con openclaw models status.

No credentials found for profile anthropic:default

Ejecuta openclaw models status para ver que perfil de autenticacion esta activo.
Vuelve a ejecutar el onboarding, o pega un setup-token / clave API para ese perfil.

No available auth profile (all in cooldown/unavailable)

Revisa openclaw models status --json en busca de auth.unusableProfiles.
Agrega otro perfil de Anthropic o espera a que termine el cooldown.

Mas informacion: /gateway/troubleshooting y /help/faq.