Khoj 接入 Obsidian：从连接、索引到日常问答，一篇讲透
【免费下载链接】khojYour AI second brain. Self-hostable. Get answers from the web or your docs. Build custom agents, schedule automations, do deep research. Turn any online or local LLM into your personal, autonomous AI (gpt, claude, gemini, llama, qwen, mistral). Get started - free.项目地址: https://gitcode.com/GitHub_Trending/kh/khoj
Khoj 是一个可自托管的 AI 第二大脑：它把 Obsidian 笔记库索引成可检索的条目，让 AI 基于你自己的内容做问答和搜索，笔记不用手动整理就能被检索。跟着本文操作，你可以在 Obsidian 里直接对 Khoj 提问、搜索笔记，还能让 AI 指出答案出处。
开始前的准备
- Obsidian 已安装，且能进入「设置 → 第三方插件（Community plugins）」
- Khoj 服务已在本机或内网跑起来，启动日志出现
🌖 Khoj is ready to engage表示就绪 - 账号的 API key（自托管匿名模式可以跳过这一项）
- 磁盘留有足够空间存放向量索引（离线模型场景建议 16GB 以上内存）
- 明确 Khoj 服务地址：本机默认
http://127.0.0.1:42110
这张图展示的是 Khoj 服务端网页应用，你在 Obsidian 插件里填写的地址最终指向的就是它。
🚀 怎么把 Khoj 服务连上 Obsidian 插件
在 Obsidian 里安装并启用 Khoj 插件
打开 Obsidian 设置，进入「第三方插件」，先关闭「安全模式」；在浏览器端社区插件页搜索 Khoj，点「Install」后再点「Enable」。
填写服务地址与 API 密钥
回到 Obsidian 设置里的 Khoj 面板：在Khoj URL填入服务地址；在Khoj API Key填入你的密钥。自托管且以匿名模式启动（khoj --anonymous-mode）时，Khoj URL填本地地址、密钥留空即可。
确认连接状态
填写完成后看设置面板顶部的状态指示：绿灯表示已连通，红灯说明地址或密钥不对，回到上一步核对即可。
🔄 怎么让 AI 认识你全部内容：索引与同步
首次全量索引
打开 Khoj 设置面板，点Force Sync旁的Update按钮，强制对整个库做一轮全量同步。笔记多的库第一次会花几分钟到更久，期间有进度条，可以放着不用管。
这张可视化图对应索引完成后的产物：每一篇笔记、每张图片都被切分成可检索的条目。
自动同步怎么工作
Auto Sync默认开启，插件按Sync Interval周期（默认 60 分钟）自动把新增和修改的笔记推给 Khoj；你也可以随时运行命令Sync new changes手动补一次增量同步。
控制同步的文件范围
Sync Notes / Sync Images / Sync PDFs三个开关决定入库的文件类型；库很大时，用Include Folders只同步指定目录，或用Exclude Folders排除归档目录（排除规则优先于包含规则）。
💬 搜索和对话日常怎么用
打开聊天窗口
点 Obsidian 左侧边栏的 Khoj 消息图标（💬），或按 Ctrl+Alt+N 新开一轮对话，也可以从命令面板（Ctrl+P）输入Chat。
上图就是聊天面板就位后的样子，接下来可以直接用自然语言提问。
用自然语言提问
像聊天一样输入问题，例如「我上次整理待办是在哪篇笔记里？」。回答会附来源条目，方便你跳回原文核对。
语义搜索与查询过滤
按 Ctrl+Alt+S（或命令面板输入Search）打开搜索框，支持语义匹配，不需要关键词逐字命中。还可以追加过滤语法缩小范围，例如：
file:"notes/2024.md" +todo dt>="2024-01-01"
意思是：只查指定文件、只保留含todo的条目、且内容日期不早于 2024-01-01。
找相似笔记
打开某篇笔记后，运行命令Find similar notes（快捷键 Ctrl+Alt+F），Khoj 会列出与当前笔记主题相近的其他笔记，适合把散落的想法串起来。
⚠️ 问题速查
| 症状 | 原因 | 处理 |
|---|---|---|
| 设置面板显示红灯，无法连接 | Khoj URL写错、服务没启动，或 API 密钥无效/缺失 | 先确认 Khoj 服务正在运行；自托管匿名模式留空密钥，云端模式核对密钥 |
| 新写的笔记搜不到 | 同步周期（默认 60 分钟）还没到，或该文件类型开关未打开 | 检查Sync Notes / Sync Images / Sync PDFs开关，运行Sync new changes手动增量同步 |
| 答案是旧的，没反映最近修改 | 对应文件的索引没刷新 | 在设置面板点Force Sync的Update强制重建索引 |
| 回答为空或报错 | 服务未就绪，或聊天模型未配置 | 确认服务端日志出现🌖 Khoj is ready to engage，再到服务端的设置页配置聊天模型 |
🎛 进阶：收窄同步范围与切换聊天模型
- 大库日常只关心工作笔记：用
Include Folders圈定目录，配合Exclude Folders去掉归档区，索引体积和同步耗时都会明显下降。 - 切换模型：设置面板的
Chat Model下拉列表会自动从服务端拉取可用模型；自托管且接了 Ollama 等本地模型服务时，可以选离线模型，问答全程不出内网（模型配置在服务端管理后台完成，改完重启服务）。
更多细节可以参考 Obsidian 客户端文档 与 查询过滤文档。
装好插件、填对地址和密钥、让索引跑完，你的 Obsidian 库就已经接入了 Khoj，后面就是直接提问和检索。
【免费下载链接】khojYour AI second brain. Self-hostable. Get answers from the web or your docs. Build custom agents, schedule automations, do deep research. Turn any online or local LLM into your personal, autonomous AI (gpt, claude, gemini, llama, qwen, mistral). Get started - free.项目地址: https://gitcode.com/GitHub_Trending/kh/khoj
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
