Skip to main content

​
openclaw memory

Gerencie a indexação e a pesquisa da memória semântica, além da promoção para MEMORY.md. Fornecido pelo plugin memory-core incluído, disponível quando plugins.slots.memory seleciona memory-core (o padrão). Outros plugins de memória expõem seus próprios namespaces da CLI. Relacionado: conceito de Memória, Dreaming, Referência de configuração da memória, Wiki da memória, wiki, Plugins.

​
memory status

Sem --agent, é executado para cada agente em agents.list; se nenhuma lista de agentes estiver configurada, usa como alternativa o agente padrão. Se a linha Dreaming continuar como off mesmo com dreaming.enabled: true, ou as varreduras agendadas nunca parecerem ser executadas, o Cron gerenciado do Dreaming depende do acionamento do Heartbeat do agente padrão para iniciar a reconciliação. Consulte Dreaming para obter detalhes do agendamento. O status também lista quaisquer caminhos de pesquisa adicionais de agents.defaults.memorySearch.extraPaths.

​
memory index

O mesmo escopo por agente de status. --force executa uma reindexação completa em vez de uma incremental. --verbose exibe o provedor, o modelo, as fontes e os detalhes dos caminhos adicionais de cada agente antes de mostrar o progresso da indexação.
  • Consulta: [query] posicional ou --query <text>. Se ambos forem definidos, --query prevalece. Se nenhum for definido, o comando retorna um erro.
  • --agent <id>: usa como padrão o agente padrão (não a lista completa de agentes).
  • --max-results <n>: limita a quantidade de resultados (inteiro positivo).
  • --min-score <n>: filtra correspondências com pontuação abaixo desse valor.

​
memory promote

Classifique candidatos de curto prazo de memory/YYYY-MM-DD.md e, opcionalmente, acrescente as principais entradas a MEMORY.md.
Esses padrões da CLI são diferentes dos limites da fase profunda da varredura agendada do Dreaming (consulte Dreaming abaixo); passe sinalizadores explícitos para corresponder ao comportamento da varredura em uma execução manual avulsa. Sinais de classificação: frequência de recuperação, relevância da recuperação, diversidade de consultas, recência temporal, consolidação entre dias e riqueza de conceitos derivados, obtidos tanto das recuperações de memória quanto das passagens de ingestão diária, além de um reforço leve das fases leve/REM para revisitas repetidas do Dreaming. Antes da gravação, a promoção relê a nota diária ativa, de modo que edições ou exclusões de trechos de curto prazo feitas desde a classificação sejam respeitadas, em vez de promover com base em um instantâneo obsoleto.

​
memory promote-explain

Explique a composição da pontuação de um candidato à promoção.
<selector> corresponde à chave de um candidato (exata ou substring), ao caminho ou ao texto do trecho.

​
memory rem-harness

Visualize reflexões REM, possíveis verdades e a saída de promoção da fase profunda sem gravar nada.
  • --path <file-or-dir>: inicializa o ambiente de teste com arquivos diários históricos YYYY-MM-DD.md em vez do espaço de trabalho ativo.
  • --grounded: também renderiza uma visualização fundamentada de O que aconteceu / Reflexões / Possíveis atualizações duradouras com base nas notas históricas.

​
memory rem-backfill

Grave resumos REM históricos fundamentados em DREAMS.md para revisão na interface. Reversível.
  • --path <file-or-dir>: obrigatório, a menos que --rollback/--rollback-short-term esteja definido. Arquivo(s) de memória diária histórica ou diretório a partir do qual preencher retroativamente.
  • --stage-short-term: também insere candidatos duráveis fundamentados no armazenamento ativo de promoção de curto prazo, para que a fase profunda normal possa classificá-los.
  • --rollback: remove de DREAMS.md as entradas de diário fundamentadas gravadas anteriormente.
  • --rollback-short-term: remove candidatos fundamentados de curto prazo preparados anteriormente.

​
Dreaming

Dreaming é o sistema de consolidação de memória em segundo plano com três fases cooperativas, executadas em ordem em um único agendamento: leve (organiza/prepara o material de curto prazo), REM (reflete e revela temas), profunda (promove fatos duráveis para MEMORY.md). Somente a fase profunda grava em MEMORY.md.
  • Ative com plugins.entries.memory-core.config.dreaming.enabled: true (padrão false); memory-core gerencia automaticamente o trabalho Cron da varredura, sem necessidade de executar openclaw cron add manualmente.
  • Ative ou desative pelo chat com /dreaming on|off; inspecione com /dreaming status (ou /dreaming//dreaming help). on/off exige o status de proprietário do canal ou operator.admin do Gateway; o status e a ajuda permanecem disponíveis para qualquer pessoa que possa invocar o comando.
  • A saída legível das fases é gravada em DREAMS.md (ou em um dreams.md existente). Por padrão (dreaming.storage.mode: "separate"), cada fase também grava um relatório independente em memory/dreaming/<phase>/YYYY-MM-DD.md; defina mode: "inline" para incorporar os relatórios ao arquivo de memória diária, ou "both" para usar ambos.
  • As execuções agendadas e manuais de memory promote compartilham os mesmos sinais de classificação da fase profunda; somente os limites padrão são diferentes (consulte a tabela acima e os padrões agendados abaixo).
  • As execuções agendadas são distribuídas entre os espaços de trabalho de memória de todos os agentes configurados.
Padrões agendados (plugins.entries.memory-core.config.dreaming):
Lista completa de chaves e detalhes das fases: Dreaming, Referência de configuração da memória.

​
Dependência do Gateway para SecretRef

Se os campos de chave da API remota da Active Memory estiverem configurados como SecretRefs, os comandos de memory os resolverão com base no instantâneo ativo do Gateway; se o Gateway estiver indisponível, o comando falhará imediatamente. Isso exige um Gateway compatível com o método secrets.resolve; Gateways mais antigos retornam um erro de método desconhecido.

​
Relacionados