OpenClaw Project Operating System: Estrutura de Gerenciamento de Múltiplos Projetos

Problema Central e Solução

O Sistema Operacional do Projeto OpenClaw aborda falhas e inconsistências de execução em ambientes de múltiplos projetos. O principal problema era agentes realizando trabalho previsível que deveria ser tratado por ferramentas, levando ao desperdício de tokens, poluição de contexto, instabilidade e execução inconsistente.

A mudança central: "Agentes não devem fazer trabalho previsível. Ferramentas devem." Agentes estavam fazendo trabalho repetitivo como monitorar processos, resumir repetidamente, verificar loops de status e gerenciar estado manualmente. Agora ferramentas e scripts lidam com todas as tarefas previsíveis, cron executa tudo automaticamente, e agentes são usados apenas para planejamento, depuração e tomada de decisões.

Arquitetura do Sistema

Regras Principais do Sistema:

• Agentes pensam. Ferramentas fazem. Cron executa código.
• Cada projeto é isolado com estrutura obrigatória: /nome_do_projeto/ PROJECT.md SKILL.md /state/ /chat/ /daily/ /scripts/ /logs/ /backups/ /archive/ /cleanup_queue/
• Memória baseada em arquivos: Memória são documentos markdown, estado JSON, logs e resumos (chats NÃO são memória)
• Backup primeiro (obrigatório): Antes de qualquer alteração, faça backup primeiro, versionar arquivos, permitir reversão
• Puxar antes de empurrar (crítico): Antes de atualizar servidores, websites ou sistemas remotos, você deve: 1. puxar 2. comparar 3. fazer backup 4. depois empurrar
• Sem exclusão instantânea: Mover arquivos para archive/ ou cleanup_queue/, excluir depois via cron
• Explicar alterações: Se alterar qualquer coisa, explique problema, solução, benefício e confirme backup

Sistema de Automação

Cron executa scripts, tarefas e trabalhos determinísticos mas NÃO agentes livres ou loops de raciocínio.

Tarefas Cron Obrigatórias:

• Descoberta de Projetos: Encontrar todos os projetos, validar estrutura, construir registro
• Resumidor de 6 Horas (modelo local): Resumir projeto, manter últimas 10 mensagens, arquivar o resto, contexto fresco a cada execução
• Planejador Diário: Registrar trabalho diário, rastrear bloqueadores, rastrear decisões
• Verificação de Saúde: Detectar projetos estagnados, trabalhos falhos, atualizações ausentes
• Backup/Checkpoint: Versionar arquivos, capturar estado
• Limpeza Semanal: Remover arquivos antigos apenas se seguro, exigir checkpoint
• Auditoria Cron: Detectar trabalhos perdidos, falhas
• Publicação Agendada: Usar JSON + ferramentas, sem agentes
• Sincronização Remota: Puxar antes de atualizar, comparar versões
• Relatório Matinal: Resumir todos os projetos, preparar para revisão do agente

Sistema de Resumo

A cada 6 horas: Ler logs do projeto, resumir, atualizar estado, manter apenas últimas 10 mensagens, arquivar o resto.