​

Anthropic (Claude)

​

Opção A: chave de API da Anthropic

​

Configuração pela CLI

openclaw onboard
# choose: Anthropic API key

# or non-interactive
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

​

Snippet de configuração da Anthropic

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

​

Padrões de thinking (Claude 4.6)

• Os modelos Anthropic Claude 4.6 usam adaptive thinking por padrão no OpenClaw quando nenhum nível explícito de thinking é definido.
• Você pode substituir por mensagem (/think:<level>) ou em params do modelo: agents.defaults.models["anthropic/<model>"].params.thinking.
• Documentação relacionada da Anthropic:
  • Adaptive thinking
  • Extended thinking

​

Modo rápido (API Anthropic)

• /fast on mapeia para service_tier: "auto"
• /fast off mapeia para service_tier: "standard_only"
• Padrão de configuração:

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}

• O OpenClaw só injeta service tiers da Anthropic para solicitações diretas a api.anthropic.com. Se você rotear anthropic/* por um proxy ou gateway, /fast deixa service_tier inalterado.
• Params explícitos de modelo Anthropic serviceTier ou service_tier substituem o padrão de /fast quando ambos estão definidos.
• A Anthropic informa o tier efetivo na resposta em usage.service_tier. Em contas sem capacidade de Priority Tier, service_tier: "auto" ainda pode resultar em standard.

​

Cache de prompt (API Anthropic)

​

Configuração

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}

​

Padrões

​

Substituições de cacheRetention por agente

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" }, // baseline for most agents
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // override for this agent only
    ],
  },
}

1. agents.defaults.models["provider/model"].params
2. agents.list[].params (correspondente ao id, substitui por chave)

​

Observações sobre Claude no Bedrock

• Modelos Anthropic Claude no Bedrock (amazon-bedrock/*anthropic.claude*) aceitam pass-through de cacheRetention quando configurado.
• Modelos Bedrock que não são Anthropic são forçados a cacheRetention: "none" em runtime.
• Os padrões inteligentes de chave de API Anthropic também inicializam cacheRetention: "short" para referências de modelo Claude-on-Bedrock quando nenhum valor explícito é definido.

​

Janela de contexto de 1M (beta Anthropic)

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { context1m: true },
        },
      },
    },
  },
}

​

Backend Claude CLI

• A equipe da Anthropic nos informou que esse uso voltou a ser permitido.
• Portanto, o OpenClaw trata a reutilização do Claude CLI e o uso de claude -p como permitidos para esta integração, a menos que a Anthropic publique uma nova política.
• As chaves de API da Anthropic continuam sendo o caminho de produção mais claro para hosts de gateway sempre ativos e controle explícito de faturamento no lado do servidor.
• Os detalhes de configuração e runtime estão em /gateway/cli-backends.

​

Observações

• A documentação pública do Claude Code da Anthropic ainda documenta o uso direto da CLI, como claude -p, e a equipe da Anthropic nos informou que o uso do Claude CLI no estilo OpenClaw voltou a ser permitido. Estamos tratando essa orientação como definitiva, a menos que a Anthropic publique uma nova mudança de política.
• O setup-token da Anthropic continua disponível no OpenClaw como um caminho compatível de autenticação por token, mas o OpenClaw agora prefere reutilização do Claude CLI e claude -p quando disponíveis.
• Os detalhes de auth + regras de reutilização estão em /concepts/oauth.

​

Solução de problemas

• A autenticação por token Anthropic pode expirar ou ser revogada.
• Para novas configurações, migre para uma chave de API da Anthropic.

• A auth é por agente. Novos agentes não herdam as chaves do agente principal.
• Execute novamente o onboarding para esse agente, ou configure uma chave de API no host do gateway, e então verifique com openclaw models status.

• Execute openclaw models status para ver qual perfil de auth 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 mesmo quando o atual está em cooldown.
• Adicione outro perfil Anthropic ou aguarde o cooldown.