Executando OpenClaw ilimitado com Claude

O OpenClaw é um gateway de IA multicanal que conecta o Claude a mais de 50 canais de mensagens por meio de uma arquitetura de hub e conexões radiais. Cada canal é um endpoint de inferência independente — bots do Telegram, servidores do Discord, espaços de trabalho do Slack, widgets web e integrações personalizadas encaminham tudo por um gateway central executado na sua infraestrutura. Com habilidades injetadas nos prompts de sistema e canais que nunca fecham, o OpenClaw representa um consumo contínuo e permanente de API que cresce linearmente com o número de canais e usuários ativos.

Arquitetura sempre ativa do OpenClaw

O OpenClaw opera como um gateway com arquitetura de hub e conexões radiais. O hub é um processo central (normalmente executado em um VPS na porta 18789) que gerencia a configuração dos modelos, a injeção de habilidades e o roteamento de requisições. As conexões radiais são conectores de canais — cada um mantém uma conexão persistente com uma plataforma de mensagens e encaminha as mensagens recebidas ao hub para inferência.

Cada canal é uma torneira de inferência aberta. Quando um usuário envia uma mensagem em qualquer plataforma conectada, o conector do canal a encaminha ao hub, que monta o prompt completo (prompt de sistema + habilidades + histórico da conversa + mensagem do usuário), envia-o ao Claude e transmite a resposta de volta ao canal. Não há filas nem processamento em lote — cada mensagem recebe inferência imediata.

O gateway nunca dorme. Enquanto o processo estiver em execução, todos os 50+ canais estarão ativos, e qualquer mensagem recebida acionará uma chamada à API do Claude. Ao contrário de ferramentas interativas que consomem tokens apenas quando um desenvolvedor está trabalhando, o OpenClaw consome tokens sempre que qualquer usuário em qualquer canal envia uma mensagem — o que, em implantações ativas, significa centenas ou milhares de chamadas por dia. Isso torna o acesso ilimitado não apenas conveniente, mas economicamente necessário para implantações de maior porte.

Configuração do provedor em openclaw.json

A configuração de modelos do OpenClaw fica em ~/.openclaw/openclaw.json, no bloco models.providers. Cada entrada de provedor exige um nome, o campo api (que MUST ser definido explicitamente como 'anthropic-messages' para o Claude — esse não é o valor padrão), baseUrl apontando para seu gateway e apiKey para autenticação. O campo api controla o formato de requisição usado pelo OpenClaw.

Defina baseUrl como https://aiprimetech.io (host raiz, sem /v1 — o manipulador anthropic-messages acrescenta o caminho correto). Para apiKey, você pode usar valores diretos ou interpolação de variáveis de ambiente com a sintaxe ${ENV_VAR}. A interpolação é útil para manter segredos fora do arquivo de configuração: defina apiKey como '${UNLIMITED_API_KEY}' e exporte a variável no seu shell ou na unidade do systemd.

Você também pode especificar cabeçalhos personalizados na configuração do provedor. Use o campo headers para passar sinalizadores anthropic-beta ou cabeçalhos de roteamento personalizados. Por exemplo, headers: {'anthropic-beta': 'max-tokens-3-5-sonnet-2024-07-15'} habilita saídas estendidas para os modelos compatíveis. No gateway ilimitado, os cabeçalhos padrão funcionam sem modificações.

Entradas de modelos e obrigatoriedade do campo api

Um detalhe crítico na configuração do OpenClaw: o campo api em cada entrada de modelo MUST ser explicitamente definido como 'anthropic-messages'. Se for omitido, o OpenClaw usa por padrão um formato genérico de completions incompatível com o Claude. Isso causa erros difíceis de interpretar que parecem falhas de conexão, mas são, na verdade, incompatibilidades de formato. Sempre inclua api: 'anthropic-messages' em cada entrada de modelo Claude.

Defina as entradas de modelos em models.models no openclaw.json. Cada entrada referencia um provedor pelo nome e especifica o ID do modelo. Crie entradas para cada variante do Claude: claude-sonnet-4-5 como padrão para a maioria dos canais, claude-opus-4-6 para canais que precisam de raciocínio mais profundo e claude-haiku-4-5 para canais de alto volume em que a velocidade importa mais que a profundidade.

Atribua modelos aos canais na configuração de canais. Cada canal pode usar um modelo diferente — um canal de suporte ao cliente pode usar Sonnet para respostas equilibradas, um canal técnico pode usar Opus para explicações complexas e um canal de notificações pode usar Haiku para confirmações rápidas. Com acesso ilimitado, faça a atribuição com base nas necessidades de qualidade, sem considerar os custos.

Gateway com arquitetura de hub e conexões radiais na porta 18789

O gateway do OpenClaw normalmente é executado na porta 18789 (configurável em openclaw.json, em server.port). Ele expõe uma API REST que os conectores de canais usam para enviar mensagens e receber respostas. O gateway cuida internamente da construção de prompts, da seleção de modelos, do gerenciamento do histórico de conversas e da transmissão de respostas.

Implante o gateway em um VPS com disponibilidade confiável — ele precisa estar em execução 24/7 para que os canais continuem respondendo. Use systemd ou Docker para garantir a reinicialização automática em caso de falhas. O processo consome poucos recursos de CPU e memória; o gargalo é sempre a latência das chamadas à API de destino, e não o processamento local. Um VPS pequeno (1 CPU, 1 GB de RAM) lida com dezenas de canais simultâneos sem problemas.

