OpenClaw OS: 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