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 um login existente do Claude Code no mesmo host

Rastreamento de uso e custos

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

• As 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 API Messages informados pelo provedor em Usage na Control UI, incluindo gastos diários, totais de tokens/cache, principais modelos 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. Trata-se da 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

openclaw models auth login --provider anthropic --method setup-token

{  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 descobre sessões não arquivadas do Claude Code no Gateway e nos hosts Node conectados:

• As sessões da 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, o horário da 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 sinalizador de arquivamento, portanto permanece visível enquanto sua transcrição estiver presente.

Nenhuma configuração adicional do OpenClaw é necessária para a descoberta. O plugin Anthropic está incluído e ativado por padrão; um Node nativo do macOS anuncia os comandos somente leitura de 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 agrupa as linhas pelo Gateway ou host de Node pareado correspondente, 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 de catálogo para adicionar a próxima página de cada host que tenha mais histórico; as linhas adicionadas permanecem visíveis e são buscadas novamente até a mesma profundidade durante as atualizações. Os clientes do catálogo usam sessions.catalog.list; a abertura de uma linha usa sessions.catalog.read.

A tomada de controle do terminal resolve claude pelo PATH do shell de login do usuário do host proprietário antes do PATH do serviço/daemon. Isso mantém as sessões iniciadas pelo aplicativo alinhadas com a Claude CLI que o operador obtém em um terminal normal.

Ao selecionar uma linha, a página mais recente da transcrição é lida primeiro. Carregar itens mais antigos da transcrição segue um cursor de bytes opaco 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 máximo de segurança do Node/Gateway é claramente marcado como truncado.

Para 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 da 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 intacta.

Um host Node sem interface gráfica também pode permitir a continuação de suas linhas da Claude CLI ativando a configuração local do Node abaixo e reiniciando o host Node:

{  nodeHost: {    agentRuns: {      claude: { enabled: true },    },  },}

O Node anuncia agent.cli.claude.run.v1 somente quando a configuração está ativada e seu executável local claude é resolvido. O OpenClaw resolve novamente o registro do catálogo nesse Node, importa o mesmo histórico limitado e vincula a sessão adotada ao Node e ao diretório de trabalho informado pelo catálogo. Cada turno executa o processo real claude -p do Node usando os arquivos e o login do Claude desse Node. A política de aprovação de execução do Node continua aplicável; o Gateway não pode forçar a adesão.

A continuação em Node v1 é somente de uso único. Ela omite a configuração MCP de loopback do Gateway e os argumentos do plugin de Skills do Gateway, não reinicializa a partir de uma transcrição do Gateway e rejeita anexos e imagens. As linhas do Claude Desktop permanecem somente para visualização. Nodes de aplicativos nativos do macOS também permanecem somente para visualização até que o aplicativo anuncie o comando de execuçã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 pensamento adaptativo com esforço high por padrão. Use /think off para desativar o pensamento ou /think xhigh|max para os níveis mais altos de esforço nativo do modelo. O OpenClaw omite orçamentos manuais de pensamento, parâmetros de amostragem personalizados, preenchimentos prévios do assistente e Priority Tier para o Sonnet 5 porque a Anthropic não oferece suporte a esses recursos de solicitação neste modelo. O catálogo usa os preços promocionais de entrada/saída $2/$10 da Anthropic até 31 de agosto de 2026; os preços padrão $3/$15 começam em 1º de setembro de 2026.

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

anthropic/claude-mythos-5 é um modelo de acesso limitado com o mesmo contrato de pensamento adaptativo sempre ativo. O OpenClaw adota 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, limite de saída de 128.000 tokens, entrada de imagens e preços de entrada/saída $10/$50.

O Claude Opus 4.8 mantém o pensamento desativado por padrão no OpenClaw. Quando o pensamento adaptativo é ativado explicitamente 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) adotam 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 para recusas 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 biológicas 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 instrui 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 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 permitido pela Anthropic para o Fable 5.
2. Somente uma recusa do classificador de segurança aciona o fallback. Limites de taxa, sobrecargas e erros do servidor se comportam exatamente como antes e passam pelo failover de modelo normal do OpenClaw.
3. O resgate ocorre 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 fluxo, o texto parcial é mantido como o prefixo a partir do qual o modelo de fallback continua, enquanto o raciocínio e as chamadas de ferramenta do modelo que recusou são descartados de acordo com as regras de repetição da Anthropic (eles não devem ser retornados 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 ocorre no nível da API da Anthropic, portanto claude-opus-4-8 não precisa estar na lista de modelos configurados nem na cadeia de fallback — uma chave de API compatível com o Fable sempre pode atender o Opus.

Observabilidade e cobrança

• Uma interação atendida por fallback registra um diagnóstico provider_fallback na mensagem do assistente, identificando 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 o resgate é cobrado pelas tarifas do Claude Opus 4.8 (atualmente metade das tarifas do Fable 5). A estimativa de custo por interação do OpenClaw aplica as tarifas do Opus às interações atendidas por fallback para corresponder.
• Uma recusa no meio do fluxo cobra adicionalmente, por parte da Anthropic, o conteúdo parcial do Fable já transmitido; essa parte é informada no uso por tentativa da API, mas não é incluída na 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 permanecem inalteradas e ainda apresentam as recusas como erros nesses casos.

Verificado ao vivo: um prompt benigno que pede ao Fable 5 para reproduzir sua cadeia de pensamento bruta é recusado com category: "reasoning_extraction" quando enviado sem fallbacks, e o mesmo prompt por meio do 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