> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Memória # `openclaw memory` Gerencie a indexação e a busca de memória semântica. Fornecido pelo Plugin `memory-core` incluído. O comando fica disponível quando `plugins.slots.memory` seleciona `memory-core` (o padrão); outros Plugins de memória expõem seus próprios namespaces de CLI. Relacionados: * Conceito de memória: [Memória](/pt-BR/concepts/memory) * Wiki de memória: [Wiki de memória](/pt-BR/plugins/memory-wiki) * CLI da wiki: [wiki](/pt-BR/cli/wiki) * Plugins: [Plugins](/pt-BR/tools/plugin) ## Exemplos ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw memory status openclaw memory status --deep openclaw memory status --fix openclaw memory index --force openclaw memory search "meeting notes" openclaw memory search --query "deployment" --max-results 20 openclaw memory promote --limit 10 --min-score 0.75 openclaw memory promote --apply openclaw memory promote --json --min-recall-count 0 --min-unique-queries 0 openclaw memory promote-explain "router vlan" openclaw memory promote-explain "router vlan" --json openclaw memory rem-harness openclaw memory rem-harness --json openclaw memory status --json openclaw memory status --deep --index openclaw memory status --deep --index --verbose openclaw memory status --agent main openclaw memory index --agent main --verbose ``` ## Opções `memory status` e `memory index`: * `--agent `: limita o escopo a um único agente. Sem isso, esses comandos são executados para cada agente configurado; se nenhuma lista de agentes estiver configurada, eles recorrem ao agente padrão. * `--verbose`: emite logs detalhados durante sondagens e indexação. `memory status`: * `--deep`: sonda a prontidão do armazenamento vetorial local, a prontidão do provedor de embeddings e a prontidão da busca vetorial semântica. `memory status` simples permanece rápido e não executa trabalho ao vivo de embedding nem descoberta de provedor; estado desconhecido de armazenamento vetorial ou vetor semântico significa que ele não foi sondado nesse comando. QMD léxico `searchMode: "search"` ignora sondagens vetoriais semânticas e manutenção de embeddings mesmo com `--deep`. * `--index`: executa uma reindexação se o armazenamento estiver sujo (implica `--deep`). * `--fix`: repara bloqueios de recuperação obsoletos e normaliza metadados de promoção. * `--json`: imprime saída JSON. Se `memory status` mostrar `Dreaming status: blocked`, o cron gerenciado de dreaming está habilitado, mas o Heartbeat que o aciona não está disparando para o agente padrão. Consulte [Dreaming nunca executa](/pt-BR/concepts/dreaming#dreaming-never-runs-status-shows-blocked) para as duas causas comuns. `memory index`: * `--force`: força uma reindexação completa. `memory search`: * Entrada de consulta: passe `[query]` posicional ou `--query `. * Se ambos forem fornecidos, `--query` prevalece. * Se nenhum for fornecido, o comando sai com um erro. * `--agent `: limita o escopo a um único agente (padrão: o agente padrão). * `--max-results `: limita o número de resultados retornados. * `--min-score `: filtra correspondências de baixa pontuação. * `--json`: imprime resultados JSON. `memory promote`: Pré-visualize e aplique promoções de memória de curto prazo. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw memory promote [--apply] [--limit ] [--include-promoted] ``` * `--apply` -- grava promoções em `MEMORY.md` (padrão: apenas pré-visualização). * `--limit ` -- limita o número de candidatos mostrados. * `--include-promoted` -- inclui entradas já promovidas em ciclos anteriores. Opções completas: * Classifica candidatos de curto prazo de `memory/YYYY-MM-DD.md` usando sinais de promoção ponderados (`frequency`, `relevance`, `query diversity`, `recency`, `consolidation`, `conceptual richness`). * Usa sinais de curto prazo tanto de recuperações de memória quanto de passagens de ingestão diária, além de sinais de reforço das fases light/REM. * Quando Dreaming está habilitado, `memory-core` gerencia automaticamente um cron job que executa uma varredura completa (`light -> REM -> deep`) em segundo plano (não é necessário `openclaw cron add` manual). * `--agent `: limita o escopo a um único agente (padrão: o agente padrão). * `--limit `: máximo de candidatos a retornar/aplicar. * `--min-score `: pontuação mínima ponderada de promoção. * `--min-recall-count `: contagem mínima de recuperações exigida para um candidato. * `--min-unique-queries `: contagem mínima de consultas distintas exigida para um candidato. * `--apply`: acrescenta os candidatos selecionados a `MEMORY.md` e os marca como promovidos. * `--include-promoted`: inclui candidatos já promovidos na saída. * `--json`: imprime saída JSON. `memory promote-explain`: Explique um candidato específico à promoção e o detalhamento de sua pontuação. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw memory promote-explain [--agent ] [--include-promoted] [--json] ``` * ``: chave do candidato, fragmento de caminho ou fragmento de trecho para procurar. * `--agent `: limita o escopo a um único agente (padrão: o agente padrão). * `--include-promoted`: inclui candidatos já promovidos. * `--json`: imprime saída JSON. `memory rem-harness`: Pré-visualize reflexões REM, verdades candidatas e saída de promoção profunda sem gravar nada. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw memory rem-harness [--agent ] [--include-promoted] [--json] ``` * `--agent `: limita o escopo a um único agente (padrão: o agente padrão). * `--include-promoted`: inclui candidatos profundos já promovidos. * `--json`: imprime saída JSON. ## Dreaming Dreaming é o sistema em segundo plano de consolidação de memória com três fases cooperativas: **light** (ordenar/preparar material de curto prazo), **deep** (promover fatos duráveis para `MEMORY.md`) e **REM** (refletir e destacar temas). * Habilite com `plugins.entries.memory-core.config.dreaming.enabled: true`. * Alterne pelo chat com `/dreaming on|off` (ou inspecione com `/dreaming status`). Chamadores de canal devem ser proprietários para alterar a configuração; clientes Gateway precisam de `operator.admin`. Status somente leitura e ajuda continuam disponíveis para remetentes de comandos autorizados. * Dreaming é executado em uma programação de varredura gerenciada (`dreaming.frequency`) e executa as fases em ordem: light, REM, deep. * Somente a fase deep grava memória durável em `MEMORY.md`. * Saída de fase legível por humanos e entradas de diário são gravadas em `DREAMS.md` (ou no `dreams.md` existente), com relatórios opcionais por fase em `memory/dreaming//YYYY-MM-DD.md`. * A classificação usa sinais ponderados: frequência de recuperação, relevância de recuperação, diversidade de consultas, recência temporal, consolidação entre dias e riqueza conceitual derivada. * A promoção relê a nota diária ao vivo antes de gravar em `MEMORY.md`, para que trechos de curto prazo editados ou excluídos não sejam promovidos a partir de snapshots obsoletos do armazenamento de recuperação. * Execuções agendadas e manuais de `memory promote` compartilham os mesmos padrões da fase deep, a menos que você passe substituições de limites pela CLI. * Execuções automáticas se espalham por workspaces de memória configurados. Agendamento padrão: * **Cadência de varredura**: `dreaming.frequency = 0 3 * * *` * **Limites de deep**: `minScore=0.8`, `minRecallCount=3`, `minUniqueQueries=3`, `recencyHalfLifeDays=14`, `maxAgeDays=30` Exemplo: ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "plugins": { "entries": { "memory-core": { "config": { "dreaming": { "enabled": true } } } } } } ``` Observações: * `memory index --verbose` imprime detalhes por fase (provedor, modelo, fontes, atividade em lote). * `memory status` inclui quaisquer caminhos extras configurados via `memorySearch.extraPaths`. * Se campos de chave de API remota de Active Memory efetivamente ativos estiverem configurados como SecretRefs, o comando resolve esses valores a partir do snapshot ativo do Gateway. Se o gateway estiver indisponível, o comando falha rapidamente. * Observação sobre incompatibilidade de versão do Gateway: este caminho de comando requer um gateway que ofereça suporte a `secrets.resolve`; gateways mais antigos retornam um erro de método desconhecido. * Ajuste a cadência da varredura agendada com `dreaming.frequency`. A política de promoção deep é interna, exceto por `dreaming.phases.deep.maxPromotedSnippetTokens`, que limita o tamanho do trecho promovido mantendo a proveniência visível. Use flags de CLI em `memory promote` quando precisar de substituições manuais pontuais de limites. * `memory rem-harness --path --grounded` pré-visualiza `What Happened`, `Reflections` e `Possible Lasting Updates` fundamentados a partir de notas diárias históricas sem gravar nada. * `memory rem-backfill --path ` grava entradas reversíveis de diário fundamentado em `DREAMS.md` para revisão na UI. * `memory rem-backfill --path --stage-short-term` também semeia candidatos duráveis fundamentados no armazenamento ativo de promoção de curto prazo para que a fase deep normal possa classificá-los. * `memory rem-backfill --rollback` remove entradas de diário fundamentado gravadas anteriormente, e `memory rem-backfill --rollback-short-term` remove candidatos fundamentados de curto prazo preparados anteriormente. * Consulte [Dreaming](/pt-BR/concepts/dreaming) para descrições completas das fases e referência de configuração. ## Relacionados * [Referência da CLI](/pt-BR/cli) * [Visão geral da memória](/pt-BR/concepts/memory)