Anthropic

• 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)

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

​

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

​

Por que isso existe

​

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.

​

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

​

Cache de prompts

{
  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