Plugins

Wiki de memória

memory-wiki é um Plugin incluído que transforma memória durável em um cofre de conhecimento compilado.

Ele não substitui o Plugin de Active Memory. O Plugin de Active Memory ainda controla recuperação, promoção, indexação e dreaming. memory-wiki fica ao lado dele e compila conhecimento durável em uma wiki navegável com páginas determinísticas, declarações estruturadas, proveniência, painéis e resumos legíveis por máquina.

Use quando você quiser que a memória se comporte mais como uma camada de conhecimento mantida e menos como uma pilha de arquivos Markdown.

O que ele adiciona

Um cofre de wiki dedicado com layout de páginas determinístico
Metadados estruturados de declarações e evidências, não apenas prosa
Proveniência, confiança, contradições e perguntas em aberto no nível da página
Resumos compilados para consumidores de agente/runtime
Ferramentas nativas da wiki para buscar/obter/aplicar/verificar
Modo ponte opcional que importa artefatos públicos do Plugin de Active Memory
Modo de renderização opcional amigável ao Obsidian e integração com CLI

Como ele se encaixa com a memória

Pense na divisão assim:

Camada	Controla
Plugin de Active Memory (`memory-core`, QMD, Honcho etc.)	Recuperação, busca semântica, promoção, dreaming, runtime de memória
`memory-wiki`	Páginas de wiki compiladas, sínteses ricas em proveniência, painéis, busca/get/apply específicos da wiki

Se o Plugin de Active Memory expuser artefatos de recuperação compartilhados, o OpenClaw pode pesquisar as duas camadas em uma única passagem com memory_search corpus=all.

Quando você precisar de ranqueamento específico da wiki, proveniência ou acesso direto a páginas, use as ferramentas nativas da wiki.

Padrão híbrido recomendado

Um bom padrão inicial para configurações local-first é:

QMD como backend de Active Memory para recuperação e busca semântica ampla
memory-wiki em modo bridge para páginas duráveis de conhecimento sintetizado

Essa divisão funciona bem porque cada camada permanece focada:

O QMD mantém notas brutas, exportações de sessão e coleções extras pesquisáveis
memory-wiki compila entidades estáveis, declarações, painéis e páginas de origem

Regra prática:

use memory_search quando quiser uma passagem ampla de recuperação pela memória
use wiki_search e wiki_get quando quiser resultados da wiki cientes de proveniência
use memory_search corpus=all quando quiser que a busca compartilhada abranja as duas camadas

Se o modo ponte relatar zero artefatos exportados, o Plugin de Active Memory não está expondo entradas públicas de ponte no momento. Execute openclaw wiki doctor primeiro, depois confirme se o Plugin de Active Memory oferece suporte a artefatos públicos.

Quando o modo ponte está ativo e bridge.readMemoryArtifacts está habilitado, openclaw wiki status, openclaw wiki doctor e openclaw wiki bridge import leem por meio do Gateway em execução. Isso mantém as verificações de ponte da CLI alinhadas com o contexto do Plugin de memória em runtime. Se a ponte estiver desativada ou as leituras de artefatos estiverem desligadas, esses comandos mantêm seu comportamento local/offline.

Modos de cofre

memory-wiki oferece suporte a três modos de cofre:

`isolated`

Cofre próprio, fontes próprias, sem dependência de memory-core.

Use quando quiser que a wiki seja seu próprio repositório curado de conhecimento.

`bridge`

Lê artefatos públicos de memória e eventos de memória do Plugin de Active Memory por meio de interfaces públicas do SDK de Plugin.

Use quando quiser que a wiki compile e organize os artefatos exportados pelo Plugin de memória sem acessar partes internas privadas do Plugin.

O modo ponte pode indexar:

artefatos de memória exportados
relatórios de sonho
notas diárias
arquivos raiz de memória
logs de eventos de memória

`unsafe-local`

Saída de emergência explícita na mesma máquina para caminhos locais privados.

Esse modo é intencionalmente experimental e não portátil. Use apenas quando você entender o limite de confiança e precisar especificamente de acesso ao sistema de arquivos local que o modo ponte não consegue fornecer.

Layout do cofre

O Plugin inicializa um cofre assim:

<vault>/
  AGENTS.md
  WIKI.md
  index.md
  inbox.md
  entities/
  concepts/
  syntheses/
  sources/
  reports/
  _attachments/
  _views/
  .openclaw-wiki/

O conteúdo gerenciado permanece dentro de blocos gerados. Blocos de notas humanas são preservados.

