Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

A Anthropic cria a família de modelos Claude. O OpenClaw oferece suporte a 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 CLI no mesmo host
A equipe da Anthropic nos informou que o uso do Claude CLI no estilo do OpenClaw voltou a ser permitido, então o OpenClaw trata a reutilização do Claude CLI e o uso de claude -p como sancionados, a menos que a Anthropic publique uma nova política.Para hosts de Gateway de longa duração, as chaves de API da Anthropic ainda são o caminho de produção mais claro e mais previsível.Documentos públicos atuais da Anthropic:

​
Introdução

Ideal para: acesso padrão à API e cobrança baseada em uso.
1

Get your API key

Crie uma chave de API no Console da Anthropic.
2

Run onboarding

openclaw onboard
# choose: Anthropic API key
Ou passe a chave diretamente:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

Verify the model is available

openclaw models list --provider anthropic

​
Exemplo de configuração

{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

​
Padrões de raciocínio (Claude 4.6)

Modelos Claude 4.6 usam adaptive thinking por padrão no OpenClaw quando nenhum nível explícito de thinking é definido. Substitua por mensagem com /think:<level> ou nos parâmetros do modelo: 
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { thinking: "adaptive" },
        },
      },
    },
  },
}
Documentação relacionada da Anthropic:

​
Cache de prompt

O OpenClaw oferece suporte ao recurso de cache de prompt da Anthropic para autenticação por chave de API.
ValorDuração do cacheDescrição
"short" (padrão)5 minutosAplicado automaticamente para autenticação por chave de API
"long"1 horaCache estendido
"none"Sem cacheDesabilita o cache de prompt
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}
Use parâmetros no nível do modelo como base e depois substitua agentes específicos via agents.list[].params:
{
  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" } },
    ],
  },
}
Ordem de mesclagem da configuração:
  1. agents.defaults.models["provider/model"].params
  2. agents.list[].params (correspondente ao id, substitui por chave)
Isso permite que um agente mantenha um cache de longa duração enquanto outro agente no mesmo modelo desabilita o cache para tráfego em rajadas/de baixa reutilização.
  • Modelos Anthropic Claude no Bedrock (amazon-bedrock/*anthropic.claude*) aceitam repasse de cacheRetention quando configurado.
  • Modelos Bedrock que não são da Anthropic são forçados para cacheRetention: "none" em runtime.
  • Padrões inteligentes de chave de API também semeiam cacheRetention: "short" para referências Claude no Bedrock quando nenhum valor explícito é definido.

​
Configuração avançada

O alternador compartilhado /fast do OpenClaw oferece suporte a tráfego direto da Anthropic (chave de API e OAuth para api.anthropic.com).
ComandoMapeia para
/fast onservice_tier: "auto"
/fast offservice_tier: "standard_only"
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}
  • Injetado apenas para solicitações diretas a api.anthropic.com. Rotas de proxy deixam service_tier intocado.
  • Parâmetros explícitos serviceTier ou service_tier substituem /fast quando ambos são definidos.
  • Em contas sem capacidade do Priority Tier, service_tier: "auto" pode resolver para standard.
O Plugin Anthropic incluído registra compreensão de imagem e PDF. O OpenClaw resolve automaticamente as capacidades de mídia a partir da autenticação Anthropic configurada — nenhuma configuração adicional é necessária.
PropriedadeValor
Modelo padrãoclaude-opus-4-7
Entrada compatívelImagens, documentos PDF
Quando uma imagem ou PDF é anexado a uma conversa, o OpenClaw automaticamente o roteia pelo provedor de compreensão de mídia da Anthropic.
A janela de contexto de 1M da Anthropic é controlada por beta. Habilite por modelo:
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { context1m: true },
        },
      },
    },
  },
}
O OpenClaw mapeia isso para anthropic-beta: context-1m-2025-08-07 nas solicitações.params.context1m: true também se aplica ao backend Claude CLI (claude-cli/*) para modelos Opus e Sonnet elegíveis, expandindo a janela de contexto de runtime dessas sessões de CLI para corresponder ao comportamento da API direta.
Requer acesso a contexto longo na sua credencial Anthropic. Autenticação legada por token (sk-ant-oat-*) é rejeitada para solicitações de contexto de 1M — o OpenClaw registra um aviso e volta para a janela de contexto padrão.
anthropic/claude-opus-4.7 e sua variante claude-cli têm uma janela de contexto de 1M por padrão — sem necessidade de params.context1m: true.

​
Solução de problemas

A autenticação por token da Anthropic expira e pode ser revogada. Para novas configurações, use uma chave de API da Anthropic.
A autenticação Anthropic é por agente — novos agentes não herdam as chaves do agente principal. Execute o onboarding novamente para esse agente (ou configure uma chave de API no host do Gateway) e depois verifique com openclaw models status.
Execute openclaw models status para ver qual perfil de autenticação está ativo. Execute o onboarding novamente ou configure uma chave de API para esse caminho de perfil.
Verifique openclaw models status --json para auth.unusableProfiles. Cooldowns de limite de taxa da Anthropic podem ter escopo por modelo, então um modelo Anthropic irmão ainda pode ser utilizável. Adicione outro perfil Anthropic ou aguarde o cooldown.
Mais ajuda: Solução de problemas e FAQ.

​
Relacionado

Model selection

Escolha de provedores, referências de modelo e comportamento de failover.

CLI backends

Configuração do backend Claude CLI e detalhes de runtime.

Prompt caching

Como o cache de prompt funciona entre provedores.

OAuth and auth

Detalhes de autenticação e regras de reutilização de credenciais.