
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/khojKhoj 是一个可自托管的 AI 第二大脑它的 Obsidian 插件能让你的整个笔记库被检索、被对话。当插件设置页顶部的状态行显示红点或者你上周写的笔记在搜索里查不到时问题基本出在三个位置服务器地址、API 密钥、索引同步。本文以连接状态灯为坐标按打通连接、喂入数据、调优使用三个阶段展开每个阶段末尾都有具体可查的验证点。 场景切入为什么 Khoj Obsidian 插件会显示红点场景一你从 Obsidian 社区插件市场装好 Khoj点击 Khoj: Search弹窗提示无法连接 Khoj 服务笔记库一片空白。场景二你已用命令行或 Docker 在本地部署了 Khoj但插件里仍填着默认的云端地址于是聊天从来没回答过基于本地笔记的问题。两种场景的处理路径相同先看状态灯再按阶段修。如果你还没部署本地服务可以先看官方部署文档。✅ 开始之前先核对这 4 项项目要求说明Obsidian 版本0.15.0 或更高插件清单声明 minAppVersion 为 0.15.0Khoj 服务云端账号或本地服务已运行本地默认地址http://127.0.0.1:42110API 密钥云端用户必填本地匿名模式不用填在服务端 Settings → Clients 生成网络能访问所填的 Khoj URL本地走 127.0.0.1云端需公网可达️ 解决方案主线三个阶段让状态灯变绿打开 Obsidian 设置里的 Khoj 插件页顶部有一行 Connect 状态灯 表示服务不可达 表示可达但未登录 表示已连接并登录。下面每一阶段都以它为准。阶段一 · 打通连接填对 URL 与 API key先看状态灯再按使用方式改两个字段Khoj URL 和 Khoj API Key。云端用户保持 Khoj URL 默认不动把密钥粘进 Khoj API Key 输入框改完页面会自动发起一次重连检测。本地用户把 Khoj URL 改成http://127.0.0.1:42110如果本地是用khoj --anonymous-mode启动的密钥栏保持为空。如何验证做对了状态行出现 ✅ Welcome back to Khoj 并带上你的邮箱说明连接打通如果看到 Could not connect to Khoj at ...说明地址不可达。可以再交叉验证用浏览器打开同一个地址网页能出来说明网络没问题问题就在密钥或登录态。阶段二 · 喂入数据把笔记库同步进索引连接成功后插件默认自动同步整个库Auto Sync并在 Sync Interval 间隔内只上传有变更的文件默认间隔是 60 分钟。库比较大时先缩小范围用 Include Folders 只圈定部分目录或用 Exclude Folders 排除归档目录不想索引某类文件就把 Sync 区里对应的 Notes、Images、PDFs 开关关掉。想让索引立刻生效点击 Force Sync 行的 Update 按钮做全量重建。如何验证做对了点击后按钮进入 Updating 状态进度条显示 Syncing... 12 / 326 files分母就是同步范围内的文件数。结束后 Estimated Cloud Storage 一行会显示 x.x MB / xxx MB 的已用/总量。最后打开服务端的网页端本地就是http://127.0.0.1:42110文件列表里能看到你库里的笔记才算真正入库。阶段三 · 调优使用让搜索和聊天真正生效搜索用快捷键 CtrlAltS命令面板里的 Khoj: Search找相似笔记用 CtrlAltF。Results Count 默认 15滑杆可调 1–30Chat Model 下拉从服务端拉取如果显示 Not connected说明阶段一还没打通。如何验证做对了搜一个你确定在某篇笔记里的专有词或数字这篇笔记出现在结果里说明索引已生效。刚编辑的笔记搜不到时先执行命令面板里的 Sync new changes等提示结束再搜一次。 排错手册按出现频率排列的 5 种现象1. 状态行显示 Could not connect to Khoj at http://127.0.0.1:42110红点最可能原因本地服务没启动或端口不是 42110。 处理办法先确认服务在运行再回到设置页在 URL 输入框里删掉一个字符再补上触发一次重新检测。2. 搜索结果为空或刚写的笔记不在结果里最可能原因该文件不在索引范围或同步还没执行。 处理办法检查文件类型开关和 Include/Exclude Folders 是否把它排除在外然后点 Force Sync 的 Update等进度条走完再搜。3. 状态灯是黄点或提示 Get a valid API key … to log in最可能原因服务可达但密钥缺失或无效。 处理办法到服务端 Settings → Clients 重新生成密钥并粘贴本地匿名模式则把密钥栏清空。4. Chat Model 下拉框显示 Not connected 或列表为空最可能原因连接未建立或服务端没配置可用模型。 处理办法先把状态灯弄绿再点 Refresh Models 刷新或到服务端确认模型配置。5. 改了设置但行为没变化最可能原因插件仍在用旧配置运行。 处理办法在社区插件列表里先 Disable 再重新 Enable Khoj然后重开设置页。更多细节可参考官方 Obsidian 客户端文档。✨ 可选增强面向重度用户的 3 个开关把 Sync Interval 从 60 分钟改到 1 分钟适合高频写笔记、要求新内容立刻可搜的人。用 Exclude Folders 固定排除归档目录适合库很大、想缩短索引耗时和存储占用的人。打开 Auto Voice Response适合用语音提问、希望回答自动朗读的人。状态灯从红变绿再到搜索第一行出现你的笔记你确认的其实只有三件事地址可达、密钥有效、索引里有你的笔记——这三件事落实后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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考