메모리 위키

memory-wiki는 지속 가능한 메모리를 컴파일된 지식 볼트로 바꿔 주는 번들 plugin입니다. 이 plugin은 활성 메모리 plugin을 대체하지 않습니다. 활성 메모리 plugin은 여전히 회상, 승격, 인덱싱, dreaming을 담당합니다. memory-wiki는 그 옆에서 작동하며, 지속 가능한 지식을 탐색 가능한 위키로 컴파일해 결정적인 페이지, 구조화된 클레임, 출처, 대시보드, 기계가 읽을 수 있는 다이제스트를 제공합니다. 메모리가 Markdown 파일 더미처럼 작동하기보다 유지 관리되는 지식 계층처럼 작동하길 원한다면 이것을 사용하세요.

추가되는 기능

결정적인 페이지 레이아웃을 갖춘 전용 위키 볼트
단순한 산문이 아닌 구조화된 클레임 및 증거 메타데이터
페이지 수준의 출처, 신뢰도, 모순, 미해결 질문
에이전트/런타임 소비자를 위한 컴파일된 다이제스트
위키 전용 search/get/apply/lint 도구
활성 메모리 plugin의 공개 아티팩트를 가져오는 선택적 브리지 모드
선택적 Obsidian 친화적 렌더 모드 및 CLI 통합

메모리와의 관계

이 구분은 다음과 같이 생각하면 됩니다:

계층	담당
활성 메모리 plugin (`memory-core`, QMD, Honcho 등)	회상, 시맨틱 검색, 승격, dreaming, 메모리 런타임
`memory-wiki`	컴파일된 위키 페이지, 출처가 풍부한 종합, 대시보드, 위키 전용 search/get/apply

활성 메모리 plugin이 공유 회상 아티팩트를 노출하면 OpenClaw는 memory_search corpus=all로 한 번에 두 계층을 모두 검색할 수 있습니다. 위키 전용 순위 지정, 출처, 또는 직접 페이지 접근이 필요할 때는 대신 위키 전용 도구를 사용하세요.

볼트 모드

memory-wiki는 세 가지 볼트 모드를 지원합니다:

`isolated`

자체 볼트, 자체 소스, memory-core에 대한 의존성 없음. 위키를 자체적으로 큐레이션된 지식 저장소로 사용하고 싶다면 이 모드를 사용하세요.

`bridge`

활성 메모리 plugin의 공개 메모리 아티팩트와 메모리 이벤트를 공개 plugin SDK 경계를 통해 읽습니다. 메모리 plugin의 내보낸 아티팩트를 private plugin 내부 구현에 접근하지 않고 위키에서 컴파일하고 정리하고 싶다면 이 모드를 사용하세요. 브리지 모드는 다음을 인덱싱할 수 있습니다:

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

`unsafe-local`

로컬 private 경로를 위한, 동일 머신에서만 사용하는 명시적 탈출구입니다. 이 모드는 의도적으로 실험적이며 이식성이 없습니다. 신뢰 경계를 이해하고, 브리지 모드로는 제공할 수 없는 로컬 파일 시스템 접근이 꼭 필요할 때만 사용하세요.

볼트 레이아웃

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

증거 항목에는 다음이 포함될 수 있습니다:

sourceId
path
lines
weight
note
updatedAt

이것이 위키를 수동적인 노트 덤프가 아니라 신념 계층처럼 작동하게 만듭니다. 클레임은 추적, 점수화, 이의 제기, 소스로의 해결이 가능합니다.

컴파일 파이프라인

컴파일 단계는 위키 페이지를 읽고, 요약을 정규화한 뒤, 안정적인 기계 지향 아티팩트를 다음 경로에 출력합니다:

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

이 다이제스트는 에이전트와 런타임 코드가 Markdown 페이지를 직접 스크래핑하지 않아도 되도록 존재합니다. 컴파일된 출력은 다음에도 사용됩니다:

search/get 흐름을 위한 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

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

모순 노트 클러스터
경쟁하는 클레임 클러스터
구조화된 증거가 없는 클레임
신뢰도가 낮은 페이지와 클레임
오래되었거나 최신성 정보를 알 수 없는 항목
해결되지 않은 질문이 있는 페이지

검색 및 조회

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

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

또한 세 가지 corpus를 지원합니다:

wiki
memory
all

중요한 동작:

wiki_search와 wiki_get은 가능할 때 컴파일된 다이제스트를 1차 단계로 사용합니다
claim id는 소유 페이지로 다시 해석될 수 있습니다
이의 제기됨/오래됨/최신 클레임이 순위에 영향을 줍니다
출처 라벨은 결과까지 유지될 수 있습니다

실용적인 규칙:

폭넓은 한 번의 회상 패스에는 memory_search corpus=all을 사용하세요
위키 전용 순위 지정, 출처, 페이지 수준의 신념 구조가 중요할 때는 wiki_search + wiki_get을 사용하세요

에이전트 도구

plugin은 다음 도구를 등록합니다:

wiki_status
wiki_search
wiki_get
wiki_apply
wiki_lint

각 도구의 역할:

wiki_status: 현재 볼트 모드, 상태, Obsidian CLI 사용 가능 여부
wiki_search: 위키 페이지를 검색하고, 구성된 경우 공유 메모리 corpus도 검색
wiki_get: id/path로 위키 페이지를 읽거나 공유 메모리 corpus로 폴백
wiki_apply: 자유 형식 페이지 수술 없이 좁은 범위의 종합/메타데이터 변경 수행
wiki_lint: 구조 검사, 출처 공백, 모순, 미해결 질문 확인

또한 이 plugin은 비독점적 메모리 corpus 보조 기능도 등록하므로, 활성 메모리 plugin이 corpus 선택을 지원할 경우 공유 memory_search와 memory_get이 위키에 도달할 수 있습니다.

프롬프트 및 컨텍스트 동작

context.includeCompiledDigestPrompt가 활성화되면, 메모리 프롬프트 섹션은 agent-digest.json의 간결한 컴파일 스냅샷을 덧붙입니다. 그 스냅샷은 의도적으로 작고 신호 대비 잡음이 적습니다:

상위 페이지만
상위 클레임만
모순 개수
질문 개수
신뢰도/최신성 한정자

이 옵션은 프롬프트 형태를 바꾸며, 메모리 보조 정보를 명시적으로 소비하는 컨텍스트 엔진이나 레거시 프롬프트 조립에 주로 유용하기 때문에 opt-in입니다.

구성

구성은 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: 활성 메모리 plugin의 공개 아티팩트 가져오기
bridge.followMemoryEvents: 브리지 모드에서 이벤트 로그 포함
search.backend: shared 또는 local
search.corpus: wiki, memory, 또는 all
context.includeCompiledDigestPrompt: 메모리 프롬프트 섹션에 간결한 다이제스트 스냅샷 추가
render.createBacklinks: 결정적인 관련 블록 생성
render.createDashboards: 대시보드 페이지 생성

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: 위키를 참조하세요.

Obsidian 지원

vault.renderMode가 obsidian이면, plugin은 Obsidian 친화적인 Markdown을 작성하고 선택적으로 공식 obsidian CLI를 사용할 수 있습니다. 지원되는 워크플로는 다음과 같습니다:

상태 프로빙
볼트 검색
페이지 열기
Obsidian 명령 호출
일일 노트로 이동

이 기능은 선택 사항입니다. 위키는 Obsidian 없이 native 모드에서도 계속 작동합니다.

권장 워크플로

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

Overview

Plugins

Skills

Automation & Tasks

Tools

Agent coordination

메모리 위키

메모리 위키

추가되는 기능

메모리와의 관계

볼트 모드

`isolated`

`bridge`

`unsafe-local`

볼트 레이아웃

구조화된 클레임과 증거

컴파일 파이프라인

대시보드와 상태 보고서

검색 및 조회

에이전트 도구

프롬프트 및 컨텍스트 동작

구성

CLI

Obsidian 지원

권장 워크플로

관련 문서

Overview

Plugins

Skills

Automation & Tasks

Tools

Agent coordination

​메모리 위키

​추가되는 기능

​메모리와의 관계

​볼트 모드

​isolated

​bridge

​unsafe-local

​볼트 레이아웃

​구조화된 클레임과 증거

​컴파일 파이프라인

​대시보드와 상태 보고서

​검색 및 조회

​에이전트 도구

​프롬프트 및 컨텍스트 동작

​구성

​CLI

​Obsidian 지원

​권장 워크플로

​관련 문서

메모리 위키

추가되는 기능

메모리와의 관계

볼트 모드

`isolated`

`bridge`

`unsafe-local`

볼트 레이아웃

구조화된 클레임과 증거

컴파일 파이프라인

대시보드와 상태 보고서

검색 및 조회

에이전트 도구

프롬프트 및 컨텍스트 동작

구성

CLI

Obsidian 지원

권장 워크플로

관련 문서