Guia Detalhado do OpenClaw Dreaming 2026: Sincronização de Memória em Background para Agentes de IA

Resumo Essencial

• Dreaming é um processo automático de três fases no OpenClaw que transforma sinais de memória de curto prazo em conhecimento persistente de longo prazo.
• As fases são: Sono Leve (ingestão e ordenação), Sono REM (reflexão e extração de padrões) e Sono Profundo (promoção para MEMORY.md).
• A promoção requer a passagem em três portas de limiar: pontuaçãoMínima 0.8, contagemMínimaRecall 3, consultasMínimasÚnicas 3.
• Seis sinais ponderados avaliam cada candidato: relevância(0.30), frequência(0.24), diversidade de consultas(0.15), frescor(0.15), integração(0.10), riqueza conceitual(0.06).
• O Dreaming está desativado por padrão e deve ser ativado manualmente – use /ativar-dreaming ou arquivos de configuração.

Por que Implementar o Dreaming

Agentes do OpenClaw acumulam diariamente dados: notas, sessões, vestígios de recall. A maioria é útil apenas temporariamente e não para armazenamento a longo prazo. Sem consolidação, você enfrenta dois problemas:

• Excesso de promoção: cada detalhe passageiro entra no MEMORY.md, poluindo-o com ruído.
• Conservadorismo excessivo: nada é promovido, e padrões críticos são perdidos.

O Dreaming resolve isso com uma varredura de background em três fases: pontua sinais continuamente e só promove aqueles que superam limiares de evidência. Pense nisso como um pipeline curatorial: ingestão → reflexão → promoção criteriosa.

Insight Chave: O Dreaming é opcional e ativado por escolha. Você controla quando e como o OpenClaw integra memórias.

Mecanismo de Funcionamento: Detalhe das Fases

Quando ativado, o memory-core agrega uma tarefa cron gerenciada (padrão: 3h da manhã diariamente) para executar uma varredura completa. Cada varredura opera sequencialmente em três estágios:

Fase 1: Sono Leve

Esta é a camada de ingestão. Ela:

• Lê arquivos de memória diários recentes (memoria/YYYY-MM-DD.md), parseando-os em fragmentos.
• Incorpora sessões em corpus diários sob memoria/.dreams/corpus-sessoes/.
• Remove duplicatas usando similaridade de Jaccard (limiar 0.9).
• Armazena candidatos temporariamente no repositório de recall de curto prazo.
• Registra "acertos de sinal do Sono Leve" – que melhoram classificações nas fases seguintes.
• Opcionalmente, insere um bloco ## Sono Leve nos arquivos de memória diários.
• Gera uma entrada narrativa no Diário de Sonos.

Importante: A fase do Sono Leve nunca escreve no MEMORY.md. Ela apenas armazena temporariamente e registra sinais.

Fase 2: Sono REM (Reflexão e Extração de Padrões)

Esta fase busca temas recorrentes no material armazenado. Ela:

• Lê todas as entradas de recall dentro da janela retrospectiva REM (padrão: 7 dias).
• Extrai temas repetidos analisando a frequência de tags conceituais.
• Identifica "verdades candidatas" – entradas que aparecem com alta confiança repetidamente.
• Escreve um bloco ## Sono REM com reflexões.
• Registra acertos de sinal REM (também melhora a classificação de profundidade).
• Gera uma entrada narrativa no Diário de Sonos.

Importante: A fase REM também nunca escreve no MEMORY.md. Ela produz sinais reflexivos para informar a fase profunda.

Fase 3: Sono Profundo (Promoção para Memória de Longo Prazo)

É aqui que ocorre a promoção. A fase do Sono Profundo:

• Recupera todos os candidatos do repositório de recall de curto prazo.
• Pontua cada um usando seis sinais ponderados.
• Aplica bônus de reforço de fase com base em acertos dos Sono Leve e REM.
• Filtra candidatos que não passam nas portas de limiar.
• Re-hidrata fragmentos sobreviventes dos arquivos diários mais recentes (ignorando conteúdo deletado ou desatualizado).
• Anexa entradas promovidas a uma seção datada ## Promovido da Memória de Curto Prazo no MEMORY.md.
• Escreve um relatório do Sono Profundo e gera uma entrada narrativa no Diário de Sonos.