Os principais grupos de páginas são:

sources/ para material bruto importado e páginas apoiadas por ponte
entities/ para coisas, pessoas, sistemas, projetos e objetos duráveis
concepts/ para ideias, abstrações, padrões e políticas
syntheses/ para resumos compilados e agregações mantidas
reports/ para painéis gerados

Declarações estruturadas e evidências

As páginas podem carregar frontmatter claims estruturado, não apenas texto livre.

Cada declaração pode incluir:

id
text
status
confidence
evidence[]
updatedAt

Entradas de evidência podem incluir:

kind
sourceId
path
lines
weight
confidence
privacyTier
note
updatedAt

Isso é o que faz a wiki agir mais como uma camada de crenças do que como um despejo passivo de notas. As declarações podem ser rastreadas, pontuadas, contestadas e resolvidas de volta às fontes.

Metadados de entidade voltados para agentes

Páginas de entidade também podem carregar metadados de roteamento para uso por agentes. Isso é frontmatter genérico, então funciona para pessoas, equipes, sistemas, projetos ou qualquer outro tipo de entidade.

Campos comuns incluem:

entityType: por exemplo person, team, system ou project
canonicalId: chave de identidade estável usada entre aliases e importações
aliases: nomes, identificadores ou rótulos que devem resolver para a mesma página
privacyTier: public, local-private, sensitive ou confirm-before-use
bestUsedFor / notEnoughFor: dicas compactas de roteamento
lastRefreshedAt: carimbo de data/hora de atualização de fonte separado do horário de edição da página
personCard: cartão opcional de roteamento específico de pessoa com identificadores, redes sociais, emails, fuso horário, trilha, pedir-sobre, evitar-pedir-sobre, confiança e privacidade
relationships: arestas tipadas para páginas relacionadas com alvo, tipo, peso, confiança, tipo de evidência, nível de privacidade e nota

Para uma wiki de pessoas, o agente normalmente deve começar com reports/person-agent-directory.md, depois abrir a página da pessoa com wiki_get antes de usar detalhes de contato ou fatos inferidos.

Exemplo:

pageType: entity
entityType: person
id: entity.brad-groux
canonicalId: maintainer.brad-groux
aliases:
  - Brad
  - bgroux
privacyTier: local-private
bestUsedFor:
  - Microsoft Teams and Azure routing
notEnoughFor:
  - legal approval
lastRefreshedAt: "2026-04-29T00:00:00.000Z"
personCard:
  handles:
    - "@bgroux"
  socials:
    - "https://x.example/bgroux"
  emails:
    - [email protected]
  timezone: America/Chicago
  lane: Microsoft ecosystem
  askFor:
    - Teams rollout questions
  avoidAskingFor:
    - unrelated billing decisions
  confidence: 0.8
  privacyTier: confirm-before-use
relationships:
  - targetId: entity.alice
    targetTitle: Alice
    kind: collaborates-with
    confidence: 0.7
    evidenceKind: discrawl-stat
claims:
  - id: claim.brad.teams
    text: Brad is useful for Microsoft Teams routing.
    status: supported
    confidence: 0.9
    evidence:
      - kind: maintainer-whois
        sourceId: source.maintainers
        privacyTier: local-private

Pipeline de compilação

A etapa de compilação lê páginas da wiki, normaliza resumos e emite artefatos estáveis voltados para máquina em:

.openclaw-wiki/cache/agent-digest.json
.openclaw-wiki/cache/claims.jsonl

Esses resumos existem para que agentes e código de runtime não precisem raspar páginas Markdown.

A saída compilada também alimenta:

indexação inicial da wiki para fluxos de search/get
busca de id de declaração de volta para as páginas proprietárias
suplementos compactos de prompt
geração de relatórios/painéis

Painéis e relatórios de saúde

Quando render.createDashboards está habilitado, a compilação mantém painéis em reports/.

Relatórios integrados incluem:

reports/open-questions.md
reports/contradictions.md
reports/low-confidence.md
reports/claim-health.md
reports/stale-pages.md
reports/person-agent-directory.md
reports/relationship-graph.md
reports/provenance-coverage.md
reports/privacy-review.md

Esses relatórios acompanham coisas como:

clusters de notas de contradição
clusters de declarações concorrentes
declarações sem evidência estruturada
páginas e declarações de baixa confiança
atualização obsoleta ou desconhecida
páginas com perguntas não resolvidas
cartões de roteamento de pessoa/entidade
arestas de relacionamento estruturadas
cobertura de classes de evidência
níveis de privacidade não públicos que precisam de revisão antes do uso

