Obsidian Sync KB

将 Obsidian 笔记同步助手 收件箱转换为 OpenClaw 可用的本地检索知识库。

设置

为特定仓库初始化技能：

bash
python3 scripts/setup_config.py --vault-root /绝对/路径/到/ClawVault

设置脚本会写入 scripts/config.yaml。你也可以跳过设置，直接设置 OBSIDIANSYNCKB_VAULT=/绝对/路径/到/ClawVault。

命令

构建或刷新索引：

bash
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

查询收件箱知识库：

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

提升与策展：

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

行为

• - 将同步的收件箱视为只读源材料。
• 构建规范化文档、文本块、主题卡片、更新日志和每日变更摘要。
• 优先使用源笔记、原始 URL 和 obsidian:// 引用，而非外部搜索。
• 返回 简要结论、相关文章、关键摘录 和 引用来源。
• 每条引用必须包含 Obsidian 路径和原始 URL（如有）。
• 如果命中结果是 badcapture 或 needsmanual_access，需明确标注，而非将其视为有效来源。