​

Anthropic (Claude)

​

Opção A: chave de API da Anthropic

​

Configuração da CLI

openclaw onboard
# choose: Anthropic API key

# ou não interativo
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

​

Trecho de configuração do Claude CLI

{
  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 isso por mensagem (/think:<level>) ou nos params do modelo: agents.defaults.models["anthropic/<model>"].params.thinking.
• Documentação relacionada da Anthropic:
  • Adaptive thinking
  • Extended thinking

​

Modo rápido (API da 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 requisições diretas a api.anthropic.com. Se você rotear anthropic/* por um proxy ou gateway, /fast deixará service_tier inalterado.
• Os params explícitos de modelo serviceTier ou service_tier da Anthropic 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 da Anthropic)

​

Configuração

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

​

Padrões

​

Sobrescritas de cacheRetention por agente

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" }, // base para a maioria dos agentes
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // sobrescrita apenas para este agente
    ],
  },
}

1. agents.defaults.models["provider/model"].params
2. agents.list[].params (correspondendo a id, sobrescreve por chave)

​

Observações sobre Bedrock Claude

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

​

Janela de contexto de 1M (beta da Anthropic)

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

​

Opção B: Claude CLI como provider de mensagens

• claude-cli/claude-sonnet-4-6
• claude-cli/claude-opus-4-6

1. O OpenClaw inicia claude -p --output-format stream-json --include-partial-messages ... no host do gateway e envia o prompt por stdin.
2. O primeiro turno envia --session-id <uuid>.
3. Turnos seguintes reutilizam a sessão Claude armazenada via --resume <sessionId>.
4. Suas mensagens de chat ainda passam pelo pipeline normal de mensagens do OpenClaw, mas a resposta real do modelo é produzida pelo Claude CLI.

​

Requisitos

• Claude CLI instalado no host do gateway e disponível no PATH, ou configurado com um caminho absoluto para o comando.
• Claude CLI já autenticado nesse mesmo host:

claude auth status

• O OpenClaw carrega automaticamente o plugin Anthropic empacotado na inicialização do gateway quando sua configuração referencia explicitamente claude-cli/... ou configuração de backend claude-cli.

​

Trecho de configuração

{
  agents: {
    defaults: {
      model: {
        primary: "claude-cli/claude-sonnet-4-6",
      },
      models: {
        "claude-cli/claude-sonnet-4-6": {},
      },
      sandbox: { mode: "off" },
    },
  },
}

{
  agents: {
    defaults: {
      cliBackends: {
        "claude-cli": {
          command: "/opt/homebrew/bin/claude",
        },
      },
    },
  },
}

​

O que você recebe

• Autenticação de assinatura Claude reutilizada a partir da CLI local (lida em runtime, não persistida)
• Roteamento normal de mensagens/sessão do OpenClaw
• Continuidade de sessão do Claude CLI entre turnos (invalidada em mudanças de autenticação)
• Ferramentas do Gateway expostas ao Claude CLI por meio de uma bridge MCP de loopback
• Streaming JSONL com progresso ao vivo de mensagens parciais

​

Migrar da autenticação Anthropic para Claude CLI

• Claude CLI instalado no mesmo host do gateway que executa o OpenClaw
• Claude CLI já autenticado ali: claude auth login

openclaw models auth login --provider anthropic --method cli --set-default

openclaw onboard --auth-choice anthropic-cli

• verifica se o Claude CLI já está autenticado no host do gateway
• muda o modelo padrão para claude-cli/...
• reescreve fallbacks do modelo padrão da Anthropic como anthropic/claude-opus-4-6 para claude-cli/claude-opus-4-6
• adiciona entradas correspondentes claude-cli/... a agents.defaults.models

openclaw models status

• excluir seus perfis de autenticação Anthropic existentes
• remover toda referência antiga de configuração anthropic/... fora do caminho principal de modelo/allowlist padrão

​

Limites importantes

• Este não é o provider da API Anthropic. É o runtime local da CLI.
• O OpenClaw não injeta chamadas de ferramenta diretamente. O Claude CLI recebe ferramentas do gateway por meio de uma bridge MCP de loopback (bundleMcp: true, o padrão).
• O Claude CLI transmite respostas por JSONL (stream-json com --include-partial-messages). Prompts são enviados por stdin, não por argv.
• A autenticação é lida em runtime a partir de credenciais ativas do Claude CLI e não é persistida em perfis do OpenClaw. Prompts do keychain são suprimidos em contextos não interativos.
• A reutilização de sessão é rastreada por metadados cliSessionBinding. Quando o estado de login do Claude CLI muda (novo login, rotação de token), as sessões armazenadas são invalidadas e uma nova sessão é iniciada.
• Melhor para um host de gateway pessoal, não para configurações compartilhadas de cobrança multiusuário.

​

Observações

• A documentação pública do Claude Code da Anthropic ainda documenta uso direto da CLI como claude -p. Acreditamos que o fallback local gerenciado pelo usuário provavelmente é permitido, mas o aviso separado da Anthropic aos usuários do OpenClaw diz que o caminho de login Claude do OpenClaw é uso de third-party harness e exige Extra Usage (pagamento por uso cobrado separadamente da assinatura). Para produção, nós recomendamos chaves de API da Anthropic.
• O setup-token da Anthropic está disponível novamente no OpenClaw como um caminho legado/manual. O aviso de cobrança específico da Anthropic para OpenClaw ainda se aplica, então use-o esperando que a Anthropic exija Extra Usage para esse caminho.
• Detalhes de autenticação + regras de reutilização estão em /concepts/oauth.

​

Solução de problemas

• A autenticação legada por token Anthropic pode expirar ou ser revogada.
• Para novas configurações, migre para uma chave de API da Anthropic ou para o caminho local do Claude CLI no host do gateway.

• A autenticação é 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 então 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 ou Claude CLI para esse caminho de perfil.

• Verifique openclaw models status --json para auth.unusableProfiles.
• Cooldowns de limite de taxa da Anthropic podem ser específicos por modelo, então um modelo Anthropic relacionado ainda pode ser utilizável mesmo quando o atual estiver em cooldown.
• Adicione outro perfil Anthropic ou aguarde o cooldown.