Busca e recuperação

memory-wiki oferece suporte a dois backends de busca:

shared: use o fluxo compartilhado de busca de memória quando disponível
local: pesquise a wiki localmente

Ele também oferece suporte a três corpora:

wiki
memory
all

Comportamento importante:

wiki_search e wiki_get usam resumos compilados como primeira passagem quando possível
ids de declarações podem resolver de volta para a página proprietária
declarações contestadas/obsoletas/frescas influenciam o ranqueamento
rótulos de proveniência podem sobreviver nos resultados
o modo de busca pode enviesar o ranqueamento para busca de pessoa, roteamento de perguntas, evidência de origem ou declarações brutas

Regra prática:

use memory_search corpus=all para uma passagem ampla de recuperação
use wiki_search + wiki_get quando você se importar com ranqueamento específico da wiki, proveniência ou estrutura de crenças no nível da página

Modos de busca:

auto: padrão equilibrado
find-person: prioriza entidades semelhantes a pessoas, aliases, identificadores, redes sociais e IDs canônicos
route-question: prioriza cartões de agentes, dicas de ask-for, dicas de best-used-for e contexto de relacionamento
source-evidence: prioriza páginas de origem e metadados de evidência estruturada
raw-claim: prioriza declarações estruturadas correspondentes e retorna metadados de declaração/evidência nos resultados

Quando um resultado corresponde a uma declaração estruturada, wiki_search pode retornar matchedClaimId, matchedClaimStatus, matchedClaimConfidence, evidenceKinds e evidenceSourceIds em sua carga de detalhes. A saída em texto também inclui linhas compactas Claim: e Evidence: quando disponíveis.

Ferramentas de agente

O Plugin registra estas ferramentas:

wiki_status
wiki_search
wiki_get
wiki_apply
wiki_lint

O que elas fazem:

wiki_status: modo atual do cofre, saúde, disponibilidade da CLI do Obsidian
wiki_search: pesquisa páginas da wiki e, quando configurado, corpora de memória compartilhada; aceita mode para busca de pessoa, roteamento de perguntas, evidência de origem ou aprofundamento em declaração bruta
wiki_get: lê uma página da wiki por id/caminho ou recorre ao corpus de memória compartilhada
wiki_apply: mutações estreitas de síntese/metadados sem cirurgia livre na página
wiki_lint: verificações estruturais, lacunas de proveniência, contradições, perguntas em aberto

O Plugin também registra um suplemento de corpus de memória não exclusivo, para que memory_search e memory_get compartilhados possam acessar a wiki quando o Plugin de Active Memory oferecer suporte à seleção de corpus.

Comportamento de prompt e contexto

Quando context.includeCompiledDigestPrompt está habilitado, seções de prompt de memória anexam um instantâneo compilado compacto de agent-digest.json.

Esse instantâneo é intencionalmente pequeno e de alto sinal:

apenas páginas principais
apenas declarações principais
contagem de contradições
contagem de perguntas
qualificadores de confiança/atualização

Isso é opt-in porque altera o formato do prompt e é principalmente útil para mecanismos de contexto ou montagem legada de prompt que consomem explicitamente suplementos de memória.

Configuração

Coloque a configuração em plugins.entries.memory-wiki.config:

{
  plugins: {
    entries: {
      "memory-wiki": {
        enabled: true,
        config: {
          vaultMode: "isolated",
          vault: {
            path: "~/.openclaw/wiki/main",
            renderMode: "obsidian",
          },
          obsidian: {
            enabled: true,
            useOfficialCli: true,
            vaultName: "OpenClaw Wiki",
            openAfterWrites: false,
          },
          bridge: {
            enabled: false,
            readMemoryArtifacts: true,
            indexDreamReports: true,
            indexDailyNotes: true,
            indexMemoryRoot: true,
            followMemoryEvents: true,
          },
          ingest: {
            autoCompile: true,
            maxConcurrentJobs: 1,
            allowUrlIngest: true,
          },
          search: {
            backend: "shared",
            corpus: "wiki",
          },
          context: {
            includeCompiledDigestPrompt: false,
          },
          render: {
            preserveHumanBlocks: true,
            createBacklinks: true,
            createDashboards: true,
          },
        },
      },
    },
  },
}

Alternâncias principais:

