Gbrain Obsidian Vault

把 Obsidian 变成 OpenClaw memory + gbrain 知识图谱的可视化 GUI：单 vault、wikilink 图谱、 memory 日记软链、DB 页面物化导出，编辑仍回灌 sync/embed。触发词：obsidian脑库 / 第二大脑可视化 / gbrain obsidian / memory图谱 / 连点成面 / second brain vault

SpikeSu@spikesubingrui-design

Install

openclaw skills install @spikesubingrui-design/gbrain-obsidian-vault

GBrain Obsidian Vault — 给 AI 记忆装上「能看见的脑」

问题：OpenClaw 的 memory_search 和 gbrain 的 Postgres 图谱对 agent 可见，对人不可见。
解法：Obsidian 打开 gbrain wiki 作 vault，软链 memory/ 日记进来，可选 gbrain export 把 DB 页面物化成 markdown——一套文件，三路索引。

何时加载本 Skill

用户要把 Obsidian 和 OpenClaw memory / gbrain 打通
用户说「第二大脑可视化」「memory 图谱」「连点成面」「想在 Obsidian 里看 agent 写的记忆」
用户已有 gbrain + ~/wiki（或同类 markdown 脑库），要加 GUI

架构（一图流）

text

OpenClaw workspace/memory/*.md  ──symlink──►  ~/wiki/memory/     ◄── Obsidian 浏览
gbrain Postgres (426+ pages)   ──export──►  ~/wiki/**/*.md       ◄── Obsidian 图谱
Agent cron                     ──sync────►  Postgres + vectors   ◄── 后台不变

安全约束（必须遵守）：

memory 必须在 ~/wiki/.gitignore 里 → gbrain sync 是 git-diff 驱动，不会把日记重复入库
.obsidian/ 被 gbrain isSyncable 跳过（隐藏目录）
不要改 alwaysUpdateLinks: true，避免 Obsidian 批量重写 gbrain 的 [[路径式]] 链接

Phase 0 — 确认路径

变量	默认	说明
`WIKI_DIR`	`~/wiki`	gbrain git 仓库根
`MEMORY_DIR`	`~/.openclaw/workspace/memory`	OpenClaw 日记 MD
`GBRAIN_BIN`	`gbrain`	CLI 在 PATH

Phase 1 — 一键搭建（推荐）

bash

bash skills/gbrain-obsidian-vault/scripts/setup-vault.sh
# 或指定路径：
WIKI_DIR=~/wiki MEMORY_DIR=~/.openclaw/workspace/memory bash scripts/setup-vault.sh

脚本会：创建 memory 软链、写入 .gitignore、预置 .obsidian/app.json（wikilink + absolute + 不自动改链）。

Phase 2 — 物化 DB 页面（可选但强烈推荐）

若 Postgres 里页面多于磁盘 .md（常见于 MCP put_page 只写 DB）：

bash

gbrain export --dir "$WIKI_DIR"
cd "$WIKI_DIR" && git add -A && git commit -m "materialize gbrain pages for Obsidian"

物化后 Obsidian 图谱 wikilink 解析率通常从 ~30% 升到 80%+。

Phase 3 — 打开 Obsidian

Obsidian → Open folder as vault → 选 WIKI_DIR
左侧 Graph view：看 people / projects / concepts / synthesis 簇
打开 memory/2026-MM-DD.md → 右栏 Backlinks → Unlinked mentions 跳到引用该日记的 gbrain 页面

Phase 4 — 验证清单

ls -la $WIKI_DIR/memory 显示 symlink
cd $WIKI_DIR && git status 不出现 memory/*.md
图谱中有连线（说明 [[projects/foo]] 被解析）
编辑任意 gbrain 页面保存后 git status 有改动（cron 会 sync+embed）

Agent 写入纪律（与 AGENTS.md 记忆桥接一致）

用户在 Obsidian 手改 markdown 后：

gbrain 侧：link-maintenance / auto-ingest cron 会 sync --no-embed + embed --stale
memory 侧：仍在 workspace/memory/，由 memory_search 索引，不要把 memory 提交进 wiki git

故障排除

症状	处理
图谱很空、大量悬空链接	跑 `gbrain export --dir $WIKI_DIR`
memory 在 git 里出现	确认 `.gitignore` 含 `memory`
Obsidian 把链接改成 `[text](path)`	检查 `useMarkdownLinks: false`
`[[Naval Ravikant]]` 不解析	显示名链接；给目标页加 frontmatter `aliases`