A wiki de memória do OpenClaw

Notas de memória simples respondem ao que o agente lembra; elas não dizem o quanto ele tem certeza, de onde veio um fato ou quais duas notas se contradizem. O plugin integrado memory-wiki do OpenClaw adiciona essa camada. Ele compila conhecimento durável em uma wiki navegável de páginas determinísticas, afirmações estruturadas com evidências, proveniência, painéis e digests legíveis por máquina, e fica ao lado do plugin de memória ativo em vez de substituí-lo: a recuperação, a promoção, a indexação e o dreaming continuam com o plugin de memória configurado. Aqui estão os modos de cofre, a estrutura, o modelo de afirmações, o pipeline de compilação, os relatórios, as ferramentas e as ressalvas sobre cofres por agente.

Modos, escopo, estrutura

• Três modos de cofre: isolated, o padrão, com cofre e fontes próprios e sem dependência do plugin de memória; bridge, que lê artefatos públicos de memória e logs de eventos do plugin de memória ativo pelos pontos de extensão públicos do SDK de plugins, indexando artefatos exportados, notas diárias, relatórios de dreaming e logs de eventos de memória conforme cada opção; e unsafe-local, uma válvula de escape explícita na mesma máquina para caminhos privados, experimental e não portável.
• O escopo do cofre é uma escolha separada: global, o padrão, mantém um único cofre compartilhado, enquanto o escopo agent dá a cada agente um cofre filho, para que os agentes não compartilhem páginas, digests, resultados de busca nem escritas; o escopo agent não pode ser combinado com o modo unsafe-local, e a validação o rejeita.
• O cofre contém notas de agente e de wiki no nível superior, um índice e uma caixa de entrada, além de pastas para entidades, conceitos, sínteses, fontes, relatórios, anexos e visões; o conteúdo gerenciado fica dentro de blocos gerados, e os blocos de notas humanas sobrevivem à regeneração.
• Pacotes no Open Knowledge Format são importados como páginas de conceito, mantendo o frontmatter original de id do conceito, tipo, recurso, tags, timestamp e produtor, com os links internos reescritos para páginas da wiki e emitidos como relacionamentos estruturados.

Isso faz a wiki se comportar como uma camada de crenças, não como um depósito passivo de notas.

Afirmações, entidades, compilação

As páginas trazem afirmações estruturadas no frontmatter, cada uma com um id, texto, status, confiança, entradas de evidência e um horário de atualização, em que a evidência traz um tipo, id da fonte, caminho, linhas, peso, confiança, nível de privacidade e nota; as afirmações podem ser rastreadas, pontuadas, contestadas e resolvidas até as fontes. As páginas de entidade adicionam metadados de roteamento utilizáveis para pessoas, equipes, sistemas ou projetos: um tipo de entidade, um id canônico, aliases, um nível de privacidade em que qualquer coisa diferente de public é sinalizada para revisão, dicas best-used-for e not-enough-for, um timestamp de atualização, um cartão de pessoa opcional com identificadores, redes sociais, e-mails, fuso horário, área de atuação e listas ask-for e avoid-asking-for, e relacionamentos tipados. A compilação lê as páginas, normaliza os resumos e persiste um snapshot voltado para máquinas no estado de plugins SQLite compartilhado do OpenClaw; a preparação do prompt em tempo de execução carrega esse snapshot de forma assíncrona e nunca faz scraping de Markdown nem lê arquivos de cache, edições nas fontes só ficam visíveis para a máquina depois da próxima compilação, e uma publicação de compilação encadeada causalmente permite que uma atualização do ciclo de vida rejeite um snapshot vindo de um estado mais novo que foi revertido. Os caches compilados podem ser reconstruídos e são substituídos, não migrados.

Relatórios, busca, ferramentas

• Com os painéis ativados, a compilação mantém relatórios de perguntas em aberto, contradições, páginas e afirmações de baixa confiança, afirmações sem evidência estruturada, páginas desatualizadas, o diretório de pessoas e agentes, o grafo de relacionamentos, a cobertura de proveniência e uma revisão de privacidade dos níveis não públicos.
• A busca tem um backend compartilhado, que usa o fluxo de busca da memória quando disponível, e um local, que busca só na wiki; três corpora, wiki, memory e all; e cinco modos: auto, find-person, route-question, source-evidence e raw-claim; um resultado em uma afirmação estruturada retorna o id, o status, a confiança, os tipos de evidência e os ids de fonte da afirmação, e afirmações contestadas, desatualizadas ou recentes influenciam o ranking.
• Cinco ferramentas de agente: wiki status, wiki search, wiki get, wiki apply, para mutações restritas de sínteses e metadados sem cirurgia livre nas páginas, e wiki lint, para verificações estruturais, lacunas de proveniência, contradições e perguntas em aberto; o plugin também registra um suplemento de corpus não exclusivo para que a busca e o get compartilhados da memória alcancem a wiki quando o plugin de memória suporta seleção de corpus.

A memória do OpenClaw explicada é a camada ao lado da qual esse plugin fica, e a busca na memória do OpenClaw, a passada ampla de recuperação que a documentação ainda recomenda fazer primeiro.

A interface e as ressalvas

A interface de controle navega pela wiki compilada a partir da página de memória, nas abas Dreams e Diary, agrupando páginas de síntese, entidade e conceito com contagens por página, abrindo o conteúdo inline pela mesma consulta que a ferramenta get usa, limitando cada painel aos 2 500 cartões mais recentes, e nunca varrendo páginas brutas do cofre nem esperando uma compilação completa. O digest compilado pode ser anexado às seções de memória do prompt, com as principais páginas e afirmações e as contagens de contradições e perguntas, mas é opcional porque muda o formato do prompt. Mudar o escopo do cofre não copia nem divide um cofre existente, e cofres por agente são uma fronteira de conhecimento dentro do mesmo processo, não uma fronteira do sistema operacional, já que ferramentas fora de sandbox com acesso ao sistema de arquivos do host ainda podem ler o diretório de outro agente. O dreaming do OpenClaw é a consolidação própria do plugin de memória que o modo bridge pode indexar, e o sandboxing do OpenClaw explicado, a fronteira que a documentação indica quando os agentes não confiam uns nos outros.

Na Diali

Na Diali, o plugin vem com a imagem do motor, e o cofre dele fica no volume persistente do assistente, sob o diretório de estado, depois de ativado; a fronteira por agente importa menos aqui, já que cada instância roda o próprio assistente. O OpenClaw hospedado na Diali é o assistente, e os plugins do OpenClaw explica como os plugins integrados são ativados.

• Uma camada de crenças ao lado da memória, não um substituto para ela.
• Afirmações com evidências, compiladas no SQLite, exibidas em painéis.
• Isolated por padrão; bridge para indexar o que a memória exporta.