Boa Prática: Apenas a fase do Sono Profundo escreve no MEMORY.md. Essa separação garante que dados ruidosos nunca poluam a memória de longo prazo.

Decomposição dos Sinais de Classificação

Cada candidato no repositório de recall é pontuado com seis sinais ponderados. Detalhamento completo:

Sinal	Peso	O que Mede
Relevância	0.30	Qualidade média de retrieval em todos os recalls.
Frequência	0.24	Total acumulado de sinais de curto prazo.
Diversidade de Consultas	0.15	Número de contextos de consulta diferentes onde a entrada aparece.
Frescor	0.15	Frescor temporal com decaimento (meia-vida de 14 dias).
Integração	0.10	Força de recorrência multi-dia.
Riqueza Conceitual	0.06	Densidade de tags conceituais em fragmentos e caminhos.

Acertos das fases Sono Leve e REM adicionam bônus temporalmente decaídos à pontuação base (até 0.05 e 0.08, respectivamente).

Portas de Limiar: O que é Promovido

Candidatos devem passar em todas as três portas para promoção:

Porta	Valor Padrão	Significado
pontuacaoMinima	0.8	A pontuação ponderada combinada deve atingir no mínimo este valor.
contagemMinimaRecall	3	A entrada deve ser recuperada pelo menos este número de vezes.
consultasMinimasUnicas	3	A entrada deve aparecer em pelo menos este número de consultas diferentes.

Por que três portas?: Essas portas prevenem que menções isoladas sejam promovidas. Memórias devem demonstrar relevância contínua e diversa – não apenas um retrieval ocasional.

Bônus de Reforço de Fase

Acertos das fases Sono Leve e REM adicionam bônus extras à pontuação de sinais base:

Fase	Bônus Máximo	Condição
Sono Leve	+0.05	Acertos de sinal do Sono Leve temporalmente decaídos.
Sono REM	+0.08	Acertos de sinal do REM temporalmente decaídos.

Diário de Sonos: Saída Legível por Humanos

Além do estado legível por máquinas, o dreaming gera um Diário de Sonos legível por humanos em DREAMS.md. Após cada fase com material suficiente, um subagente gera uma entrada narrativa curta e criativa (80-180 palavras), escrita de uma perspectiva de "uma mente curiosa, gentil e ligeiramente fantasiosa revisando o dia".

O diário é visível na aba Dreams do Gateway, apenas para navegação humana – não é uma fonte de promoção.

Localização no Disco

Estado da Máquina (memoria/.dreams/)

Arquivo	Propósito
recall-curto-prazo.json	Todas as entradas de recall rastreadas com suas pontuações.
sinais-fase.json	Contagens de acertos Sono Leve/REM por chave de entrada.
ingestao-diaria.json	Rastreamento de alterações em arquivos diários.
ingestao-sessao.json	Rastreamento de alterações em arquivos de sessão.
corpus-sessoes/YYYY-MM-DD.txt	Fragmentos de mensagens de sessão ingeridos.
bloqueio-promocao-curto-prazo	Bloqueio de arquivo durante promoções.
eventos.jsonl	Log de auditoria de eventos do Dreaming.

Saída Legível por Humanos

Arquivo	Propósito
DREAMS.md	Diário de Sonos com blocos ## Sono Leve, ## Sono REM, ## Sono Profundo.
memoria/dreaming/profundo/YYYY-MM-DD.md	Relatório de fase do Sono Profundo separado opcional.
MEMORY.md	Memória de longo prazo onde as entradas promovidas chegam.

Início Rápido

Ativando o Dreaming

A maneira mais rápida é usar um comando de barra em qualquer canal:

/ativar-dreaming

Ou adicionar ao arquivo de configuração:

{
  "configPlugins": {
    "modulos": {
      "gerenciadorMemoria": {
        "opcoes": {
          "moduloDreaming": {
            "ativo": true
          }
        }
      }
    }
  }
}

Alterando a Frequência da Varredrua

Padrão é diariamente às 3h da manhã. Altere para a cada 6 horas:

{
  "configPlugins": {
    "modulos": {
      "gerenciadorMemoria": {
        "opcoes": {
          "moduloDreaming": {
            "ativo": true,
            "agendamento": "0 */6 * * *"
          }
        }
      }
    }
  }
}

