Obsidian 技能：AI 驱动的第二大脑实战指南

凌晨 2 点，我的笔记在自动写论文

上周五凌晨 2:17，我在群里发了一条消息：「谁能帮我把这 37 篇论文笔记整理成一篇综述？」

3 分钟后，小浣熊回复：「Obsidian 技能已经帮你写好了初稿，在 /tmp/obsidian-draft.md。」

我打开文件，愣住了。大纲、引用、论点串联，甚至帮我标出了 3 处逻辑跳跃需要人工补充。这不是我熟悉的那个需要手动写 [[双向链接]] 的 Obsidian。

这是 OpenClaw 的 obsidian 技能在背后干活。

这个技能是干啥的

一句话：让 AI 读你的 Obsidian 笔记库，自动建立知识连接，生成综述/大纲/论文初稿。

不是简单的关键词搜索，而是真正理解你的笔记内容，找出跨笔记的隐性关联。比如你写了：

• 笔记 A：「RAG 的检索延迟问题」
• 笔记 B：「向量数据库的 HNSW 索引优化」
• 笔记 C：「SFD 实验室的查询响应时间要求 <200ms」

AI 会自动发现这三者的关联，生成：「针对 SFD 实验室的 200ms 响应要求，建议采用 HNSW 索引优化 RAG 检索延迟」这样的洞见。

安装和配置

clawhub install obsidian



{
  "skills": {
    "obsidian": {
      "vaultPath": "/Users/frankypeh/ObsidianVault/SFD-Lab",
      "indexLimit": 500,
      "embeddingModel": "nomic-embed-text"
    }
  }
}

踩坑记录：

1. 路径必须是绝对路径 — 我第一次用了 ~/ObsidianVault，技能找不到，报错 "vault not found"。改成 /Users/frankypeh/ObsidianVault 才解决。
2. 笔记太多会超时 — 我有 1200+ 篇笔记，第一次索引跑了 47 分钟。后来加了 indexLimit: 500，只索引最近 500 篇，速度提升到 8 分钟。
3. 中文笔记需要指定编码 — 有些旧笔记是 GBK 编码，AI 读出来是乱码。用 file -I 笔记名.md 检查编码，有问题的手动转 UTF-8。

实战使用：从 0 到生成一篇技术博客

场景： 我要写一篇关于「AI Agent 记忆系统」的文章，但笔记分散在 23 个文件里。

openclaw obsidian query "AI Agent 记忆系统的三种失效模式"

返回结果：

核心论点
AI Agent 记忆失效分为三类：存储层丢失、检索层偏差、生成层幻觉。

支撑笔记
1. [[2026-03-15 记忆存储失败]] — KV Cache 溢出导致上下文截断
2. [[2026-03-22 检索偏差分析]] — 向量相似度≠语义相关性
3. [[2026-04-01 生成层幻觉]] — 模型在低置信度时编造细节

隐性关联
笔记 1 和笔记 3 都提到「凌晨 2 点监控告警」，说明这是高频故障时段
笔记 2 中 Franky 提到的「90% 查询集中在 10% 笔记」可优化检索策略

我基于这个大纲，补充了实战代码和监控截图，45 分钟写完一篇 2300 字的博客。以前这需要一下午。

和其他技能的配合

obsidian + self-improving-agent：

• Obsidian 负责整理历史笔记
• Self-improving 负责记录新错误
• 形成闭环：新错误→笔记→AI 整理→生成改进建议→应用到系统

obsidian + translate-cli：

• 用 Obsidian 生成中文初稿
• Translate-cli 批量翻译成英文和繁体
• 直接发布到 CMS，三语内容一次产出

obsidian + hugo-blog-agent：

• Obsidian 管理素材
• Hugo-blog-agent 生成静态博客
• 我们的小火狐博客就是这么来的

SFD 实验室怎么用

我们 15 个 Agent 每天产生大量决策记录：

• 小蜜蜂的部署日志
• 小猎鹰的安全审计报告
• 小刺猬的验证结果
• 小浣熊的 PRD 文档

以前这些散落在 14 个 Agent 的 memory 文件夹里，没人看得完。

现在每天 22:00，cron 自动触发：

openclaw obsidian summarize --since today --output /tmp/daily-brief.md

第二天早上 9 点，我打开 /tmp/daily-brief.md，看到的是：

• 昨天 15 个 Agent 的关键决策
• 跨 Agent 的协作问题（比如小蜜蜂部署失败导致小刺猬验证超时）
• 需要我介入的 3 件事

这相当于有一个全职助理帮我读完了所有日志，还做好了摘要。

踩坑记录（血泪教训）

坑 1：索引建立后忘记更新
我有次问 AI「上周的部署故障」，它说「没有找到相关笔记」。后来发现索引是 3 天前建立的，新笔记没被收录。

解决：在 cron 里加了每天 03:00 自动重建索引：

{
  "schedule": {"kind": "cron", "expr": "0 3   *"},
  "payload": {"kind": "systemEvent", "text": "openclaw obsidian index --force"}
}

坑 2：AI 过度解读
有次 AI 把我的两条笔记强行关联：

• 笔记 A：「服务器 CPU 温度 85°C」
• 笔记 B：「小春蚕今天心情不好」

AI 说：「高温导致 Agent 情绪波动」。我：？？？

后来加了 temperature: 0.3 限制 AI 的发散程度，只让它找强关联。

坑 3：隐私泄露风险
Obsidian 笔记里有 CMS 密码、API Key。第一次用技能时没注意，AI 把这些也索引了。

解决：在配置里加了 excludePatterns：

{
  "excludePatterns": [
    "*/security/.md",
    "**/credentials.md",
    "*/password*.md"
  ]
}

SFD 编者注

这个技能最让我震撼的不是技术，而是它改变了我们管理知识的方式。

以前是「人找知识」— 我需要写什么，自己去笔记库里翻。 现在是「知识找人」— AI 主动告诉我：「你写的这 3 篇笔记可以串成一个故事」。

上周我用它整理了一篇关于「AI Agent 成本优化」的文章，意外发现小蜜蜂的部署记录和小章鱼的 API 调用日志之间存在 3 处可以优化的地方。省了每月 120 美元的推理成本。

这才是第二大脑该有的样子：不是存储更多，而是连接更深。

---

技能名： obsidian
适用场景： 知识管理、论文综述、博客大纲、决策回顾
安装命令： clawhub install obsidian
配置难度： ⭐⭐（需要配置路径和索引策略）