vaultMode: isolated, bridge, unsafe-local
vault.renderMode: native ou obsidian
bridge.readMemoryArtifacts: importar artefatos públicos do Plugin de Active Memory
bridge.followMemoryEvents: incluir logs de eventos no modo bridge
search.backend: shared ou local
search.corpus: wiki, memory ou all
context.includeCompiledDigestPrompt: anexar instantâneo compacto de resumo às seções de prompt de memória
render.createBacklinks: gerar blocos relacionados determinísticos
render.createDashboards: gerar páginas de painel

Exemplo: QMD + modo bridge

Use isto quando quiser QMD para recuperação e memory-wiki para uma camada de conhecimento mantida:

{
  memory: {
    backend: "qmd",
  },
  plugins: {
    entries: {
      "memory-wiki": {
        enabled: true,
        config: {
          vaultMode: "bridge",
          bridge: {
            enabled: true,
            readMemoryArtifacts: true,
            indexDreamReports: true,
            indexDailyNotes: true,
            indexMemoryRoot: true,
            followMemoryEvents: true,
          },
          search: {
            backend: "shared",
            corpus: "all",
          },
          context: {
            includeCompiledDigestPrompt: false,
          },
        },
      },
    },
  },
}

Isso mantém:

QMD responsável pela recuperação de Active Memory
memory-wiki focado em páginas compiladas e painéis
o formato do prompt inalterado até você habilitar intencionalmente prompts de resumo compilado

CLI

memory-wiki também expõe uma superfície de CLI de nível superior:

openclaw wiki status
openclaw wiki doctor
openclaw wiki init
openclaw wiki ingest ./notes/alpha.md
openclaw wiki compile
openclaw wiki lint
openclaw wiki search "alpha"
openclaw wiki get entity.alpha
openclaw wiki apply synthesis "Alpha Summary" --body "..." --source-id source.alpha
openclaw wiki bridge import
openclaw wiki obsidian status

Consulte CLI: wiki para a referência completa de comandos.

Suporte ao Obsidian

Quando vault.renderMode é obsidian, o Plugin grava Markdown compatível com Obsidian e pode, opcionalmente, usar a CLI oficial obsidian.

Os fluxos de trabalho compatíveis incluem:

sondagem de status
busca no cofre
abertura de uma página
invocação de um comando do Obsidian
salto para a nota diária

Isso é opcional. A wiki ainda funciona no modo nativo sem Obsidian.

Fluxo de trabalho recomendado

Mantenha seu Plugin de Active Memory para recuperação/promoção/Dreaming.
Habilite memory-wiki.
Comece com o modo isolated, a menos que queira explicitamente o modo bridge.
Use wiki_search / wiki_get quando a procedência for importante.
Use wiki_apply para sínteses restritas ou atualizações de metadados.
Execute wiki_lint após alterações significativas.
Ative painéis se quiser visibilidade sobre itens obsoletos/contradições.

Wiki de memória

O que ele adiciona

Como ele se encaixa com a memória

Padrão híbrido recomendado

Modos de cofre

`isolated`

`bridge`

`unsafe-local`

Layout do cofre

Declarações estruturadas e evidências

Metadados de entidade voltados para agentes

Pipeline de compilação

Painéis e relatórios de saúde

Busca e recuperação

Ferramentas de agente

Comportamento de prompt e contexto

Configuração

Exemplo: QMD + modo bridge

CLI

Suporte ao Obsidian

Fluxo de trabalho recomendado

Documentos relacionados

Ask OpenClaw

# O que ele adiciona

# Como ele se encaixa com a memória

# Padrão híbrido recomendado

# Modos de cofre

# isolated

# bridge

# unsafe-local

# Layout do cofre

# Declarações estruturadas e evidências

# Metadados de entidade voltados para agentes

# Pipeline de compilação

# Painéis e relatórios de saúde

# Busca e recuperação

# Ferramentas de agente

# Comportamento de prompt e contexto

# Configuração

# Exemplo: QMD + modo bridge

# CLI

# Suporte ao Obsidian

# Fluxo de trabalho recomendado

# Documentos relacionados

O que ele adiciona

Como ele se encaixa com a memória

Padrão híbrido recomendado

Modos de cofre

`isolated`

`bridge`

`unsafe-local`

Layout do cofre

Declarações estruturadas e evidências

Metadados de entidade voltados para agentes

Pipeline de compilação

Painéis e relatórios de saúde

Busca e recuperação

Ferramentas de agente

Comportamento de prompt e contexto

Configuração

Exemplo: QMD + modo bridge

CLI

Suporte ao Obsidian

Fluxo de trabalho recomendado

Documentos relacionados