LLM Wiki 搭本地知识库最容易被卡住的是配置模型供应商时的 401。TaoToken 正好解决这层兼容通道的问题打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建 Key把 Base URL 填成 https://taotoken.net/api填回设置再测连接请求就通了。这套动作不算复杂但很多人照官方 OpenAI 通道的填法做不是 401 就是连接失败。最常见的两个坑一是 Base URL 多带 /v1二是模型 ID 凭记忆手敲。下面按排障视角把 LLM Wiki 从建项目到正式导入文档的整条路径走一遍顺便把 Hermes、Obsidian 在这一环里的位置说清楚。1. LLM Wiki 首次配置模型供应商就卡在 401第一次使用 LLM Wiki 时界面引导其实是清楚的点击 New 或加号新建项目打开右下角的设置图标选择模型供应商粘贴 API Key。问题往往出在「选择模型供应商」这一步。默认列表里有 OpenAI 和 Claude你要是选了 OpenAI再按官方文档把完整的 Base URL 粘进去保存后测试连接运气好能通运气不好直接 401。401 的提示很误导人。它写的是身份验证失败给人的第一反应就是「Key 复制错了」于是反复去控制台重新复制、粘贴折腾几轮依旧报错。其实在这一步Key 大概率是对的真正错的是请求路径。OpenAI 官方接口的地址通常带版本前缀而兼容通道的服务端可能已经把版本处理内置了或者要求你省略这个前缀。两端路径对不上服务端自然拒绝认证。1.1 别急着怀疑 Key先检查 Base URL判断问题到底出在 Key 还是路径有一个很简单的办法把填进 LLM Wiki 的 Base URL 单独复制到浏览器里访问。如果返回的是 Not Found 或者 404说明路径格式不对如果返回的是认证相关提示才需要去检查 Key。按这个顺序排查能省掉一半的无用功。LLM Wiki 在设置界面里支持任何 OpenAI 兼容格式的接口所以理论上选项很多。但正因为可选范围大很多人反而不知道该填什么。这里可以直接把 Base URL 确定成 https://taotoken.net/api末尾不用再加 /v1因为 TaoToken 的接口路径已经包含了版本处理。配合从 TaoToken 控制台创建的 Key就能把 LLM Wiki 的模型调用稳定接上。1.2 401 之后还有一层更隐蔽的「保存成功但调用失败」有一种情况比 401 更难受设置页里测试连接通过了保存也没报错但真正让 Hermes 把文章「写入知识库」时模型调用却失败了。这是因为测试连接可能只做了轻量请求而实际导入文档时要调用模型做实体提取、概念抽取请求体更大、路径更具体。所以验证环节不能只看设置页的测试按钮必须跑一次完整的「写入知识库」指令才算数。这个后面第 5 章会细说。2. 先理清 Hermes、Obsidian 与 LLM Wiki 的分工进入配置之前先花一分钟把三个工具的分工摆清楚以免把「模型通道」和「知识库本身」混为一谈。原文里搭的是这样一套本地知识库文档导入 → AI 整理 → Wiki 生成 → 双向链接。这条链路由两个工具加一套规范完成其中 LLM Wiki 恰好是需要模型通道的那一环。2.1 Obsidian 只负责展示不需要联网Obsidian 是笔记展示层核心能力是双向链接和 Graph View。你在笔记里写 [[Claude-Code-笔记]]如果这个页面存在点击就能跳转不存在点进去就会创建。所有笔记之间的关系会以图谱形式呈现哪些页面是孤岛、哪些是枢纽一眼可见。Obsidian 的数据全部在本地不依赖云端。2.2 Hermes 负责自动执行触发词是「写入知识库」和「结合知识库」Hermes Agent 是 Nous Research 开发的自主 AI 代理内置了 llm-wiki skill。它的使用规则很明确只有你明确说「写入知识库」时它才会执行导入只有你说「结合知识库」时它才会先检索再回答日常普通对话不会主动碰知识库。这样的好处是知识库不会被无关对话污染。2.3 唯一需要外部模型能力的是 LLM Wiki这三个角色里Obsidian 完全离线Hermes 的整理逻辑也跑在本地真正需要模型能力的地方只有 LLM Wiki 设置里的模型供应商一项。原文写得很清楚LLM Wiki 支持 OpenAI、Claude、Minimax以及任何 OpenAI 兼容格式的接口。换句话说这个位置不一定要填官方通道只要是 OpenAI 兼容格式的 Base URL 和 API KeyLLM Wiki 都能用。TaoToken 在这里扮演的就是一个兼容通道把模型请求送出去再把结果接回来知识库的实体提取、双向链接、索引更新仍然由 LLM Wiki 和 Hermes 自己完成。3. 拿 Key 回 LLM Wiki 设置Base URL 这样填配置的步骤不复杂但顺序有讲究。先去 TaoToken 拿 Key再回 LLM Wiki 填设置可以减少两个页面之间来回切换的次数。3.1 在 TaoToken 控制台创建 API Key打开 TaoToken完成注册登录后进入控制台在 API Keys 页面创建一把新的 Key。创建时不用先选模型套餐等到配置 LLM Wiki 时再从模型广场对照里复制一个可用的模型 ID 回来。要特别区分两个地址网页端控制台是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 用于注册、建 Key、看模型、看用量等会儿填进 LLM Wiki 的 Base URL 是 https://taotoken.net/api 末尾没有 /v1也不带任何跟踪参数。这两个地址一旦混淆后面排查起来会非常绕。3.2 LLM Wiki 设置页的参数对照回到 LLM Wiki打开新建的项目点右下角设置图标按下表填写配置项填写内容模型供应商OpenAI 兼容或自定义Base URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEY模型 ID以 模型广场 当时列表为准YOUR_API_KEY 要替换成你在 TaoToken 控制台创建的真实 Key。模型 ID 这一栏最容易出错因为同一个模型在不同兼容通道上的命名可能带版本后缀或日期后缀凭记忆手敲几乎必错。正确做法是在模型广场复制完整 ID原样粘进设置里不要省略任何字符。3.3 保存后先测一次连接填完保存先点击测试连接。如果显示成功再回到第 5 章做真实调用验证。如果测试按钮没有出现说明设置项可能没填完整检查一下模型 ID 和 Base URL 是否和模型广场、控制台显示的完全一致。4. Hermes 的 llm-wiki skill 与写入规则接上模型通道通了之后剩下的是把 Hermes 的触发规则说清楚。第一次使用 Hermes 时建议先把知识库目录和规则告诉它这样后续的导入和检索行为才是可控的。4.1 首次使用时告诉 Hermes 知识库规则在 Hermes 对话界面里把下面这段规则发给它并把其中的路径替换成你自己的知识库目录我的知识库目录是/Users/你的用户名/Documents/knowledge_base 规则只有我明确说「写入知识库」时才可以写入知识库。只有我明确说「结合知识库」时才先检索知识库再回答。所有知识页使用 Markdown 和 [[双向链接]]。使用 LLM Wiki 文件结构管理知识库。这段规则本质上是在给 Hermes 画边界。以后你说「把这篇文章写入知识库」它才动手整理你说「结合知识库回答」它才检索。这样能保证日常闲聊不会把知识库弄脏。4.2 导入一篇文档时Hermes 在后台做什么以「把一篇 AI 写小说的文章写入知识库」为例。Hermes 收到指令后会通过内置的 llm-wiki skill 做这么几件事读取文档内容提取关键实体人物、工具、项目提取核心概念方法论、技术原理创建结构化的 Markdown 文件添加双向链接最后更新索引和日志。生成的文件结构大致是下面这个样子knowledge_base/ ├── raw/sources/ # 原始文章 ├── wiki/entities/ # 实体文件工具、人物、项目 ├── wiki/concepts/ # 概念文件方法论、技术原理 ├── wiki/index.md # 知识库索引 └── wiki/log.md # 更新日志每个文件里除了核心内容还包含元数据标签、创建时间和指向相关页面的双向链接。整个过程不需要你手动建目录或改文件名。4.3 Obsidian 里打开 Vault 看结果把 knowledge_base 目录作为 Vault 拖进 Obsidian就可以用双链跳转和 Graph View 浏览知识网络了。导入的文档越多wiki 页面之间的引用关系越密不同文章里提到的同一个概念会被关联到同一个节点。这个效果就是原文里说的持久化积累以后提问时模型可以基于已经整理好的结构化 Wiki 回答而不是每次从零开始翻原始文档。5. 验证与排障401、连接失败、模型名不识别配置完成并不等于万事大吉测试连接成功和实际调用成功之间还隔着一次完整的导入流程。所以验证时要跑「写入知识库」指令而不是只在设置页点一下测试按钮。5.1 用一次真实导入做验证先随便准备一篇 Markdown 测试文档对 Hermes 说「把这份文档写入知识库」。如果它能正常完成提取、生成文件并更新索引说明 LLM Wiki 的模型通道已经通了。再问一句「结合知识库总结一下这篇文章的核心观点」如果回答里带上了 wiki 页面的内容说明检索链路也正常。5.2 三类常见报错对照报错表现可能原因处理方式401 UnauthorizedAPI Key 错误或 Base URL 路径不对重新复制 Key确认 Base URL 为 https://taotoken.net/apiConnection failed / SSL 错误Base URL 多带 /v1或误填成网页地址把地址改成 https://taotoken.net/api末尾不要写 /v1Model not found模型 ID 不完整或版本后缀写错回 模型广场 复制完整 ID三张表里401 是最容易被误判的一个。很多人以为重新生成 Key 就能解决其实换个思路先看 Base URL 是否多带 /v1往往一改就好了。模型名不识别则是另一类高频问题尤其是那些带日期后缀的模型名少复制一位就会报错。5.3 回控制台对一下调用记录验证通过后可以回 TaoToken 控制台看一眼调用记录。这一步不是为了看金额而是确认请求确实走了 https://taotoken.net/api 这条通道。如果控制台有对应时间的调用记录说明 LLM Wiki 的模型供应商配置已经彻底生效如果没有任何记录但本地又显示成功那就要回 LLM Wiki 设置里再检查一遍是否真的保存到了当前项目。6. 跑通之后数据留在本地通道交给 TaoToken配置跑通后日常使用就很轻了你说「写入知识库」Hermes 整理你说「结合知识库」AI 基于结构化的 Wiki 回答。Obsidian 这边只是本地浏览和编辑不依赖任何云服务。一个值得记住的边界是知识库的 Markdown 文件、双向链接关系全部在本地磁盘上TaoToken 只参与模型请求这一层不会触碰你的笔记数据。哪天想迁移直接把整个 knowledge_base 目录复制走就行。如果你现在还被 LLM Wiki 的 401 卡着可以先到 TaoToken 模型对话 用同一把 Key 发一条消息确认 Key 本身可用再回 LLM Wiki 改配置。需要规划写代码场景的用量可以打开 Coding Plan 看看套餐是否够用新 Key 在 控制台 API Keys 创建。以后再遇到模型供应商连接问题先检查 Base URL 是不是 https://taotoken.net/api 且没有 /v1再检查模型 ID 是否和模型广场一致这两处对了大部分 401 和连接失败都能解决。