Anthropic
Usar Anthropic Claude en OpenClaw: soporta claves API o auth setup-token.
Anthropic construye la familia de modelos Claude y proporciona acceso via API. En OpenClaw, puedes autenticarte con una Clave API o setup-token.
Opción A: Clave API de Anthropic
Mejor para: Acceso API estándar y facturación de pago por uso.
Crea una Clave API en la Consola de Anthropic.
#
Configuración CLI
openclaw onboard openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
#
Fragmento de Config
{
env: { ANTHROPIC_API_KEY: "sk-ant-..." },
agents: { defaults: { model: { primary: "anthropic/claude-opus-4-5" } } },
}Caché de prompts (API Anthropic)
OpenClaw soporta la característica de caché de prompts de Anthropic. Nota: esta característica solo funciona con auth de Clave API; la auth de suscripción no aplica configuración de caché.
#
Configuración
Usa el parámetro ''cacheRetention'' en tu config de modelo:
| Valor | Duración de caché | Descripción |
| -- | ---- |
| ''none'' | Sin caché | Deshabilitar caché de prompts |
| ''short'' | 5 minutos | Predeterminado para auth de Clave API |
| ''long'' | 1 hora | Caché extendido (requiere flag beta) |
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-5": {
params: { cacheRetention: "long" },
},
},
},
},
}#
Comportamiento Predeterminado
Cuando usas auth de Clave API de Anthropic, OpenClaw aplica automáticamente ''cacheRetention: "short"'' (caché de 5 minutos) a todos los modelos Anthropic. Puedes establecer explícitamente ''cacheRetention'' en tu config para anular.
#
Parámetros Legacy (Compatibilidad)
El parámetro legacy ''cacheControlTtl'' todavía se preserva para compatibilidad con configs históricos:
- ''"5m"'' mapea a ''short''
- ''"1h"'' mapea a ''long''
Se recomienda migrar al nuevo parámetro ''cacheRetention''.
OpenClaw incluye el flag beta ''extended-cache-ttl-2025-04-11'' en solicitudes de API Anthropic; si anulas headers de proveedor, por favor preserva este flag (ver ''/gateway/configuration'').
Opción B: setup-token de Claude
Mejor para: Usar tu suscripción Claude.
#
Cómo obtener un setup-token
El setup-token es generado por el CLI de Claude Code, no creado en la Consola de Anthropic. Puedes ejecutar esto en cualquier máquina:
claude setup-token
Pega el token en OpenClaw (asistente: Token Anthropic (pegar setup-token)), o ejecuta en el host del gateway:
openclaw models auth setup-token --provider anthropic
Si el token fue generado en una máquina diferente, pégalo en el host del gateway:
openclaw models auth paste-token --provider anthropic
#
Configuración CLI
openclaw onboard --auth-choice setup-token
#
Fragmento de Config
{
agents: { defaults: { model: { primary: "anthropic/claude-opus-4-5" } } },
}Notas
- Genera y pega con ''claude setup-token'', o ejecuta ''openclaw models auth setup-token'' en el host del gateway.
- Si ves "OAuth token refresh failed …" en tu suscripción Claude, re-autentica con setup-token. Ver ''/gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription''.
- Ver ''/concepts/oauth'' para detalles de auth y reglas de reuso.
Solución de Problemas
401 / token súbitamente inválido
- La auth de suscripción Claude puede haber expirado o sido revocada. Re-ejecuta ''claude setup-token'' y pega en el ''host del gateway''.
- Si el login del CLI de Claude está en una máquina diferente, usa ''openclaw models auth paste-token --provider anthropic'' en el host del gateway.
No se encontró clave API para proveedor "anthropic"
- La auth se almacena por agente. Los nuevos agentes no heredan la clave del agente primario.
- Re-ejecuta onboarding para ese agente, o pega setup-token / clave API en el host del gateway, luego verifica con ''openclaw models status''.
''No se encontraron credenciales para perfil ''anthropic:default''''
- Ejecuta ''openclaw models status'' para ver el perfil de auth actualmente en uso.
- Re-ejecuta onboarding, o pega setup-token / clave API para ese perfil.
Ningún perfil de auth disponible (todos en cooldown/no disponible)
- Ejecuta ''openclaw models status --json'' para ver ''auth.unusableProfiles''.
- Añade otro perfil Anthropic o espera a que termine el cooldown.
Más: ''/gateway/troubleshooting'' & ''/help/faq''.