결론
openwiki를 이 볼트에 직접 적용하는 건 권하지 않는다. OpenWiki를 ~/.openwiki에 따로 두고 볼트는 읽기 전용 입력으로만 쓰는 병행 운영은 가능하지만, 얻는 이득은 작다. 근거는 2026-10-06 기준 LangChain 공식 문서(overview·code-mode·personal-mode·customize·cli-reference·visualize)와 볼트 스크립트이며, OpenWiki를 실제로 설치·실행해 보지는 않았다.
경로 A — 볼트에서 code 모드 실행: 불가
openwiki --init/--update는 실행할 때마다 저장소 루트의AGENTS.md·CLAUDE.md에<!-- OPENWIKI:START -->…END블록을 넣거나 다시 쓴다. 이 볼트의AGENTS.md는 규칙 원본이었다. (2026-10-11 이후 볼트에서CLAUDE.md→@AGENTS.md연결 파일과GEMINI.md는 삭제됐다 — 이 부분은 삭제 시점 사실로 기록을 갱신한 것)openwiki/아래에 자체index.md·log.md(OKF 예약 파일),.claims/,.page-manifest.json이 생긴다.- 볼트는 1분마다 자동 커밋·푸시되므로 시험 실행도 곧바로 원격에 올라간다.
- 볼트 스크립트(
wikilib.TYPED_DIRS)는 타입별 폴더 5개만 훑는다. 그래서openwiki/가 배포를 막지는 않지만, 검증도 게시도 되지 않는 페이지 묶음이 저장소에 쌓인다. - 같은 이유로
openwiki integrations install claude --project도 이 저장소에는 맞지 않는다.
경로 B — personal 모드 출력을 볼트로 지정: 불가
OPENWIKI_CONFIG_DIR은 위키 출력 위치만 바꾸는 설정이 아니라 상태 폴더 전체를 옮긴다. 여기에는 API 키·OAuth 토큰이 든 .env, openwiki.sqlite, connectors/*/raw가 들어 있다. 이 경로를 볼트 안으로 잡으면 비밀 정보가 자동 푸시되는 공개 저장소에 올라간다. 이것만으로도 이 경로는 막힌다.
비밀 정보 문제를 빼더라도 출력 형식이 볼트 계약과 맞지 않는다.
| 항목 | OpenWiki 출력 | 이 볼트 규칙 |
|---|---|---|
| 링크 | 표준 마크다운 링크로 관계 표현 | [[slug]] (summaries에만 약 7,000개, md 링크는 수십 개) |
| frontmatter | 필수는 type뿐, generated/verified는 ISO 시각 | title·description(≤120자)·created/updated(YYYY-MM-DD HH:mm)·tags·sources 필수 |
| 수집 경로 | 커넥터가 받은 원본을 바로 합성 | normalize_ingest.py 게이트, source_url 중복 금지, ASCII 파일명 |
| 페이지 분류 | 자유 형식 concept 페이지 | 5타입 평면 폴더 |
경로 C — 볼트를 입력으로만 쓰는 병행 운영: 조건부 가능
git-repo커넥터는 로컬 저장소 경로를 읽는다. 다만 문서는 “compact manifests”를 만든다고만 적고 있어, 페이지 본문까지 충분히 합성에 쓰이는지는 확인하지 못했다.custom-mcp는 읽기 전용 MCP 도구만 허용하므로, qmd MCP를 붙여 볼트를 검색 소스로 쓰는 구성도 생각해 볼 수 있다.- 결과는 볼트와 별개인 두 번째 위키다. 볼트의 수집·정리 흐름(raw → summaries)과 겹치는 부분이 커서, 이 볼트 운영자에게 실익은 작다.
가져다 쓸 만한 아이디어
- Grounded Claims: 페이지의 사실마다 버전 고정 근거를 붙여 두고, 근거가 바뀐 페이지만 다시 쓴다. 볼트 validator는 이미 OKF
sources·verified·status를 허용하므로(2026-09-13-google-okf-open-knowledge-format) 개념적으로 잘 맞는다.- 2026-10-09 도입: frontmatter 대신
reports/claims/<slug>.yaml사이드카와scripts/check_claims.py로 옮겼다(SCHEMA “Grounded Claims”). 이 페이지와 openwiki가 파일럿이다. raw는 불변이라 실제 드리프트는 같은source_url의 새 캡처, raw 이름 변경, 볼트 코드·규칙 변경에서 생긴다.
- 2026-10-09 도입: frontmatter 대신
openwiki visualize <path> --export: 정적 그래프 뷰어(graph.json+ 클라이언트)를 만든다. 다만 연결선을 표준 md 링크로 만든다면[[slug]]관계는 그래프에 나오지 않을 가능성이 크다(미확인).
관련
- openwiki — 도구 개요
- 2026-07-04-llm-wiki-vs-openwiki-comparison — 두 방식 비교
- 2026-07-11-openwiki-brains-general-purpose-memory-for-agents — personal 모드 소개
- moc-llm-wiki