Verificando o Status

/dreaming status

Ou via CLI:

openclaw mem status --detalhado

Desativando o Dreaming

/desativar-dreaming

Fluxos de Trabalho Manuais e Depuração

Pré-visualização da Promoção (sem aplicar)

Veja o que seria promovido se a varredura do Sono Profundo fosse executada agora:

openclaw mem promover

Aplicação Manual da Promoção

Execute a promoção do Sono Profundo e grave os resultados no MEMORY.md:

openclaw mem promover --aplicar

Limite aos 5 primeiros candidatos:

openclaw mem promover --aplicar --limite 5

Explicação do Porquê uma Entrada é/Não é Promovida

Para ajustar limiares ou entender a pontuação:

openclaw mem explicar-promocao "roteador vlan"
openclaw mem explicar-promocao "roteador vlan" --json

Pré-visualização das Reflexões REM

Veja o que a fase REM produziria, sem gravar nada:

openclaw mem teste-rem
openclaw mem teste-rem --json

Referência de Configuração

Todas as definições estão em configPlugins.modulos.gerenciadorMemoria.opcoes.moduloDreaming.

Chave	Padrão	Descrição
ativo	false	Interruptor principal.
agendamento	"0 3 * * *"	Cronograma em Cron para varreduras completas.
fusoHorario	(padrão do agente)	Fuso horário para cálculos de fronteira diária.
logDetalhado	false	Log detalhado de candidatos.
armazenamento.modo	"inline"	"inline", "separado" ou "ambos".
armazenamento.relatoriosSeparados	false	Gravar arquivos de relatório por fase.
fases.leve.limite	100	Número máximo de candidatos processados na fase do Sono Leve.
fases.leve.diasRetrospectiva	2	Dias para ler arquivos diários no Sono Leve.
fases.profundo.limite	10	Número máximo de promoções por varredura.
fases.profundo.pontuacaoMinima	0.8	Pontuação mínima ponderada necessária para promoção.
fases.profundo.contagemMinimaRecall	3	Número mínimo de sinais de recall necessários.
fases.profundo.consultasMinimasUnicas	3	Número mínimo de contextos de consulta diferentes necessários.
fases.profundo.meiaVidaFrescorDias	14	Meia-vida em dias para decaimento temporal do frescor.
fases.profundo.idadeMaximaDias	30	Idade máxima em dias para um candidato.
fases.rem.diasRetrospectiva	7	Dias para ler entradas de recall no REM.
fases.rem.limite	10	Número máximo de candidatos REM por varredura.
fases.rem.forcaPadraoMinima	0.75	Força mínima do padrão para temas do REM.

Guia de Ajuste

Promoções em Excesso

Se MEMORY.md crescer rápido demais:

• Aumente fases.profundo.pontuacaoMinima (tente 0.85 ou 0.9).
• Aumente fases.profundo.contagemMinimaRecall (tente 5).
• Reduza fases.profundo.limite (tente 5).
• Encurte fases.profundo.idadeMaximaDias para que candidatos antigos expirem mais rápido.

Promoções Insuficientes

Se nada for promovido e contextos importantes forem perdidos:

• Reduza fases.profundo.pontuacaoMinima (tente 0.7).
• Reduza fases.profundo.contagemMinimaRecall para 2.
• Aumente fases.profundo.limite para permitir mais promoções por varredura.
• Alongue fases.profundo.idadeMaximaDias para dar mais tempo aos candidatos acumularem sinais.

Frequência da Varredura

Frequência	Cenário Ideal
Diariamente (padrão)	Adequado para a maioria dos usuários. Baixo uso de recursos, promoções estáveis.
A cada 6 horas	Agentes ativos com alto throughput de memória diário.
Semanalmente (0 3 * * 0)	Agentes que não acumulam muita memória de curto prazo.

Depuração da Pontuação de Candidatos

• Ative logDetalhado: true para ver pontuações de cada candidato no log de eventos.
• Use openclaw mem explicar-promocao "<consulta>" para examinar um candidato específico.
• Inspecione memoria/.dreams/eventos.jsonl para logs detalhados de execução de fase.

Integração do Dreaming com Outras Partes do OpenClaw

Notas diárias + Sessões + Vestígios de Recall
            │
            ▼
