Obsidian AI 知识库第一步:从 0 搭建最小可用系统,用真实场景跑通
视频演示
YouTube 视频:Obsidian搭建最小可用AI知识库
开头:Obsidian + AI 到底怎么用?
关于 Obsidian AI 知识库的教程已经不少,但真正动手时,很多人卡住的不是概念,而是第一步怎么做。
有些方案一上来就讲 Karpathy 知识库、AI Wiki、自生长知识库、Agent 系统,听起来很完整,照着做却偏重。更实际的起点,是先搭一个最小可用版本:资料能进入 Obsidian,AI 能参与处理,内容能留下来,最后能变成文章、报告、Q&A、项目资料或其他输出。

这篇文章只解决一件事:用 Obsidian 搭一个能先跑起来、后面还能扩展的 AI 知识库。不追求一步到位的全自动化,也不要求一开始就设计完美系统,先按三个步骤走:
- 先搭建 Obsidian 本地知识库。
- 再把 AI 能力接进来。
- 最后用资料积累和项目推进两个真实场景跑通闭环。
判断这套流程有没有跑通,可以看四个结果:
- 外部资料可以保存成本地 Markdown。
- AI 可以读取、总结和更新笔记。
- 值得保留的内容可以进入长期知识或项目 Index。
- 最后能产出后面还会用到的成果。
构建Obsidian本地知识库
AI 要参与知识管理,前面得先有一个稳定、可读、可维护的本地知识库。
Obsidian 好用的地方,不只是能写笔记,而是它把内容保存成一批本地 Markdown 文件。网页、PDF、文档、想法、访谈、视频转写稿,都可以先变成 Markdown;AI 处理完以后,结果仍然写回 Markdown。人能读,AI 也能读,后面还可以继续转成文章、脚本、PPT 或项目文档。
最小可用的 Obsidian 仓库,可以先用下面这套目录:
1 | Obsidian Vault/ |
每个目录只管一件事:
00-Inbox收件箱:临时入口,先接住资料、想法和临时记录。10-Projects项目:正在推进的具体项目,比如一篇文章、一支视频、一次研究。20-Areas领域:长期维护的能力、主题和判断,比如知识管理、内容创作、AI 工具使用。30-Resources资源:以后还会参考的原始资料,比如文章、访谈、文档、PDF。40-Archive归档:已经结束或暂时不用的内容。80-Templates模板:常用笔记模板。90-Attachments附件:图片、PDF 和其他附件素材。
这套结构参考了 PARA,但重点不是“按主题分类”,而是先判断这条信息接下来要服务什么。临时资料先进入 Inbox,以后还会查的资料就放到 Resources;Resources 可以被 Projects 调用,项目或资料里整理出的长期方法,可以进入 Areas;结束的项目再放进 Archive。

这里不用急着把目录设计得很复杂。知识库是在使用中长出来的,只要起点清楚,后面目录可以继续调整。Obsidian 的双链会保留笔记之间的关系,不需要把所有秩序都压在文件夹层级上。
Obsidian接入AI能力
本地知识库搭好之后,下一步是让 AI 进入这个 Markdown 仓库,而不是只停留在一个独立聊天窗口里。
Obsidian 接入 AI 的方式很多。这里先用一个轻量方案:Claudian + CLI Agent。它大概分三层:
- Obsidian:知识库和工作界面。
- Claudian:连接器,把 Obsidian 当前笔记和 AI 对话接起来。
- CLI Agent:执行任务的 AI,可以是 Claude Code、Codex CLI 或 OpenCode。

验证时不用做复杂配置,先跑五步:
- 选择一个 CLI Agent,例如 Codex CLI。
- 完成登录,或者通过第三方模型转接。
- 在终端里测试 Agent 是否能正常对话。
- 回到 Obsidian,在 Claudian 插件里启用这个 Agent。
- 让 AI 读取当前笔记,并做一次简单总结。
如果使用 Codex CLI,终端里可以先输入:
1 | codex |
进入对话后,输入一句简单的测试内容,例如:
1 | 你好 |
能正常回复,就说明本地 Agent 至少可以运行。然后打开 Obsidian 设置,进入社区插件,找到 Claudian。在 Codex 标签页里启用:
1 | Enable Codex provider |

