Plugins

메모리 위키

memory-wiki는 지속 메모리를 컴파일된 지식 저장소로 바꾸는 번들 Plugin입니다.

이는 Active Memory Plugin을 대체하지 않습니다. Active Memory Plugin은 계속 회상, 승격, 색인, Dreaming을 담당합니다. memory-wiki는 그 옆에서 지속 지식을 결정적 페이지, 구조화된 주장, 출처, 대시보드, 기계가 읽을 수 있는 다이제스트를 갖춘 탐색 가능한 위키로 컴파일합니다.

메모리가 Markdown 파일 더미에 가깝기보다 관리되는 지식 계층처럼 동작하기를 원할 때 사용하세요.

추가되는 기능

결정적 페이지 레이아웃을 갖춘 전용 위키 저장소
단순한 산문이 아닌 구조화된 주장 및 증거 메타데이터
페이지 수준의 출처, 신뢰도, 모순, 열린 질문
에이전트/런타임 소비자를 위한 컴파일된 다이제스트
위키 네이티브 검색/가져오기/적용/린트 도구
Active Memory Plugin의 공개 아티팩트를 가져오는 선택적 브리지 모드
선택적 Obsidian 친화적 렌더링 모드 및 CLI 통합

메모리와 맞물리는 방식

분리를 다음과 같이 생각하세요.

계층	담당
Active Memory Plugin(`memory-core`, QMD, Honcho 등)	회상, 의미 검색, 승격, Dreaming, 메모리 런타임
`memory-wiki`	컴파일된 위키 페이지, 출처가 풍부한 합성, 대시보드, 위키 전용 검색/가져오기/적용

Active Memory Plugin이 공유 회상 아티팩트를 노출하면, OpenClaw는 memory_search corpus=all로 두 계층을 한 번에 검색할 수 있습니다.

위키 전용 랭킹, 출처, 직접 페이지 접근이 필요할 때는 대신 위키 네이티브 도구를 사용하세요.

권장 하이브리드 패턴

로컬 우선 설정의 강력한 기본값은 다음과 같습니다.

회상 및 광범위한 의미 검색을 위한 Active Memory 백엔드로 QMD 사용
지속 합성 지식 페이지를 위한 bridge 모드의 memory-wiki

이 분리는 각 계층이 집중할 수 있기 때문에 잘 작동합니다.

QMD는 원시 노트, 세션 내보내기, 추가 컬렉션을 검색 가능하게 유지합니다
memory-wiki는 안정적인 엔터티, 주장, 대시보드, 소스 페이지를 컴파일합니다

실용적인 규칙:

메모리 전반에 걸친 하나의 광범위한 회상 패스가 필요하면 memory_search를 사용하세요
출처를 인식하는 위키 결과가 필요하면 wiki_search와 wiki_get을 사용하세요
공유 검색이 두 계층을 모두 포괄해야 하면 memory_search corpus=all을 사용하세요

브리지 모드가 내보낸 아티팩트가 0개라고 보고하면, Active Memory Plugin이 아직 공개 브리지 입력을 노출하고 있지 않은 것입니다. 먼저 openclaw wiki doctor를 실행한 다음, Active Memory Plugin이 공개 아티팩트를 지원하는지 확인하세요.

브리지 모드가 활성화되어 있고 bridge.readMemoryArtifacts가 활성화된 경우, openclaw wiki status, openclaw wiki doctor, openclaw wiki bridge import는 실행 중인 Gateway를 통해 읽습니다. 이렇게 하면 CLI 브리지 검사가 런타임 메모리 Plugin 컨텍스트와 정렬됩니다. 브리지가 비활성화되어 있거나 아티팩트 읽기가 꺼져 있으면, 해당 명령은 로컬/오프라인 동작을 유지합니다.

저장소 모드

memory-wiki는 세 가지 저장소 모드를 지원합니다.

`isolated`

자체 저장소, 자체 소스, memory-core에 대한 의존성 없음.

위키가 자체 큐레이션된 지식 저장소가 되기를 원할 때 사용하세요.

`bridge`

공개 Plugin SDK 이음새를 통해 Active Memory Plugin에서 공개 메모리 아티팩트와 메모리 이벤트를 읽습니다.

비공개 Plugin 내부에 접근하지 않고 메모리 Plugin의 내보낸 아티팩트를 컴파일하고 정리하려는 경우 사용하세요.

브리지 모드는 다음을 색인할 수 있습니다.

내보낸 메모리 아티팩트
Dream 보고서
일일 노트
메모리 루트 파일
메모리 이벤트 로그

`unsafe-local`

로컬 비공개 경로를 위한 명시적인 동일 머신 탈출구.

이 모드는 의도적으로 실험적이며 이식성이 없습니다. 신뢰 경계를 이해하고 브리지 모드가 제공할 수 없는 로컬 파일 시스템 접근이 구체적으로 필요할 때만 사용하세요.

저장소 레이아웃

Plugin은 다음과 같이 저장소를 초기화합니다.

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

관리되는 콘텐츠는 생성된 블록 안에 유지됩니다. 사람이 작성한 노트 블록은 보존됩니다.

주요 페이지 그룹은 다음과 같습니다.

가져온 원자료 및 브리지 기반 페이지를 위한 sources/
지속적인 사물, 사람, 시스템, 프로젝트, 객체를 위한 entities/
아이디어, 추상화, 패턴, 정책을 위한 concepts/
컴파일된 요약 및 관리되는 롤업을 위한 syntheses/
생성된 대시보드를 위한 reports/

구조화된 주장과 증거

페이지는 자유 형식 텍스트뿐 아니라 구조화된 claims frontmatter를 가질 수 있습니다.

각 주장은 다음을 포함할 수 있습니다.

id
text
status
confidence
evidence[]
updatedAt

증거 항목은 다음을 포함할 수 있습니다.

kind
sourceId
path
lines
weight
confidence
privacyTier
note
updatedAt

이것이 위키를 수동적인 노트 덤프보다 믿음 계층에 더 가깝게 작동하게 만드는 요소입니다. 주장은 추적, 점수화, 이의 제기, 소스로의 해결이 가능합니다.

에이전트 대상 엔터티 메타데이터

엔터티 페이지는 에이전트 사용을 위한 라우팅 메타데이터도 가질 수 있습니다. 이는 일반적인 frontmatter이므로 사람, 팀, 시스템, 프로젝트 또는 다른 모든 엔터티 유형에 사용할 수 있습니다.

일반적인 필드는 다음과 같습니다.

entityType: 예: person, team, system, 또는 project
canonicalId: 별칭과 가져오기 전반에서 사용되는 안정적인 식별 키
aliases: 같은 페이지로 확인되어야 하는 이름, 핸들 또는 레이블
privacyTier: public, local-private, sensitive, 또는 confirm-before-use
bestUsedFor / notEnoughFor: 간결한 라우팅 힌트
lastRefreshedAt: 페이지 편집 시간과 별개인 소스 새로고침 타임스탬프
personCard: 핸들, 소셜, 이메일, 시간대, 레인, 요청 대상, 요청을 피할 대상, 신뢰도, 개인정보 등급을 포함하는 선택적 사람별 라우팅 카드
relationships: 대상, 종류, 가중치, 신뢰도, 증거 종류, 개인정보 등급, 노트가 포함된 관련 페이지로의 유형화된 엣지

사람 위키의 경우, 에이전트는 일반적으로 reports/person-agent-directory.md에서 시작한 다음 연락처 세부 정보나 추론된 사실을 사용하기 전에 wiki_get으로 사람 페이지를 열어야 합니다.

예:

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

컴파일 파이프라인

컴파일 단계는 위키 페이지를 읽고, 요약을 정규화하며, 다음 위치 아래에 안정적인 기계 대상 아티팩트를 내보냅니다.

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

이러한 다이제스트는 에이전트와 런타임 코드가 Markdown 페이지를 스크래핑하지 않아도 되도록 존재합니다.

컴파일된 출력은 다음에도 사용됩니다.

검색/가져오기 흐름을 위한 1차 위키 색인
claim-id에서 소유 페이지로의 조회
간결한 프롬프트 보충 자료
보고서/대시보드 생성

대시보드와 상태 보고서

render.createDashboards가 활성화되면 컴파일이 reports/ 아래의 대시보드를 유지합니다.

기본 제공 보고서는 다음과 같습니다.

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

이 보고서는 다음과 같은 항목을 추적합니다.

모순 노트 클러스터
경쟁하는 주장 클러스터
구조화된 증거가 누락된 주장
신뢰도가 낮은 페이지와 주장
오래되었거나 알 수 없는 최신성
해결되지 않은 질문이 있는 페이지
사람/엔터티 라우팅 카드
구조화된 관계 엣지
증거 클래스 범위
사용 전에 검토가 필요한 비공개 개인정보 등급

검색과 조회

memory-wiki는 두 가지 검색 백엔드를 지원합니다.

shared: 사용 가능한 경우 공유 메모리 검색 흐름 사용
local: 위키를 로컬에서 검색

또한 세 가지 코퍼스를 지원합니다.

wiki
memory
all

중요한 동작:

wiki_search와 wiki_get은 가능한 경우 컴파일된 다이제스트를 1차 패스로 사용합니다
claim id는 소유 페이지로 다시 확인될 수 있습니다
이의 제기된/오래된/최신 주장이 랭킹에 영향을 줍니다
출처 레이블이 결과에 유지될 수 있습니다
검색 모드는 사람 조회, 질문 라우팅, 소스 증거 또는 원시 주장에 대해 랭킹을 편향할 수 있습니다

실용적인 규칙:

하나의 광범위한 회상 패스에는 memory_search corpus=all을 사용하세요
위키 전용 랭킹, 출처 또는 페이지 수준의 믿음 구조가 중요할 때는 wiki_search + wiki_get을 사용하세요

검색 모드:

auto: 균형 잡힌 기본값
find-person: 사람 같은 엔터티, 별칭, 핸들, 소셜, 표준 ID를 강화합니다
route-question: 에이전트 카드, 요청 대상 힌트, 가장 적합한 용도 힌트, 관계 컨텍스트를 강화합니다
source-evidence: 소스 페이지와 구조화된 증거 메타데이터를 강화합니다
raw-claim: 일치하는 구조화된 주장을 강화하고 결과에 주장/증거 메타데이터를 반환합니다

결과가 구조화된 주장과 일치하면 wiki_search는 세부 정보 페이로드에 matchedClaimId, matchedClaimStatus, matchedClaimConfidence, evidenceKinds, evidenceSourceIds를 반환할 수 있습니다. 텍스트 출력도 사용 가능한 경우 간결한 Claim: 및 Evidence: 줄을 포함합니다.

에이전트 도구

Plugin은 다음 도구를 등록합니다.

wiki_status
wiki_search
wiki_get
wiki_apply
wiki_lint

각 도구의 역할:

wiki_status: 현재 저장소 모드, 상태, Obsidian CLI 사용 가능 여부
wiki_search: 위키 페이지와, 구성된 경우 공유 메모리 코퍼스를 검색합니다. 사람 조회, 질문 라우팅, 소스 증거 또는 원시 주장 드릴다운을 위한 mode를 받습니다
wiki_get: id/path로 위키 페이지를 읽거나 공유 메모리 코퍼스로 폴백합니다
wiki_apply: 자유 형식 페이지 수술 없이 좁은 범위의 합성/메타데이터 변경
wiki_lint: 구조 검사, 출처 공백, 모순, 열린 질문

Plugin은 비독점 메모리 코퍼스 보충 자료도 등록하므로, Active Memory Plugin이 코퍼스 선택을 지원할 때 공유 memory_search와 memory_get이 위키에 접근할 수 있습니다.

프롬프트와 컨텍스트 동작

context.includeCompiledDigestPrompt가 활성화되면, 메모리 프롬프트 섹션은 agent-digest.json에서 가져온 간결한 컴파일된 스냅샷을 덧붙입니다.

해당 스냅샷은 의도적으로 작고 신호가 높습니다.

상위 페이지만
상위 주장만
모순 수
질문 수
신뢰도/최신성 한정자

이는 프롬프트 형태를 바꾸며, 주로 메모리 보충 자료를 명시적으로 소비하는 컨텍스트 엔진이나 레거시 프롬프트 조립에 유용하기 때문에 선택 사항입니다.

