Obsidian AI 插件安装与 API 配置教程
这篇笔记整理了在 Obsidian 中安装 AI 插件,并接入智谱清言、通义千问、DeepSeek、Kimi 以及 GitHub 免费 GPT 接口的完整流程。思路并不复杂,关键是把插件装对,把 Base URL、模型名和 API Key 对齐。
安装 Obsidian
先准备好 Obsidian 本体,再创建或打开一个 Vault,后面的配置都会在这个工作空间里完成。
- 下载 Obsidian:访问 Obsidian 官网,选择适合自己系统的版本,安装即可。
- 创建或打开 Vault:启动 Obsidian 后,选择一个已有的 Vault,或者新建一个专门用于测试 AI 功能的工作空间。
安装 AI 插件
Obsidian 的 AI 能力通常依赖社区插件。这里以 Copilot 一类的 AI 插件为例,流程是类似的。
- 打开 Obsidian 设置,进入'社区插件'。
- 关闭'安全模式',否则第三方插件无法安装。
- 点击'浏览',搜索
copilot。 - 找到对应插件后安装,并在安装完成后启用。
安装好之后,回到主界面或命令面板里确认插件已经可用。一般来说,插件启用后会在设置项、侧边栏或命令面板中出现入口。
API 配置
接下来是最容易出问题的部分:不同厂商的模型,虽然都能走兼容接口,但 Base URL、模型名和密钥必须严格对应。只要这三项填错,测试连接大概率就会失败。
智谱清言(GLM-4-Flash)
先到 智谱 AI 开放平台 注册或登录,进入 API 管理页面生成密钥。然后在 Obsidian 的 AI 插件设置里填写:
- 模型名称:
GLM-4-Flash - Base URL:
https://open.bigmodel.cn/api/paas/v4 - API Key:填写刚生成的密钥
保存后做一次连接测试,如果返回正常,说明这组参数已经通了。
通义千问(qwen-max)
通义千问需要到阿里云的模型市场获取接口信息。登录后生成 API Key,再在插件里填入下面这些值:
- 模型名称:
qwen-max - Base URL:
https://dashscope.aliyuncs.com/compatible-mode/v1 - API Key:填写密钥
这里的 compatible-mode/v1 很关键,很多兼容型客户端都依赖这个路径来对接阿里云的大模型接口。
DeepSeek
DeepSeek 的配置比较直接。前往 DeepSeek Platform 注册并生成 API Key,然后在插件里设置:
- 模型名称:
deepseek-chat - Base URL:
https://api.deepseek.com - API Key:填写密钥
保存后测试连接即可。
Kimi
Kimi 对应的是 Moonshot AI 的开放平台。先在 Moonshot AI - 开放平台 注册并生成密钥,再配置:
- 模型名称:
moonshot-v1-8k - Base URL:

