Anthropic

A Anthropic desenvolve a família de modelos Claude. O OpenClaw oferece suporte a duas formas de autenticação:

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

Acompanhamento de uso e custos

O OpenClaw detecta a credencial disponível da Anthropic e seleciona a interface de uso correspondente:

• Credenciais de assinatura/configuração do Claude mostram janelas de cota e um orçamento opcional para uso adicional.
• ANTHROPIC_ADMIN_KEY ou ANTHROPIC_ADMIN_API_KEY mostra 30 dias de custos da organização e uso da Messages API informados pelo provedor em Usage na Control UI, incluindo gastos diários, totais de tokens/cache, modelos mais usados e categorias de custos.
• Uma credencial sk-ant-admin... armazenada no perfil do provedor Anthropic é detectada automaticamente como uma chave da Admin API.

O histórico de custos da Admin API vem da API de uso e custos da Anthropic. Ele representa a cobrança real do provedor, separada do custo estimado pelo OpenClaw com base nas sessões.

Primeiros passos

openclaw onboard# escolha: chave de API da Anthropic

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# escolha: 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" },        },      },    },  },}

Sessões do Claude entre computadores

O Plugin Anthropic incluído adiciona um grupo Claude Code à barra lateral normal de sessões. As linhas são abertas no painel normal de Chat. Ele encontra sessões não arquivadas do Claude Code no Gateway e nos hosts de Node conectados:

• As sessões do Claude CLI vêm de registros válidos do índice de projetos e de arquivos JSONL atuais cujo prefixo limitado de metadados identifica uma sessão sdk-cli que não seja sidechain em ~/.claude/projects/.
• As sessões do Claude Desktop usam o título do Desktop, a hora de atividade e o estado de arquivamento quando os metadados apontam para o mesmo ID de sessão do Claude Code.
• Uma sessão exclusiva da CLI não tem indicador de arquivamento, portanto, permanece visível enquanto sua transcrição estiver presente.

Nenhuma configuração adicional do OpenClaw é necessária. O Plugin Anthropic está incluído e ativado por padrão; um Node nativo do macOS anuncia os comandos somente leitura das sessões do Claude quando o diretório local ~/.claude/projects/ existe. Aprove a atualização do pareamento do Node quando esses comandos aparecerem pela primeira vez.

A barra lateral começa com a página limitada mais recente de cada host e é atualizada na cadência normal de 30 segundos. Use Carregar mais sessões abaixo de um grupo do catálogo para anexar a próxima página de cada host que tenha mais histórico; as linhas anexadas permanecem visíveis e são buscadas novamente até a mesma profundidade a cada atualização. Os clientes do catálogo usam sessions.catalog.list; abrir uma linha usa sessions.catalog.read.

A seleção de uma linha lê primeiro a página mais recente da transcrição. Carregar itens mais antigos da transcrição segue um cursor opaco de bytes e lê outra seção limitada do arquivo JSONL, em vez de carregar todo o histórico. O conteúdo normal de usuário, assistente, raciocínio, chamada de ferramenta e resultado de ferramenta é preservado. Um item individual maior que o limite de segurança do Node/Gateway é claramente marcado como truncado.

Em uma linha claude-cli local do Gateway, digitar no compositor normal chama sessions.catalog.continue. O OpenClaw resolve novamente o registro local do catálogo, cria ou reutiliza uma sessão nativa vinculada ao modelo, importa no máximo 200 itens visíveis ou 512 KiB e inicializa a vinculação do Claude CLI. O primeiro turno é retomado com --fork-session; o Claude atribui um novo ID de sessão à bifurcação, portanto os turnos posteriores usam a bifurcação e a sessão de origem permanece inalterada. As linhas do Claude Desktop e de Nodes pareados são somente para visualização.

Consulte Nodes: sessões e transcrições do Claude para conhecer o comando do Node e o limite de segurança.

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