最后打开一篇当前笔记,在 Claudian 面板里输入:
1 | 帮我总结一下这个笔记内容。 |
如果 AI 能基于当前笔记生成总结,这条连接就跑通了。这个阶段不用追求自动化,只确认一件事:本地有一个 Agent 能正常工作,并且它能通过 Claudian 读取 Obsidian 当前笔记。
用真实场景跑通 AI 知识库
接入 AI 只是起点,知识库还得在真实场景里用起来。
这里用两个场景验证:日常资料积累和项目推进。前者解决“资料怎么变成长期知识”,后者解决“知识怎么帮一个具体目标往前走”。
先看资料积累。比如看到一篇 Obsidian CEO 的采访,可以用 Obsidian 官方 Web Clipper 把网页剪藏成 Markdown,并保存到:
1 | 00-Inbox收件箱/Clippings |
回到 Obsidian 后,这篇网页已经变成一篇本地笔记。接下来把它从 Inbox 移到 Resources,因为它以后还可能用得上:
1 | 30-Resources资源/Obsidian's CEO on why productivity tools need community more than AI.md |
然后在原文上方加两个标题:
1 | # 内容总结 |
选中“内容总结”区域,在 Claudian 里给 AI 一个明确指令:
1 | 给我总结这篇文章内容,并更新到这里。 |

AI 写回总结后,人再判断哪些内容值得留下。比如把“对 Obsidian 使用者的启发”整理进 20-Areas领域/Obsidian学习,并加上原始资料的双链。这样,一个积累型流程就完成了:
1 | 网页资料 -> Inbox -> Resources -> AI 总结 -> Areas 长期知识 |
再看项目推进。比如想研究一个问题:
1 | Obsidian 为什么适合 AI 时代的知识管理? |
可以先在 10-Projects项目 中新建一个项目 Index:
1 | 10-Projects项目/Obsidian为什么适合AI时代的知识管理-index.md |
这个 Index 先放四个一级标题:
1 | # 背景 |

接下来围绕这个项目,让 AI 做几件具体的事。
第一,先拆研究角度:
1 | 如果我要研究“Obsidian 为什么适合 AI 时代的知识管理”,需要从哪些角度查找资料? |
如果这个问答以后还会用到,就让 AI 新建 Q&A 笔记,并把双链放回“常见问题”下面:
1 | 在当前目录新建一篇 Q&A 笔记,记录上面这个问题和回答,并在这里添加双链。 |
第二,整理资料到背景:
1 | 把 `00-Inbox收件箱/Clippings` 里的相关资料迁移到 `30-Resources资源`,并把这些资料的双链放到“背景”下面。 |
第三,基于资料做输出:
1 | 基于背景中参考资料,给我总结关键要点,记录在分析标题下面,要简要精炼罗列,不要太长。 |
1 | 基于“分析”里的要点,创建一篇简短文章,并把文章双链放到“输出”下面。 |
如果还想做可视化,可以再让 AI 调用相关 skill:
1 | 利用这个 skill,基于文章的核心结构,生成一个关系图,并把这张图的双链也放到“输出”下面。 |
到这里,一个项目型流程也跑通了:一个临时问题进入项目,相关资料进入资源,AI 帮忙拆解、分析和生成成果,最后所有输出都回到项目 Index 里管理。
横向看,目录决定笔记放在哪里;纵向看,双链把原始资料、长期知识和项目成果串起来。文件夹负责位置关系,双链负责知识关系。这就是 Obsidian + AI 最基础的骨架。

结尾:这只是最小闭环,后面可以继续扩展
最小可用版本不追求一步到位,先完成一条能验证的闭环。
这条闭环可以压缩成三个环节:
- 知识输入:把资料、想法和项目需求放进 Obsidian。
- 知识处理:让 AI 总结、提炼、归类和关联,人负责判断和取舍。
- 知识输出:让知识服务项目推进、内容创作和决策。

后续升级也可以继续围绕这三个环节展开:
- 输入端:接入更多资料类型,比如网页、PDF、视频、音频、Notion 笔记、Word 文档和 AI 对话。
- 处理端:参考 Karpathy 知识库、AI Wiki 等方法,基于 Resources 生成结构化 Wiki、索引和领域知识。
- 输出端:把知识转成文章、PPT、视频脚本、公众号稿、选题库或项目文档。
自动化、Agent、MCP、自生长知识库,都适合放到后面。先让资料进来,让 AI 能处理,让知识留下来,让结果能输出,再继续升级。




