Obsidian Sync KB

Turn an Obsidian 笔记同步助手 inbox into a local retrieval-ready knowledge base for OpenClaw.

Setup

Initialize the skill for a specific vault:

python3 scripts/setup_config.py --vault-root "/absolute/path/to/ClawVault"

The setup script writes scripts/config.yaml. You can also skip setup and set OBSIDIAN_SYNC_KB_VAULT=/absolute/path/to/ClawVault.

Commands

Build or refresh the index:

python3 scripts/kb_tool.py build-index
python3 scripts/kb_tool.py build-index --force-full-rescan
python3 scripts/kb_tool.py build-index --disable-network

Query the inbox knowledge base:

python3 scripts/kb_tool.py query "怎么更好让 AI 做检索"
python3 scripts/kb_tool.py query "OpenClaw harness" --topic openclaw --format json

Promote and curate:

python3 scripts/kb_tool.py promote
python3 scripts/kb_tool.py star retrieval-rag --type topic
python3 scripts/kb_tool.py stats

Behavior

• Treat the synced inbox as read-only source material.
• Build normalized docs, chunks, topic cards, update logs, and a daily change digest.
• Prefer source notes, original URLs, and obsidian:// references before external search.
• Return 简要结论, 相关文章, 关键摘录, and 引用来源.
• Every citation must include the Obsidian path and original URL when available.
• If a hit is a bad_capture or needs_manual_access, make that explicit instead of treating it as a valid source.