--- read_when: - 단순한 MEMORY.md 메모를 넘어 지속적으로 유지되는 지식이 필요합니다 - 번들로 제공되는 memory-wiki Plugin을 구성하고 있습니다 - wiki_search, wiki_get 또는 브리지 모드를 이해하고 싶습니다 summary: '메모리 위키: 출처 정보, 클레임, 대시보드, 브리지 모드를 포함하는 컴파일된 지식 저장소' title: 메모리 위키 x-i18n: generated_at: "2026-05-04T02:24:56Z" model: gpt-5.5 provider: openai source_hash: b070177b7c1217e9102bc57680b4009265e3584ede7ad6dc3ba7b6393260fefe source_path: plugins/memory-wiki.md workflow: 16 --- `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은 다음과 같이 저장소를 초기화합니다. ```text / 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`으로 사람 페이지를 열어야 합니다. 예: ```yaml 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: - brad@example.com 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` 아래에 넣으세요: ```json5 { 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`를 사용하려면 이것을 사용하세요. ```json5 { 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 표면도 노출합니다. ```bash 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](/ko/cli/wiki)를 참조하세요. ## Obsidian 지원 `vault.renderMode`가 `obsidian`이면 Plugin은 Obsidian 친화적인 Markdown을 작성하고, 선택적으로 공식 `obsidian` CLI를 사용할 수 있습니다. 지원되는 워크플로는 다음과 같습니다. - 상태 조사 - vault 검색 - 페이지 열기 - Obsidian 명령 호출 - 데일리 노트로 이동 이는 선택 사항입니다. 위키는 Obsidian 없이 네이티브 모드에서도 계속 작동합니다. ## 권장 워크플로 1. 회상/승격/Dreaming에는 Active Memory Plugin을 유지하세요. 2. `memory-wiki`를 활성화하세요. 3. 브리지 모드를 명시적으로 원하지 않는 한 `isolated` 모드로 시작하세요. 4. 출처가 중요할 때는 `wiki_search` / `wiki_get`을 사용하세요. 5. 좁은 범위의 종합 또는 메타데이터 업데이트에는 `wiki_apply`를 사용하세요. 6. 의미 있는 변경 후에는 `wiki_lint`를 실행하세요. 7. 오래된 내용/모순 가시성이 필요하면 대시보드를 켜세요. ## 관련 문서 - [메모리 개요](/ko/concepts/memory) - [CLI: memory](/ko/cli/memory) - [CLI: wiki](/ko/cli/wiki) - [Plugin SDK 개요](/ko/plugins/sdk-overview)