O gateway mantém os históricos de conversas na memória (com persistência configurável em disco ou Redis). Cada conversa ativa em todos os canais tem seu próprio contexto crescente. Com 50 canais e vários usuários ativos por canal, o gateway pode manter centenas de estados de conversa simultâneos. Esse gerenciamento de contexto é automático — conversas antigas são removidas com base em configurações de TTL ajustáveis.

Injeção de habilidades e gerenciamento do prompt de sistema

O sistema de habilidades do OpenClaw injeta instruções específicas de cada capacidade no prompt de sistema de todas as requisições. As habilidades são definidas como arquivos de texto no diretório skills e podem ser atribuídas a canais específicos ou aplicadas globalmente. Cada habilidade acrescenta contexto que ajuda o Claude a responder de forma adequada à finalidade do canal — tom de suporte ao cliente, estilo de documentação técnica, conhecimento de um domínio específico.

Cada habilidade acrescenta tokens a todas as requisições em cada canal ao qual está atribuída. Um canal com cinco habilidades ativas pode acrescentar 2,000-5,000 tokens ao prompt de sistema de cada requisição antes mesmo de incluir qualquer histórico de conversa. Em cinquenta canais com diferentes configurações de habilidades, a sobrecarga total diária de habilidades é substancial. Com acesso ilimitado, isso deixa de ser um problema — escreva habilidades abrangentes sem se preocupar com o custo por requisição.

As habilidades podem incluir conteúdo dinâmico por meio de variáveis de template. O OpenClaw permite injetar informações do usuário, contexto do canal, horário do dia e variáveis personalizadas no texto das habilidades. Essa injeção dinâmica ocorre no momento da requisição, garantindo que as habilidades sempre contenham informações atuais. Essa flexibilidade permite comportamentos sofisticados por canal sem uma lógica de roteamento complexa.

Configuração de canais e escalabilidade

Cada canal do OpenClaw é configurado na seção channels do openclaw.json ou em arquivos separados de configuração de canais. Uma entrada de canal especifica o tipo de plataforma (telegram, discord, slack, web, custom), as credenciais de autenticação dessa plataforma, o modelo a usar, as habilidades atribuídas e as configurações de gerenciamento de conversas (tamanho do histórico, TTL, persona).

A expansão é linear: cada novo canal adiciona mais um endpoint de inferência aberto. Adicionar um bot do Telegram adiciona um canal. Adicionar um servidor do Discord com vários canais monitorados pode adicionar dez. Cada canal monitorado do Discord é um fluxo de conversa separado com contexto independente. Uma implantação de grande porte do OpenClaw com Discord, Telegram, Slack e widgets web pode facilmente ter 50-100 endpoints de inferência ativos.

Na cobrança por token, ampliar o número de canais significa aumentar diretamente os custos. Cada novo canal adiciona despesas proporcionais de API com base no volume de mensagens. No plano ilimitado, você pode ampliar os canais livremente até os limites de taxa de uso justo. Adicione novas plataformas, novos bots e novos widgets — o preço fixo cobre todos eles. A única restrição é o limite de taxa por minuto, que é suficientemente generoso para a maioria das implantações com vários canais.

Solução de problemas em implantações do OpenClaw

O erro de configuração mais comum é esquecer api: 'anthropic-messages' nas entradas de modelo. Sem esse campo, o OpenClaw envia solicitações no formato errado e recebe erros incompreensíveis da API. Se você encontrar falhas na análise de respostas ou erros 400 inesperados, verifique primeiro o campo api. Ele deve ser definido explicitamente — não há um padrão correto para os modelos Claude.

Se alguns canais falham enquanto outros funcionam, o problema geralmente está na atribuição de modelo no nível do canal, que aponta para uma entrada de modelo inexistente ou com erro de digitação. O OpenClaw não valida referências de modelo na inicialização — a falha ocorre no momento da solicitação, quando o canal tenta usar o modelo configurado incorretamente. Verifique se a referência de modelo de cada canal corresponde exatamente ao nome de uma entrada existente em models.models.

Para erros de limite de taxa sob carga intensa em vários canais, lembre-se de que todos os canais compartilham a mesma chave de API e os mesmos limites de taxa. Se cinquenta canais estiverem ativos simultaneamente nos horários de pico, a taxa combinada de solicitações poderá exceder os limites de uso justo. O gateway trata respostas 429 colocando as solicitações em fila e tentando novamente, o que adiciona latência, mas não perde mensagens. Para implantações com volumes muito altos, entre em contato com a AI Prime Tech para solicitar limites de taxa maiores.

// ~/.openclaw/openclaw.json
{
  "models": {
    "providers": {
      "unlimited": {
        "api": "anthropic-messages",
        "baseUrl": "https://aiprimetech.io",
        "apiKey": "${UNLIMITED_API_KEY}"
      }
    },
    "models": {
      "sonnet": { "provider": "unlimited", "model": "claude-sonnet-4-5" },
      "opus":   { "provider": "unlimited", "model": "claude-opus-4-6" },
      "haiku":  { "provider": "unlimited", "model": "claude-haiku-4-5" }
    }
  },
  "server": { "port": 18789 }
}

# IMPORTANT: api: "anthropic-messages" is REQUIRED
# Without it, OpenClaw uses wrong request format

Perguntas frequentes

AI Prime Tech é um gateway de API independente. Não tem afiliação com a Anthropic, não é endossado por ela e não é seu revendedor. Claude e os nomes dos modelos relacionados são marcas comerciais de seus respectivos proprietários.