Configuração do Espaço de Trabalho OpenClaw: Lições de Dois Meses de Uso

Um usuário do OpenClaw compartilhou lições detalhadas após dois meses usando o agente de programação de IA, enfatizando que a configuração do espaço de trabalho importa mais do que a ferramenta em si. O desenvolvedor descobriu que um espaço de trabalho bem construído melhora a experiência em 5 a 10 vezes em comparação com uma configuração padrão.

Configuração do SOUL.md

Instruções genéricas como "seja útil e profissional" têm impacto mínimo. Arquivos SOUL.md eficazes devem:

• Incluir comportamentos específicos como "comece com a resposta, contexto depois" ou "se você não sabe, diga que não sabe, não invente coisas"
• Manter-se entre 50-150 linhas no máximo, pois cada linha consome tokens da janela de contexto
• Focar em casos extremos em vez de cenários normais: o que o agente deve fazer quando não sabe algo, quando as solicitações estão fora do escopo ou quando as prioridades conflitam
• Testar cada linha perguntando: se for excluída, o comportamento do agente muda? Se não, remova-a

AGENTS.md como Procedimento Operacional Padrão

Este arquivo deve responder "como você trabalha" em vez de "quem você é" (que é o papel do SOUL.md). Principais insights:

• A regra mais valiosa adicionada: "antes de qualquer tarefa não trivial, execute memory_search primeiro" para evitar adivinhações
• Quando o agente comete erros, adicione regras para evitar recorrência, com instruções negativas ("nunca faça X sem verificar Y") frequentemente funcionando melhor do que as positivas
• As regras nos arquivos de inicialização são apenas consultivas — o modelo as segue porque foi solicitado, não porque são impostas
• Para regras que realmente não podem ser quebradas, use política de ferramentas e configuração de sandbox em vez de confiar em markdown com linguagem forte

Gerenciamento do MEMORY.md

Este arquivo é carregado a cada sessão, portanto deve conter apenas informações que precisam de retenção permanente:

• Inclua decisões importantes, preferências do usuário, lições operacionais e regras aprendidas com erros
• Informações diárias vão em arquivos memory/AAAA-MM-DD.md que o agente pesquisa quando necessário
• Limites rígidos: 20 mil caracteres por arquivo, 150 mil no total em todos os arquivos de inicialização — exceder causa truncamento silencioso
• Instruções digitadas no chat NÃO persistem uma vez que ocorre a compactação de contexto
• Conecte seu espaço de trabalho ao git para recuperar arquivos MEMORY sobrescritos acidentalmente do histórico de commits

USER.md e Otimização de Habilidades

O arquivo USER.md é subestimado — incluir histórico, preferências, fuso horário e contexto de trabalho reduz repetição e economiza tokens. Para habilidades:

• Ter 30 habilidades instaladas não injeta 30 arquivos completos de habilidades em cada prompt, mas a própria lista de habilidades consome contexto
• Reduzir de 15+ habilidades para 5 melhorou perceptivelmente a qualidade da saída
• Teste: se uma habilidade desaparecesse amanhã, você notaria? Se não, desinstale-a

Problemas Comuns com Configuração Ruim

Quando a configuração da persona não é sólida, esses problemas surgem rapidamente:

• O agente continua desviando, exigindo correção constante em um loop infinito
• Tokens desperdiçados em ações ineficientes como abrir um navegador quando um script funcionaria
• Muitas habilidades carregadas, inchando o contexto e impedindo funcionalidade adequada
• Saída inconsistente para a mesma tarefa em diferentes sessões

O desenvolvedor, que trabalha em comércio eletrônico, criou personas de sourcing de produtos e operações Shopify após descobrir que a maioria das personas disponíveis eram inadequadas. Eles observaram que, embora toda indústria tenha fluxos de trabalho que poderiam ser empacotados em personas, bons recursos estão espalhados por plataformas pagas, GitHub, blogs aleatórios e posts antigos, com muitas "personas" sendo apenas arquivos SOUL únicos que não são utilizáveis prontamente.