- 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_KEYouANTHROPIC_ADMIN_API_KEYmostra 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.
Primeiros passos
- Chave de API
- Claude CLI
Ideal para: acesso padrão à API e cobrança baseada no uso.Ou forneça a chave diretamente:
1
Obtenha sua chave de API
Crie uma chave de API no Console da Anthropic.
2
Execute a integração inicial
3
Verifique se o modelo está disponível
Exemplo de configuração
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-clique 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.
~/.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:
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.
As sessões do Claude em Nodes pareados permanecem somente leitura, a menos que o Node sem interface gráfica anuncie explicitamente
agent.cli.claude.run.v1. O OpenClaw nunca modifica os metadados do Claude Desktop
nem arquiva sessões do Claude. A página requer uma conexão de operador
com escopo de gravação porque usa node.invoke autenticado; a listagem e a leitura
permanecem somente leitura mesmo em um Node com continuação ativada.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:
Documentação relacionada da Anthropic:
Fallback para recusas de segurança (Claude Fable 5)
Por que isso existe
Os classificadores do Fable 5 retornamstop_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
- 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 betaserver-side-fallback-2026-06-01maisfallbacks: [{"model": "claude-opus-4-8"}]. O Claude Opus 4.8 é o único destino de fallback permitido pela Anthropic para o Fable 5. - 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.
- 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).
- Se o Claude Opus 4.8 também recusar, a interação apresenta a recusa como um erro, exatamente como antes deste recurso.
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_fallbackna mensagem do assistente, identificandofromModeletoModel, e oresponseModelda mensagem informaclaude-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 aanthropic/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.Substituições de cache por agente
Substituições de cache por agente
Use os parâmetros no nível do modelo como referência e substitua-os para agentes específicos por meio de Ordem de mesclagem da configuração:
agents.list[].params:agents.defaults.models["provider/model"].paramsagents.list[].params(correspondente aid, substitui por chave)
Observações sobre o Claude no Bedrock
Observações sobre o Claude no Bedrock
- Os modelos Anthropic Claude no Bedrock (
amazon-bedrock/*anthropic.claude*) aceitam o repasse decacheRetentionquando configurado. - Modelos Bedrock que não são da Anthropic são forçados a
cacheRetention: "none"em tempo de execução. - Os padrões inteligentes da chave de API também preenchem
cacheRetention: "short"para referências do Claude no Bedrock quando nenhum valor explícito é definido.
Configuração avançada
Modo rápido
Modo rápido
A opção compartilhada
/fast do OpenClaw define o campo service_tier da Anthropic como api.anthropic.com para tráfego direto com chave de API.- Aplica-se somente a solicitações diretas de
api.anthropic.comfeitas com uma chave de API. Solicitações com OAuth/token de assinatura e rotas de proxy nunca recebem um camposervice_tier. - Os parâmetros explícitos
serviceTierouservice_tiersubstituem/fastquando ambos estão definidos. - Em contas sem capacidade do Priority Tier,
service_tier: "auto"pode ser resolvido comostandard.
Compreensão de mídia (imagem e PDF)
Compreensão de mídia (imagem e PDF)
O Plugin Anthropic incluído registra a compreensão de imagens e PDFs. O OpenClaw
resolve automaticamente os recursos de mídia com base na autenticação Anthropic configurada; nenhuma
configuração adicional é necessária.
Quando uma imagem ou um PDF é anexado a uma conversa, o OpenClaw automaticamente
o encaminha pelo provedor de compreensão de mídia da Anthropic.
Janela de contexto de 1M
Janela de contexto de 1M
Claude Sonnet 5, Mythos 5 e Fable 5 têm uma janela de entrada exata de
1.000.000 tokens e são compatíveis com até 128.000 tokens de saída. A janela de
contexto de 1M da Anthropic também está disponível de forma geral nos modelos Claude 4.x com raciocínio adaptativo: Opus 4.8,
Opus 4.7, Opus 4.6 e Sonnet 4.6. O OpenClaw dimensiona esses modelos
automaticamente, sem necessidade de Configurações mais antigas podem manter
params.context1m:params.context1m: true; ele é uma operação inócua sem efeito para
esses modelos, e o OpenClaw não envia mais o cabeçalho beta descontinuado
context-1m-2025-08-07, independentemente disso. Entradas de configuração anthropicBeta mais antigas
com esse valor são descartadas durante a resolução dos cabeçalhos da solicitação, e
modelos Claude mais antigos sem compatibilidade permanecem em sua janela de contexto normal.params.context1m: true funciona da mesma forma para o backend da CLI do Claude
(claude-cli/*): modelos Opus e Sonnet qualificados e com disponibilidade geral já recebem
automaticamente a janela de 1M, portanto o parâmetro também é opcional nesse caso.Contexto de 1M do Claude Opus 4.8
Contexto de 1M do Claude Opus 4.8
anthropic/claude-opus-4-8 e sua variante claude-cli têm uma janela de contexto
de 1M por padrão; não é necessário params.context1m: true.Solução de problemas
Erros 401/token repentinamente inválido
Erros 401/token repentinamente inválido
A autenticação por token da Anthropic expira e pode ser revogada. Para novas configurações, use uma chave de API da Anthropic.
Nenhuma chave de API encontrada para o provedor "anthropic"
Nenhuma chave de API encontrada para o provedor "anthropic"
A autenticação da Anthropic é por agente; novos agentes não herdam as chaves do agente principal. Execute novamente a integração para esse agente (ou configure uma chave de API no host do Gateway) e verifique com
openclaw models status.Nenhuma credencial encontrada para o perfil "anthropic:default"
Nenhuma credencial encontrada para o perfil "anthropic:default"
Execute
openclaw models status para ver qual perfil de autenticação está ativo. Execute novamente a integração ou configure uma chave de API para o caminho desse perfil.Nenhum perfil de autenticação disponível (todos em espera)
Nenhum perfil de autenticação disponível (todos em espera)
Verifique
openclaw models status --json para auth.unusableProfiles. Os períodos de espera por limite de taxa da Anthropic podem ser específicos do modelo, portanto, outro modelo da Anthropic ainda pode estar disponível. Adicione outro perfil da Anthropic ou aguarde o fim do período de espera.Mais ajuda: Solução de problemas e Perguntas frequentes.
Relacionados
Seleção de modelos
Como escolher provedores, referências de modelos e o comportamento de failover.
Backends de CLI
Configuração do backend da CLI do Claude e detalhes de execução.
Cache de prompts
Como o cache de prompts funciona entre os provedores.
OAuth e autenticação
Detalhes de autenticação e regras de reutilização de credenciais.