Lições da execução de múltiplos gateways OpenClaw em produção

Falhas de produção e suas causas

Um desenvolvedor executando 3+ gateways OpenClaw 24/7 para uso pessoal, uma organização sem fins lucrativos e uma organização comunitária experimentou falhas repetidas de produção ao tratar mudanças no OpenClaw como trabalho improvisado em vez de implantações de produção.

Cenários específicos de falha

A atualização que não morria: Executar pnpm add -g openclaw@latest fez o gateway travar com MODULE_NOT_FOUND porque a nova versão foi instalada em um caminho diferente enquanto o arquivo de serviço tinha o caminho antigo embutido. Um script de resgate que reiniciava a cada 5 minutos não conseguia distinguir entre travamentos transitórios (onde o reinício funciona) e falhas estruturais (que exigem correções no arquivo de serviço primeiro).

Perda silenciosa de capacidade: Após configurar novas integrações e reiniciar o gateway, capacidades como conversão de texto em fala para acessibilidade de placas, envio de e-mail e postagem no X.com pareciam configuradas, mas na verdade estavam quebradas devido a chaves de API em seções de configuração erradas ou credenciais expiradas. Essas falhas passaram despercebidas por dias.

Análise da causa raiz

A configuração do gateway OpenClaw está espalhada por pelo menos cinco locais:

• Arquivo JSON principal
• Variáveis de ambiente em arquivos de serviço
• Sinalizadores Docker
• Blocos de provedor
• Habilidades com suas próprias credenciais

Rotacionar uma chave em um local deixa as outras desatualizadas. Atualizar o OpenClaw quebra caminhos embutidos. Atualizar uma habilidade faz com que as credenciais parem de carregar silenciosamente. Essas são regressões que o CI/CD pegaria no desenvolvimento de software, mas não havia CI para a infraestrutura do gateway.

Solução sendo implementada

Auditoria de capacidade: Antes e depois de qualquer mudança:

• Analisar configuração para enumerar capacidades declaradas
• Verificar se cada uma realmente funciona com testes de API ao vivo (tempo limite de 5 segundos)
• Diferenciar instantâneos antes/depois

Portão de validação de configuração: Sem edições diretas na configuração ativa:

• Verificação de validade JSON
• Backups com carimbo de data/hora
• Bloqueia padrões perigosos conhecidos

Ambiente reproduzível:

• Arquivos de serviço independentes de versão (sem caminhos embutidos)
• Um arquivo de credenciais canônico, com todo o resto derivando dele
• Detecção de loop de travamento (3 falhas = modo de diagnóstico, não modo de reinício)

Detector de regressão:

• Comparação diária contra uma linha de base conhecida como boa
• Classificar mudanças como melhoria vs. degradação
• Alerta sobre perda de capacidade

O desenvolvedor está compartilhando este trabalho antecipadamente e pergunta a outros operadores de infraestrutura de IA: "Como vocês lidam com o gerenciamento de gateways?" e "Qual é a sua estratégia de teste para o seu openclaw?"