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:
agents.defaults.models["provider/model"].paramsagents.list[].params(idcoincidente, 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 decacheRetentioncuando 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
Elegir proveedores, referencias de modelo y comportamiento de conmutación por error.
Detalles de configuración y runtime del backend de Claude CLI.
Cómo funciona la caché de prompts entre proveedores.
Detalles de autenticación y reglas de reutilización de credenciales.