Anthropic

A Anthropic cria a família de modelos Claude. O OpenClaw é compatível com duas rotas de autenticação:

• Chave de API — acesso direto à API da Anthropic com cobrança baseada em uso (modelos anthropic/*)
• Claude CLI — reutilize um login existente do Claude Code no mesmo host

Primeiros passos

openclaw onboard# choose: Anthropic API key

openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

openclaw models list --provider anthropic

{  env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" },  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },}

claude --version

openclaw onboard# choose: Claude CLI

openclaw models list --provider anthropic

{  agents: {    defaults: {      model: { primary: "anthropic/claude-opus-4-8" },      models: {        "anthropic/claude-opus-4-8": {          agentRuntime: { id: "claude-cli" },        },      },    },  },}

Padrões de raciocínio (Claude Fable 5, 4.8 e 4.6)

anthropic/claude-fable-5 sempre usa raciocínio adaptativo e o padrão é esforço high. Como a Anthropic não permite desativar o raciocínio para este modelo, /think off e /think minimal usam esforço low. O OpenClaw também omite valores de temperatura personalizados para solicitações do Fable 5.

O Claude Opus 4.8 mantém o raciocínio desativado por padrão no OpenClaw. Quando você ativa explicitamente o raciocínio adaptativo com /think high|xhigh|max, o OpenClaw envia os valores de esforço do Opus 4.8 da Anthropic; modelos Claude 4.6 usam adaptive por padrão.

Substitua por mensagem com /think:<level> ou nos parâmetros do modelo:

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-8": {          params: { thinking: "high" },        },      },    },  },}

Fallback de recusa de segurança (Claude Fable 5)

Por que isso existe

Os classificadores do Fable 5 retornam stop_reason: "refusal" em solicitações em domínios restritos, e também geram falsos positivos em trabalhos benignos adjacentes (ferramentas de segurança, ciências biológicas ou até pedir ao modelo para reproduzir seu raciocínio bruto). Sem um fallback, o turno termina com erro mesmo que outro modelo Claude pudesse atendê-lo sem problemas — a própria mensagem de recusa da Anthropic informa aos integradores de API que configurem um modelo de fallback.

Como funciona

1. Para cada solicitação direta com chave de API para anthropic/claude-fable-5, o OpenClaw envia a adesão ao fallback do lado do servidor da Anthropic: o cabeçalho beta server-side-fallback-2026-06-01 mais fallbacks: [{"model": "claude-opus-4-8"}]. O Claude Opus 4.8 é o único destino de fallback que a Anthropic permite para o Fable 5.
2. Apenas uma recusa do classificador de segurança aciona o fallback. Limites de taxa, sobrecargas e erros de servidor se comportam exatamente como antes e passam pelo failover de modelo normal do OpenClaw.
3. O resgate acontece dentro da mesma chamada. Uma recusa antes de qualquer saída é invisível, exceto pela latência; a resposta inteira vem do Opus 4.8. Em uma recusa no meio do stream, o texto parcial é mantido como o prefixo a partir do qual o modelo de fallback continua, enquanto o raciocínio e as chamadas de ferramentas do modelo recusado são descartados conforme as regras de replay da Anthropic (eles não devem ser ecoados de volta nem executados).
4. Se o Claude Opus 4.8 também recusar, o turno expõe a recusa como um erro, exatamente como antes deste recurso.

O fallback acontece no nível da API da Anthropic, portanto claude-opus-4-8 não precisa estar na sua lista de modelos configurada ou na cadeia de fallback — uma chave de API capaz de usar o Fable sempre pode atender Opus.

Observabilidade e cobrança

• Um turno atendido por fallback registra um diagnóstico provider_fallback na mensagem do assistente nomeando fromModel e toModel, e o responseModel da mensagem relata claude-opus-4-8.
• A Anthropic cobra por tentativa: uma recusa antes da saída é gratuita, e o resgate é cobrado às taxas do Claude Opus 4.8 (atualmente metade das taxas do Fable 5). A estimativa de custo por turno do OpenClaw precifica turnos atendidos por fallback às taxas do Opus para corresponder.
• Uma recusa no meio do stream também cobra o parcial do Fable já transmitido no lado da Anthropic; essa parte é relatada no uso por tentativa da API, mas não é incorporada à estimativa por turno do OpenClaw.

Escopo

Aplica-se a anthropic/claude-fable-5 com autenticação por chave de API contra api.anthropic.com. OAuth (reutilização de assinatura da Claude CLI), URLs base de proxy, solicitações Bedrock, Vertex e Foundry não mudam e ainda expõem recusas como erros ali.

Verificado ao vivo: um prompt benigno pedindo ao Fable 5 para reproduzir sua cadeia de pensamento bruta é recusado com category: "reasoning_extraction" quando enviado sem fallbacks, e o mesmo prompt pelo OpenClaw retorna uma resposta normal atendida pelo Opus com o diagnóstico provider_fallback anexado.

Veja o guia de recusas e fallback da Anthropic para o comportamento subjacente.

Cache de prompts

O OpenClaw é compatível com o recurso de cache de prompts da Anthropic para autenticação por chave de API.

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

{  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" } },    ],  },}

Configuração avançada

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

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

Solução de problemas

Relacionados