​

Anthropic (Claude)

​

Opción A: clave API de Anthropic

​

Configuración por CLI

openclaw onboard
# choose: Anthropic API key

# or non-interactive
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

​

Fragmento de configuración de Anthropic

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

​

Valores predeterminados de thinking (Claude 4.6)

• Los modelos Anthropic Claude 4.6 usan adaptive thinking de forma predeterminada en OpenClaw cuando no se establece un nivel explícito de thinking.
• Puedes anularlo por mensaje (/think:<level>) o en los parámetros del modelo: agents.defaults.models["anthropic/<model>"].params.thinking.
• Documentación relacionada de Anthropic:
  • Adaptive thinking
  • Extended thinking

​

Modo rápido (API de Anthropic)

• /fast on se asigna a service_tier: "auto"
• /fast off se asigna a service_tier: "standard_only"
• Configuración predeterminada:

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

• OpenClaw solo inyecta niveles de servicio de Anthropic para solicitudes directas a api.anthropic.com. Si enrutas anthropic/* a través de un proxy o gateway, /fast deja service_tier sin cambios.
• Los parámetros explícitos del modelo serviceTier o service_tier de Anthropic anulan el valor predeterminado de /fast cuando ambos están establecidos.
• Anthropic informa el nivel efectivo en la respuesta bajo usage.service_tier. En cuentas sin capacidad de Priority Tier, service_tier: "auto" puede seguir resolviéndose como standard.

​

Caché de prompt (API de Anthropic)

​

Configuración

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

​

Valores predeterminados

​

Anulaciones de cacheRetention por agente

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

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

​

Notas sobre Bedrock Claude

• Los modelos Anthropic Claude en Bedrock (amazon-bedrock/*anthropic.claude*) aceptan el paso directo de cacheRetention cuando está configurado.
• En tiempo de ejecución, los modelos de Bedrock que no son de Anthropic se fuerzan a cacheRetention: "none".
• Los valores predeterminados inteligentes de clave API de Anthropic también inicializan cacheRetention: "short" para referencias de modelos Claude-on-Bedrock cuando no se establece ningún valor explícito.

​

Ventana de contexto de 1M (beta de Anthropic)

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

​

Backend de Claude CLI

• El personal de Anthropic nos dijo que este uso vuelve a estar permitido.
• Por lo tanto, OpenClaw considera la reutilización de Claude CLI y el uso de claude -p como autorizados para esta integración, a menos que Anthropic publique una nueva política.
• Las claves API de Anthropic siguen siendo la ruta de producción más clara para hosts de gateway siempre activos y para un control explícito de la facturación del lado del servidor.
• Los detalles de configuración y tiempo de ejecución están en /gateway/cli-backends.

​

Notas

• La documentación pública de Claude Code de Anthropic sigue documentando el uso directo de CLI como claude -p, y el personal de Anthropic nos dijo que el uso de Claude CLI al estilo de OpenClaw vuelve a estar permitido. Estamos considerando esta orientación como establecida salvo que Anthropic publique un nuevo cambio de política.
• El setup-token de Anthropic sigue disponible en OpenClaw como una ruta compatible de autenticación por token, pero OpenClaw ahora prefiere la reutilización de Claude CLI y claude -p cuando están disponibles.
• Los detalles de autenticación y las reglas de reutilización están en /concepts/oauth.

​

Solución de problemas

• La autenticación por token de Anthropic puede caducar o ser revocada.
• Para una configuración nueva, migra a una clave API de Anthropic.

• La autenticación 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 API en el host del gateway y 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 API para esa ruta de perfil.

• Comprueba openclaw models status --json para ver auth.unusableProfiles.
• Los periodos de espera por límite de tasa de Anthropic pueden limitarse por modelo, por lo que otro modelo Anthropic relacionado puede seguir siendo utilizable aunque el actual esté en enfriamiento.
• Añade otro perfil de Anthropic o espera a que termine el enfriamiento.