Dreaming

Dreaming é o sistema de consolidação de memória em segundo plano no memory-core. Ele ajuda o OpenClaw a mover sinais fortes de curto prazo para a memória durável, mantendo o processo explicável e revisável.

# O que o dreaming grava

Dreaming mantém dois tipos de saída:

• Estado da máquina em memory/.dreams/ (armazenamento de recuperação, sinais de fase, checkpoints de ingestão, locks).
• Saída legível por humanos em DREAMS.md (ou dreams.md existente) e arquivos opcionais de relatório de fase em memory/dreaming/<phase>/YYYY-MM-DD.md.

A promoção de longo prazo ainda grava apenas em MEMORY.md.

# Modelo de fases

Dreaming usa três fases cooperativas:

Essas fases são detalhes internos de implementação, não "modos" separados configurados pelo usuário.

# Ingestão de transcrições de sessão

Dreaming pode ingerir transcrições de sessão redigidas no corpus de dreaming. Quando as transcrições estão disponíveis, elas são enviadas para a fase leve junto com sinais de memória diária e rastros de recuperação. Conteúdo pessoal e sensível é redigido antes da ingestão.

# Dream Diary

Dreaming também mantém um Dream Diary narrativo em DREAMS.md. Depois que cada fase tem material suficiente, memory-core executa uma rodada de subagente em segundo plano em modo best-effort e acrescenta uma entrada curta de diário. Ele usa o modelo padrão de runtime, a menos que dreaming.model esteja configurado. Se o modelo configurado estiver indisponível, o Dream Diary tenta novamente uma vez com o modelo padrão da sessão.

Também há uma trilha de backfill histórico fundamentado para trabalho de revisão e recuperação:

A Control UI expõe o mesmo fluxo de backfill/reset de diário para que você possa inspecionar os resultados na cena Dreams antes de decidir se os candidatos fundamentados merecem promoção. A Scene também mostra uma trilha fundamentada distinta para que você possa ver quais entradas de curto prazo preparadas vieram de replay histórico, quais itens promovidos foram conduzidos por fundamentação, e limpar apenas entradas preparadas exclusivamente fundamentadas sem tocar no estado ativo comum de curto prazo.

# Sinais de ranqueamento profundo

O ranqueamento profundo usa seis sinais base ponderados mais reforço de fase:

Acertos das fases leve e REM adicionam um pequeno boost com decaimento por recência a partir de memory/.dreams/phase-signals.json.

# Agendamento

Quando habilitado, memory-core gerencia automaticamente um job cron para uma varredura completa de dreaming. Cada varredura executa as fases em ordem: leve → REM → profunda.

A varredura inclui o workspace principal de runtime e quaisquer workspaces de agentes configurados, sem duplicatas por caminho, para que o fan-out de workspace de subagentes não exclua o DREAMS.md e o estado de memória do agente principal.

Comportamento de cadência padrão:

# Início rápido

{
  "plugins": {
    "entries": {
      "memory-core": {
        "config": {
          "dreaming": {
            "enabled": true
          }
        }
      }
    }
  }
}

{
  "plugins": {
    "entries": {
      "memory-core": {
        "config": {
          "dreaming": {
            "enabled": true,
            "timezone": "America/Los_Angeles",
            "frequency": "0 */6 * * *"
          }
        }
      }
    }
  }
}

# Comando slash

/dreaming status
/dreaming on
/dreaming off
/dreaming help

# Fluxo de trabalho da CLI

openclaw memory promote
openclaw memory promote --apply
openclaw memory promote --limit 5
openclaw memory status --deep

openclaw memory promote-explain "router vlan"
openclaw memory promote-explain "router vlan" --json

openclaw memory rem-harness
openclaw memory rem-harness --json

# Principais padrões

Todas as configurações ficam em plugins.entries.memory-core.config.dreaming.

# UI Dreams

Quando habilitada, a aba Dreams do Gateway mostra:

• estado atual de dreaming habilitado
• status em nível de fase e presença de varredura gerenciada
• contagens de curto prazo, fundamentadas, de sinais e promovidas hoje
• horário da próxima execução agendada
• uma trilha Scene fundamentada distinta para entradas preparadas de replay histórico
• um leitor expansível do Dream Diary apoiado por doctor.memory.dreamDiary

# Dreaming nunca executa: o status mostra bloqueado

Se openclaw memory status relatar Dreaming status: blocked, o cron gerenciado existe, mas o Heartbeat do agente padrão não está disparando. Verifique se o Heartbeat está habilitado para o agente padrão e se o destino dele não é none; depois execute openclaw memory status --deep novamente após o próximo intervalo de Heartbeat.

# Relacionado

• Memória
• CLI de memória
• Referência de configuração de memória
• Busca de memória