​

Anthropic (Claude)

​

Opción A: API key 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 para Claude CLI

{
  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 de thinking explícito.
• Puedes sobrescribirlo 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"
• Valor predeterminado en la configuración:

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

• OpenClaw solo inyecta service tiers de Anthropic para solicitudes directas a api.anthropic.com. Si enrutas anthropic/* a través de un proxy o gateway, /fast deja service_tier intacto.
• Los parámetros explícitos del modelo serviceTier o service_tier de Anthropic tienen prioridad sobre 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 prompts (API de Anthropic)

​

Configuración

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

​

Valores predeterminados

​

Sobrescrituras de cacheRetention por agente

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" }, // baseline for most agents
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // override for this agent only
    ],
  },
}

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

​

Notas sobre Claude en Bedrock

• Los modelos Anthropic Claude en Bedrock (amazon-bedrock/*anthropic.claude*) aceptan el paso de cacheRetention cuando está configurado.
• Los modelos Bedrock que no son Anthropic se fuerzan a cacheRetention: "none" en runtime.
• Los valores inteligentes predeterminados de API key de Anthropic también establecen cacheRetention: "short" para referencias de modelos Claude-on-Bedrock cuando no hay un valor explícito.

​

Ventana de contexto de 1M (beta de Anthropic)

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

​

Opción B: Claude CLI como proveedor de mensajes

• claude-cli/claude-sonnet-4-6
• claude-cli/claude-opus-4-6

1. OpenClaw inicia claude -p --output-format stream-json --include-partial-messages ... en el host del gateway y envía el prompt por stdin.
2. El primer turno envía --session-id <uuid>.
3. Los turnos de seguimiento reutilizan la sesión almacenada de Claude mediante --resume <sessionId>.
4. Tus mensajes de chat siguen pasando por la canalización normal de mensajes de OpenClaw, pero la respuesta real del modelo la produce Claude CLI.

​

Requisitos

• Claude CLI instalado en el host del gateway y disponible en PATH, o configurado con una ruta absoluta al comando.
• Claude CLI ya autenticado en ese mismo host:

claude auth status

• OpenClaw carga automáticamente el plugin empaquetado de Anthropic al iniciar el gateway cuando tu configuración hace referencia explícita a claude-cli/... o a la configuración del backend claude-cli.

​

Fragmento de configuración

{
  agents: {
    defaults: {
      model: {
        primary: "claude-cli/claude-sonnet-4-6",
      },
      models: {
        "claude-cli/claude-sonnet-4-6": {},
      },
      sandbox: { mode: "off" },
    },
  },
}

{
  agents: {
    defaults: {
      cliBackends: {
        "claude-cli": {
          command: "/opt/homebrew/bin/claude",
        },
      },
    },
  },
}

​

Qué obtienes

• Reutilización de autenticación por suscripción de Claude desde la CLI local (se lee en runtime, no se persiste)
• Enrutamiento normal de mensajes/sesiones de OpenClaw
• Continuidad de sesión de Claude CLI entre turnos (se invalida con cambios de autenticación)
• Herramientas del gateway expuestas a Claude CLI mediante puente MCP loopback
• Streaming JSONL con progreso en vivo de mensajes parciales

​

Migrar de autenticación de Anthropic a Claude CLI

• Claude CLI instalado en el mismo host del gateway que ejecuta OpenClaw
• Claude CLI ya autenticado allí: claude auth login

openclaw models auth login --provider anthropic --method cli --set-default

openclaw onboard --auth-choice anthropic-cli

• verifica que Claude CLI ya haya iniciado sesión en el host del gateway
• cambia el modelo predeterminado a claude-cli/...
• reescribe respaldos de modelo predeterminados de Anthropic como anthropic/claude-opus-4-6 a claude-cli/claude-opus-4-6
• añade entradas claude-cli/... correspondientes a agents.defaults.models

openclaw models status

• eliminar tus perfiles de autenticación existentes de Anthropic
• eliminar todas las referencias antiguas anthropic/... de la configuración fuera de la ruta principal del modelo/lista de permitidos predeterminados

​

Límites importantes

• Esto no es el proveedor API de Anthropic. Es el runtime de la CLI local.
• OpenClaw no inyecta llamadas a herramientas directamente. Claude CLI recibe herramientas del gateway mediante un puente MCP loopback (bundleMcp: true, el valor predeterminado).
• Claude CLI transmite respuestas mediante JSONL (stream-json con --include-partial-messages). Los prompts se envían por stdin, no por argv.
• La autenticación se lee en runtime desde credenciales activas de Claude CLI y no se persiste en perfiles de OpenClaw. Los prompts de keychain se suprimen en contextos no interactivos.
• La reutilización de sesiones se sigue mediante metadatos cliSessionBinding. Cuando cambia el estado de inicio de sesión de Claude CLI (nuevo login, rotación de token), las sesiones almacenadas se invalidan y comienza una sesión nueva.
• Encaja mejor en un host de gateway personal, no en configuraciones compartidas de facturación multiusuario.

​

Notas

• La documentación pública de Claude Code de Anthropic sigue documentando el uso directo de la CLI como claude -p. Creemos que el respaldo local gestionado por el usuario probablemente está permitido, pero la notificación independiente de Anthropic a los usuarios de OpenClaw dice que la ruta de inicio de sesión de Claude de OpenClaw es uso de arnés de terceros y requiere Extra Usage (pago por uso facturado por separado de la suscripción). Para producción, recomendamos usar API keys de Anthropic.
• El setup-token de Anthropic vuelve a estar disponible en OpenClaw como ruta heredada/manual. La notificación de facturación específica de Anthropic para OpenClaw sigue aplicándose, así que úsalo esperando que Anthropic requiera Extra Usage para esta ruta.
• Los detalles de autenticación y las reglas de reutilización están en /concepts/oauth.

​

Resolución de problemas

• La autenticación heredada por token de Anthropic puede expirar o revocarse.
• Para una nueva configuración, migra a una API key de Anthropic o a la ruta local de Claude CLI en el host del gateway.

• La autenticación es por agente. Los agentes nuevos no heredan las claves del agente principal.
• Vuelve a ejecutar onboarding para ese agente, o configura una API key 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 onboarding o configura una API key o Claude CLI para esa ruta de perfil.

• Comprueba openclaw models status --json para ver auth.unusableProfiles.
• Los cooldowns por rate limit de Anthropic pueden depender del modelo, por lo que un modelo Anthropic hermano puede seguir siendo utilizable aunque el actual esté en cooldown.
• Añade otro perfil de Anthropic o espera a que termine el cooldown.