┌───────────────────────┐
│     Fase Sono Leve      │  Ingestão, remoção de duplicatas, armazenamento temporário, registro de sinais
└──────────┬─────────────┘
           │
           ▼
┌───────────────────────┐
│     Fase Sono REM       │  Extração de temas, registro de sinais de reforço
└──────────┬─────────────┘
           │
           ▼
┌───────────────────────┐
│     Fase Sono Profundo  │  Pontuação, limiares, promoção → MEMORY.md
└──────────┬─────────────┘
           │
           ▼
    Diário de Sonos (DREAMS.md) — Apenas narrativa legível por humanos

Pontos-chave de integração:

• Busca de memória (openclaw mem buscar) alimenta sinais de recall de curto prazo no pipeline de promoção durante a operação normal do agente.
• Arquivos de memória diários (memoria/YYYY-MM-DD.md) são a fonte primária para ingestão na fase do Sono Leve.
• Logs de sessão (~/.openclaw/agentes/<id>/sessoes/*.jsonl</id>) são a fonte secundária.
• Inicialização do Gateway coordena a tarefa cron gerenciada, então mudanças de configuração entram em vigor após a próxima reinicialização do Gateway.
• Aba Dreams do Gateway exibe status em tempo real, contagens de fase e o Diário de Sonos.

Perguntas Frequentes

P: O que é exatamente "dreaming" no contexto de agentes de IA?

R: Dreaming é o sistema de consolidação de memória em background do OpenClaw. Ele simula ciclos biológicos de sono — Sono Leve para ingestão, Sono REM para reconhecimento de padrões, Sono Profundo para promoção de memória. Executa automaticamente em tempos ociosos, transformando sinais de curto prazo ruidosos em conhecimento de longo prazo filtrado.

P: Como isso difere de escrever tudo no MEMORY.md?

R: Sem dreaming, você enfrenta resultados binários: promoção excessiva (tudo entra no MEMORY.md, inchado com ruído) ou promoção insuficiente (nada sobrevive, padrões importantes perdidos). O Dreaming usa pontuação baseada em evidências com seis sinais ponderados e três portas de limiar, garantindo que apenas conteúdo verdadeiramente valioso e repetidamente relevante seja promovido.

P: Posso pré-visualizar o que seria promovido antes de as alterações ocorrerem?

R: Sim. Use openclaw mem promover para pré-visualizar sem aplicar, ou openclaw mem explicar-promocao "<consulta>" para entender se uma entrada específica seria promovida. Você também pode verificar a aba Dreams do Gateway para status em tempo real.

P: Como sei se minha configuração está causando promoções em excesso ou insuficientes?

R: Monitore a velocidade de crescimento de MEMORY.md. Se estiver inchando, aumente pontuacaoMinima e contagemMinimaRecall. Se estiver perdendo contextos importantes, reduza os limiares e alongue idadeMaximaDias. Os logs de eventos.jsonl e o comando explicar-promocao fornecem visibilidade por candidato.

P: O Diário de Sonos é puramente decorativo ou tem função prática?

R: O Diário de Sonos é apenas para uso humano — não é uma fonte de promoção. Destina-se a ser navegado por você para entender o que o OpenClaw achou de interessante em suas sessões. Pense nele como um artefato de curiosidade: uma narrativa gentil e ligeiramente fantasiosa que torna o processo de integração de memórias transparente e envolvente.

P: O que acontece com candidatos que não passam nas portas de limiar?

R: Eles permanecem no repositório de recall de curto prazo, continuando a acumular sinais em recalls futuros. Se eventualmente passarem em todas as três portas, serão promovidos em varreduras futuras. Entradas que excedem idadeMaximaDias expiram e são removidas dos candidatos.

O sistema Dreaming do OpenClaw traz filtragem disciplinada para o gerenciamento de memória de agentes de IA. Ao separar ingestão (Sono Leve), reflexão (Sono REM) e promoção (Sono Profundo), ele garante que sua memória de longo prazo permaneça limpa, relevante e verdadeiramente útil.

Comece em 30 segundos:

/ativar-dreaming

Volte amanhã de manhã — o Diário de Sonos estará esperando na aba Dreams do Gateway.

Para ajustes mais aprofundados, explore openclaw mem promover --simulacao e openclaw mem status --detalhado para entender o que está acontecendo internamente.