Solução de Problemas do OpenClaw: Um Método de Reinicialização Minimalista

Procedimento de Redefinição do OpenClaw para Configurações Instáveis

Quando as configurações do OpenClaw ficam instáveis—com habilidades consumindo tokens, agentes relatando conclusões falsas ou atualizações quebrando conexões—uma redefinição completa para uma configuração mínima pode identificar a causa raiz. Essa abordagem isola problemas removendo a complexidade.

Processo de Redefinição em Cinco Etapas

Etapa 1: Remover Todas as Habilidades (60 segundos)

Mova todas as habilidades para um backup para eliminar fontes comuns de instabilidade, como loops silenciosos, consumo de tokens, injeção de contexto, sobrescrita de configurações ou malware:

mkdir ~/.openclaw/skills-backup
mv ~/.openclaw/agents/*/skills/* ~/.openclaw/skills-backup/

Isso preserva as habilidades para restauração posterior enquanto testa a funcionalidade central do agente.

Etapa 2: Mudar para o Claude Sonnet (30 segundos)

Altere a configuração do modelo de IA para eliminar problemas relacionados ao modelo:

{
  "ai": {
    "model": "claude-sonnet-4-5-20250929"
  }
}

O Sonnet é recomendado por ser barato, confiável e consistente com chamadas de ferramentas. Se sua configuração funciona com o Sonnet, mas não com o Opus, GPT-5.4 ou modelos locais, o modelo era o problema.

Etapa 3: Limpar Sessões (15 segundos)

Remova o histórico de conversas potencialmente corrompido:

rm -rf ~/.openclaw/agents/*/sessions/*

Isso não afeta o SOUL.md, memória, USER.md ou configurações permanentes—apenas os dados de sessão que podem corromper após atualizações ou trocas de modelo.

Etapa 4: Simplificar o SOUL.md (60 segundos)

Verifique seu SOUL.md atual e substitua por uma versão mínima, se necessário:

cat ~/.openclaw/agents/*/SOUL.md

Substitua por esta versão de 5 linhas:

seja direto. sem enfeites. combine com meu tom.
se eu fizer uma pergunta, responda primeiro.
nunca diga "absolutamente", "ótima pergunta" ou "ficarei feliz em".
se você não sabe algo, diga.
se uma tarefa custar muitos tokens, me avise antes de fazer.

Adicione mais instruções gradualmente com base no que te incomoda na próxima semana.

Etapa 5: Reiniciar e Testar (30 segundos)

Reinicie o OpenClaw e envie uma mensagem básica:

openclaw stop
openclaw start

Teste com consultas simples como "que dia é hoje?" ou "resuma este artigo" com um URL. Se responder corretamente sem comportamentos estranhos, seu núcleo funciona. Os problemas vieram do que você removeu. Adicione os componentes de volta um por um, testando após cada adição.

Por Que Isso Funciona

A maioria das configurações do OpenClaw acumula habilidades, agentes, tarefas agendadas, trocas de modelo e ajustes de configuração até que um componente cause o colapso. Como tudo foi adicionado simultaneamente, identificar a peça problemática se torna impossível. Reduzir para uma configuração mínima e reconstruir incrementalmente cria configurações estáveis.

Após implementar essa redefinição, um usuário relatou uma configuração estável com um agente, Sonnet e quatro habilidades (busca na web, briefing diário, tomador de notas e um script Python personalizado para triagem de e-mails) custando menos de US$ 10/mês e funcionando sem problemas por mais de quatro semanas.