anthropic/claude-sonnet-5 usa raciocínio adaptativo com esforço high por padrão. Use /think off para desativar o raciocínio ou /think xhigh|max para usar os níveis nativos de esforço mais altos do modelo. O OpenClaw omite orçamentos manuais de raciocínio, parâmetros personalizados de amostragem, prefixos de resposta do assistente e Priority Tier para o Sonnet 5 porque a Anthropic não oferece suporte a esses recursos de solicitação nesse modelo. O catálogo usa o preço introdutório da Anthropic de $2/$10 para entrada/saída até 31 de agosto de 2026; o preço padrão de $3/$15 começa em 1º de setembro de 2026.

anthropic/claude-fable-5 sempre usa raciocínio adaptativo e adota high como esforço padrão. A Anthropic não permite desativar o raciocínio nesse modelo, portanto /think off e /think minimal são mapeados para o esforço low. O OpenClaw também omite valores personalizados de temperatura nas solicitações do Fable 5, pois a Anthropic rejeita a substituição da temperatura em qualquer solicitação com raciocínio ativado.

anthropic/claude-mythos-5 é um modelo de acesso limitado com o mesmo contrato de raciocínio adaptativo sempre ativo. O OpenClaw usa high por padrão, mapeia /think off e /think minimal para low e omite parâmetros de amostragem selecionados pelo chamador. O catálogo publica sua janela de contexto de 1.000.000 tokens, o limite de saída de 128.000 tokens, a entrada de imagens e o preço de entrada/saída de $10/$50.

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; os modelos Claude 4.6 (Opus 4.6 e Sonnet 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" },        },      },    },  },}

Alternativa em caso de recusa de segurança (Claude Fable 5)

Por que isso existe

Os classificadores do Fable 5 retornam stop_reason: "refusal" em solicitações de domínios restritos e também geram falsos positivos em trabalhos benignos relacionados (ferramentas de segurança, ciências da vida ou até mesmo ao pedir que o modelo reproduza seu raciocínio bruto). Sem um fallback, a interação termina com um erro, embora outro modelo Claude pudesse atendê-la sem problemas — a própria mensagem de recusa da Anthropic orienta os integradores da API a configurar 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 no 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. Somente uma recusa do classificador de segurança aciona o fallback. Limites de taxa, sobrecargas e erros do servidor mantêm exatamente o comportamento anterior e passam pelo failover de modelo normal do OpenClaw.
3. A recuperação acontece dentro da mesma chamada. Uma recusa antes de qualquer saída é imperceptível, exceto pela latência; toda a resposta vem do Opus 4.8. Em uma recusa no meio do streaming, 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 que recusou são descartados de acordo com as regras de repetição da Anthropic (eles não podem ser reenviados nem executados).
4. Se o Claude Opus 4.8 também recusar, a interação apresenta 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 configurados nem na cadeia de fallback — uma chave de API compatível com o Fable sempre pode atender solicitações com o Opus.

Observabilidade e cobrança

• Uma interação atendida por fallback registra um diagnóstico provider_fallback na mensagem do assistente, indicando fromModel e toModel, e o responseModel da mensagem informa claude-opus-4-8.
• A Anthropic cobra por tentativa: uma recusa antes da saída é gratuita, e a recuperação é cobrada pelas tarifas do Claude Opus 4.8 (atualmente metade das tarifas do Fable 5). A estimativa de custo por interação do OpenClaw calcula as interações atendidas por fallback pelas tarifas do Opus para corresponder.
• Uma recusa no meio do streaming também gera cobrança pelo conteúdo parcial do Fable já transmitido no lado da Anthropic; essa parte é informada no uso por tentativa da API, mas não é incorporada à estimativa por interação do OpenClaw.

Escopo

Aplica-se a anthropic/claude-fable-5 com autenticação por chave de API em api.anthropic.com. OAuth (reutilização da assinatura do Claude CLI), URLs-base de proxy, solicitações do Bedrock, Vertex e Foundry não são alteradas e continuam apresentando recusas como erros nesses ambientes.

Verificado em produção: um prompt benigno que pede ao Fable 5 para reproduzir sua cadeia de raciocínio 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.

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

Cache de prompts

O OpenClaw oferece suporte ao 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-sonnet-5": {},        "anthropic/claude-mythos-5": {},        "anthropic/claude-opus-4-6": {},      },    },  },}

Solução de problemas

Relacionados