구성

구성은 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,
          },
        },
      },
    },
  },
}

주요 토글:

vaultMode: isolated, bridge, unsafe-local
vault.renderMode: native 또는 obsidian
bridge.readMemoryArtifacts: Active Memory Plugin 공개 아티팩트 가져오기
bridge.followMemoryEvents: 브리지 모드에 이벤트 로그 포함
search.backend: shared 또는 local
search.corpus: wiki, memory 또는 all
context.includeCompiledDigestPrompt: 메모리 프롬프트 섹션에 압축된 다이제스트 스냅샷 추가
render.createBacklinks: 결정적 관련 블록 생성
render.createDashboards: 대시보드 페이지 생성

예시: QMD + 브리지 모드

회상을 위해 QMD를 사용하고 유지 관리되는 지식 계층을 위해 memory-wiki를 사용하려면 이것을 사용하세요.

{
  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,
          },
        },
      },
    },
  },
}

이렇게 하면 다음이 유지됩니다.

Active Memory 회상은 QMD가 담당
memory-wiki는 컴파일된 페이지와 대시보드에 집중
컴파일된 다이제스트 프롬프트를 의도적으로 활성화할 때까지 프롬프트 형태는 변경되지 않음

CLI

memory-wiki는 최상위 CLI 표면도 노출합니다.

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

전체 명령 참조는 CLI: wiki를 참조하세요.

Obsidian 지원

vault.renderMode가 obsidian이면 Plugin은 Obsidian 친화적인 Markdown을 작성하고, 선택적으로 공식 obsidian CLI를 사용할 수 있습니다.

지원되는 워크플로는 다음과 같습니다.

상태 조사
vault 검색
페이지 열기
Obsidian 명령 호출
데일리 노트로 이동

이는 선택 사항입니다. 위키는 Obsidian 없이 네이티브 모드에서도 계속 작동합니다.

권장 워크플로

회상/승격/Dreaming에는 Active Memory Plugin을 유지하세요.
memory-wiki를 활성화하세요.
브리지 모드를 명시적으로 원하지 않는 한 isolated 모드로 시작하세요.
출처가 중요할 때는 wiki_search / wiki_get을 사용하세요.
좁은 범위의 종합 또는 메타데이터 업데이트에는 wiki_apply를 사용하세요.
의미 있는 변경 후에는 wiki_lint를 실행하세요.
오래된 내용/모순 가시성이 필요하면 대시보드를 켜세요.

메모리 위키

추가되는 기능

메모리와 맞물리는 방식

권장 하이브리드 패턴

저장소 모드

`isolated`

`bridge`

`unsafe-local`

저장소 레이아웃

구조화된 주장과 증거

에이전트 대상 엔터티 메타데이터

컴파일 파이프라인

대시보드와 상태 보고서

검색과 조회

에이전트 도구

프롬프트와 컨텍스트 동작

구성

예시: QMD + 브리지 모드

CLI

Obsidian 지원

권장 워크플로

관련 문서

Ask OpenClaw

# 추가되는 기능

# 메모리와 맞물리는 방식

# 권장 하이브리드 패턴

# 저장소 모드

# isolated

# bridge

# unsafe-local

# 저장소 레이아웃

# 구조화된 주장과 증거

# 에이전트 대상 엔터티 메타데이터

# 컴파일 파이프라인

# 대시보드와 상태 보고서

# 검색과 조회

# 에이전트 도구

# 프롬프트와 컨텍스트 동작

# 구성

# 예시: QMD + 브리지 모드

# CLI

# Obsidian 지원

# 권장 워크플로

# 관련 문서

추가되는 기능

메모리와 맞물리는 방식

권장 하이브리드 패턴

저장소 모드

`isolated`

`bridge`

`unsafe-local`

저장소 레이아웃

구조화된 주장과 증거

에이전트 대상 엔터티 메타데이터

컴파일 파이프라인

대시보드와 상태 보고서

검색과 조회

에이전트 도구

프롬프트와 컨텍스트 동작

구성

예시: QMD + 브리지 모드

CLI

Obsidian 지원

권장 워크플로

관련 문서