Obsidian Copilot插件升级后如何连接本地Ollama大模型

Obsidian作为一款流行的知识管理工具，其Copilot插件为笔记场景带来了AI能力。近期该插件迎来一次较大版本更新，配置逻辑随之改变，不少依赖本地部署模型的用户一度担心新版是否还支持连接本地Ollama。B站UP主推城玄在实测后确认这只是虚惊一场——新版依旧支持本地模型，只是配置入口和流程有所调整。本文梳理升级后的完整连接步骤。

升级带来的变化：BYOK配置入口

新版Copilot把模型接入统一收纳到了BYOK（Bring Your Own Key，自带密钥）分页中。这一改动是本次升级最容易让老用户迷惑的地方——原先直接可见的本地模型选项，现在需要通过“添加提供商”的方式手动接入。

具体路径是：进入Obsidian的设置窗口，找到Copilot分页，切换到BYOK这个子页面，然后点击「Add Provider」。在弹出的提供商列表中，Self Host（自托管）这一分类下就能看到Ollama选项。这套逻辑其实更规范，把云端服务商和本地自托管服务做了清晰区分。

BYOK（Bring Your Own Key）是SaaS工具领域常见的接入模式，原本指用户自行提供云服务商（如OpenAI、Anthropic）的API密钥，而非通过平台统一代理付费。Copilot新版将本地自托管服务也纳入同一框架管理，从产品设计角度看是一种"统一抽象"——无论是云端API还是本地服务，插件都将其视为一个"提供商"，用相同的接口规范进行管理。这种设计便于插件日后扩展更多提供商类型，但对习惯旧版直接选模型的用户而言，需要多走一层"添加提供商"的配置流程。

配置Ollama：选择模型与必填的API Key

点击Ollama后面的加号，会打开一个「Configure Ollama」的配置窗口。值得留意的是，这里会自动列出你本地Ollama中已经安装过的所有模型，无需手动输入模型名称，只要勾选想在Obsidian里使用的几个模型，点击Save保存即可。

回到Copilot分页后，刚才勾选的模型会自动出现在可用列表中。这里推城玄特别提醒了一个容易踩坑的细节：即便是连接本地模型，新版依然强制要求填写一个API Key，否则无法正常与本地大模型通信。

由于本地Ollama并不真正校验密钥，这个API Key可以随便填。UP主在演示中直接填了「Ollama」作为占位符，填好后重新尝试对话，就能与本地大模型正常交流了。这个设计可能是插件为了统一各类提供商的接口规范而保留的必填项，本地场景下纯属形式要求。

从QuickChat到Agent Chat：两种对话界面

完成上述配置后，默认使用的是QuickChat这种轻量对话界面，交互简洁、适合快速问答。而升级版Copilot还提供了功能更强的Agent Chat模式，这是本次更新中值得探索的新能力。

Agent Chat需要在插件的Basic分页中进行选择配置。如果此前没有安装过对应组件（比如OpenCode），可以在此直接选择并下载。下载完成后，同样可以为其指定一个默认模型——推城玄依旧选用了本地Ollama中的模型，实现了Agent能力与本地部署的结合。

Agent模式与普通对话模式的核心区别在于"工具调用"能力。普通Chat（如QuickChat）是单轮或多轮问答，AI只负责生成文本回复。Agent模式则允许AI在对话过程中主动调用外部工具——例如读写文件、执行代码、搜索知识库等——并根据工具返回的结果继续推理，直到完成一个复杂任务。OpenCode作为其底层组件，主要面向代码生成与项目级别的操作场景。在Obsidian这类知识管理工具中接入Agent能力，意味着AI不再只是"回答问题"，而是可以跨笔记检索、整理信息结构，乃至辅助完成多步骤的写作或研究工作流。

打开与切换Agent Chat窗口

配置好OpenCode后，有两种方式进入Agent Chat界面：一是通过左边栏的「OpenCode Palette Agent Chat」按钮直接点击打开；二是从已经打开的QuickChat窗口切换到Agent Chat窗口。

从界面复杂度上就能看出，Agent Chat明显比QuickChat更重——它支持创建项目，并在Recent Chat中保留历史对话记录，更适合有连续性、结构化的工作流。对于希望在Obsidian里进行深度AI辅助创作或项目管理的用户，这是一个值得尝试的方向。

小结

整体来看，Copilot插件升级后连接本地Ollama并没有想象中复杂，核心变化集中在三点：接入入口迁移到BYOK分页、通过Add Provider选择Self Host中的Ollama、以及本地连接仍需填写一个占位API Key。掌握这三点，老用户就能顺利完成迁移。而新增的Agent Chat模式，则为本地大模型在Obsidian中的应用打开了更多想象空间。UP主表示后续若有新发现会继续分享，感兴趣的用户不妨自行探索Agent的项目与历史记录等功能。