Anthropic

Use parâmetros no nível do modelo como sua 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 a id, substitui por chave)

Isso permite que um agente mantenha um cache de longa duração enquanto outro agente no mesmo modelo desativa o cache para tráfego em rajadas/com baixa reutilização.

• Modelos Anthropic Claude no Bedrock (amazon-bedrock/*anthropic.claude*) aceitam passagem direta de cacheRetention quando configurados.
• 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 inicializam cacheRetention: "short" para referências Claude no Bedrock quando nenhum valor explícito é definido.

O alternador compartilhado /fast do OpenClaw oferece suporte a tráfego direto da Anthropic (chave de API e OAuth para api.anthropic.com).

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

O Plugin Anthropic incluído registra compreensão de imagem e PDF. O OpenClaw resolve automaticamente os recursos de mídia a partir da autenticação Anthropic configurada — nenhuma configuração adicional é necessária.

Quando uma imagem ou um PDF é anexado a uma conversa, o OpenClaw automaticamente encaminha isso 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 da 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.

anthropic/claude-opus-4.7 e sua variante claude-cli têm uma janela de contexto de 1M por padrão — não é necessário params.context1m: true.

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 da 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 estar utilizável. Adicione outro perfil Anthropic ou aguarde o cooldown.