如何利用国内LLM对Obsidian的笔记进行分析

Win11 下用 Obsidian + OpenCode + 智谱 GLM 的安装与配置教程

适用场景：不能方便走代理，但希望把 Obsidian 接到大模型，用于笔记整理、润色、总结与后续工具扩展。

本教程基于我们已经跑通的方案：Obsidian Agent Client + OpenCode ACP + 智谱 GLM。

一、整体架构

这套方案不是让 Obsidian 直接调用模型 API，而是走下面这条链路：

Obsidian Agent Client ↓ OpenCode ACP ↓ 智谱自定义 Provider ↓ glm-5v-turbo / glm-5-turbo

其中：

• Obsidian Agent Client：Obsidian 里的聊天/代理客户端
• OpenCode：真正和编辑器通信的 agent
• ACP：Obsidian 与 OpenCode 通信所用协议
• 智谱 GLM：最终调用的大模型

所以，关键不是“把 API Key 填进 Obsidian”，而是：

1. 安装并配置 OpenCode
2. 让 OpenCode 能调用智谱模型
3. 让 Obsidian 通过opencode acp连上 OpenCode

二、前置条件

开始前请确保你已经有：

• Windows 11
• Obsidian
• Node.js
• OpenCode
• 智谱 API Key

如果还没有安装 Node.js 和 OpenCode，可参考以下最简命令：

# 安装 Node.js（若已安装可跳过）winget install OpenJS.NodeJS.LTS# 安装 OpenCodenpm install-g opencode-ai

安装后建议验证：

node-v npm-v opencode--version

三、设置环境变量

我们最终需要两个环境变量：

• GLM_API_KEY
• OPENCODE_CONFIG

1. 设置智谱 API Key

setx GLM_API_KEY"你的智谱API Key"

2. 创建 OpenCode 配置文件

先在 PowerShell 中执行下面命令，生成配置文件：

@' { "$schema": "https://opencode.ai/config.json", "provider": { "zhipu": { "npm": "@ai-sdk/openai-compatible", "name": "Zhipu AI", "options": { "baseURL": "https://open.bigmodel.cn/api/paas/v4", "apiKey": "{env:GLM_API_KEY}" }, "models": { "glm-5v-turbo": { "name": "GLM-5V-Turbo", "limit": { "context": 200000, "output": 128000 } }, "glm-5-turbo": { "name": "GLM-5-Turbo", "limit": { "context": 200000, "output": 128000 } } } } }, "model": "zhipu/glm-5v-turbo", "small_model": "zhipu/glm-5-turbo" } '@|Set-Content-Path"$env:USERPROFILE\opencode-zhipu.json"-Encoding UTF8

3. 设置 OpenCode 配置路径

setx OPENCODE_CONFIG"$env:USERPROFILE\opencode-zhipu.json"

4. 关闭并重新打开 PowerShell

setx写入的是持久环境变量，但不会刷新当前窗口。所以设置完后，要关闭当前 PowerShell，再开一个新的。

重新打开 PowerShell 后，验证环境变量：

echo$env:GLM_API_KEYecho$env:OPENCODE_CONFIGtype$env:OPENCODE_CONFIG

四、验证 OpenCode 是否已成功接入智谱

1. 查看模型列表

opencode models zhipu

如果没有正常显示，可以强制刷新：

opencode models zhipu--refresh

正常情况下，你应该能看到类似：

zhipu/glm-5v-turbo zhipu/glm-5-turbo

2. 直接测试模型调用

opencode run-m zhipu/glm-5v-turbo"请只回复：连接成功"

如果返回：

连接成功

说明下面这条链已经打通：

OpenCode → 智谱 GLM

五、在 Obsidian 中安装 Agent Client 插件

安装obsidian-agent-client插件。

如果你已经装好了，可以直接进入下一步。

六、在 Obsidian 中配置 OpenCode 为 Custom Agent

打开：

Settings → Agent Client → Custom Agents → Add custom agent

按下面填写：

1. Agent ID

opencode-zhipu

2. Display Name

OpenCode + Zhipu

3. Path

优先填：

opencode

如果插件识别不到命令，就在 PowerShell 里先查绝对路径：

where opencode

然后把输出的绝对路径填进去。

4. Arguments

acp

5. Environment Variables

可以留空。

因为我们已经通过系统环境变量设置了：

• GLM_API_KEY
• OPENCODE_CONFIG

七、在 Obsidian 中测试连接

配置完成后，在 Obsidian 里选择这个 agent，输入：

请只回复：Obsidian连接成功

如果一切正常，模型会直接返回：

Obsidian连接成功

这说明下面这整条链已经打通：

Obsidian → OpenCode ACP → 智谱 GLM

八、为什么不用“直接写 Node 脚本调用 API”

因为obsidian-agent-client不是一个“直接调 API”的插件，它接的是ACP agent。

也就是说，Obsidian 期望连接的是：

一个会说 ACP 协议的 agent

而不是：

一个普通的 Node.js 请求脚本

所以：

• 普通脚本能证明 API 通不通
• 但不能直接拿来给 Obsidian 当 agent
• 真正适合接入的是 OpenCode 这种支持 ACP 的 agent

九、当前阶段已经具备什么能力

即使你现在还没有接入 MCP，打通 OpenCode 之后，也已经可以做很多事情：

• 在 Obsidian 里直接和模型对话
• 让模型帮你整理笔记
• 让模型帮你润色、总结、改写内容
• 进一步配置 OpenCode 的内置 tools 与 skills

也就是说，你现在已经完成了“从聊天模型到 Obsidian 工作流入口”的第一步。

十、后续可以继续扩展什么

后面可以继续加三类能力：

1. OpenCode 内置 tools

例如：

• read
• write
• edit
• grep
• list
• websearch
• webfetch
• skill

这些工具不用额外装 MCP，就已经很有用。

2. Skills

适合做固定模板化任务，例如：

• 文献笔记整理
• 会议纪要规范化
• 实验记录清洗
• 论文段落润色
• Zotero/Obsidian 风格统一

3. MCP Server

当你后面想让 agent：

• 批量访问整个 vault
• 调数据库/API
• 连 GitHub
• 连本地文件系统或 Obsidian REST API

再考虑上 MCP 更合适。

十一、常见问题排查

1.opencode找不到

where opencode

如果没有输出，说明：

• OpenCode 没装成功
• 或全局 npm 路径未加入 PATH

可以重开 PowerShell，再试一次；不行就重新执行：

npm install-g opencode-ai

2.opencode models zhipu不显示模型

先检查环境变量：

echo$env:OPENCODE_CONFIGtype$env:OPENCODE_CONFIG

再刷新：

opencode models zhipu--refresh

3.opencode run报认证错误

先看：

echo$env:GLM_API_KEY

如果为空，说明新窗口没有正确读到环境变量，重新设置或重新打开 PowerShell。

4. Obsidian 一直显示 connecting

先在终端里手动启动 ACP：

opencode acp

如果这里直接报错，就不是 Obsidian 的问题，而是 OpenCode 或配置本身的问题。

十二、推荐的执行顺序

为了避免来回排错，建议严格按这个顺序执行：

# 1. 安装 Node.js 与 OpenCodewinget install OpenJS.NodeJS.LTS npm install-g opencode-ai# 2. 设置环境变量setx GLM_API_KEY"你的智谱API Key"setx OPENCODE_CONFIG"$env:USERPROFILE\opencode-zhipu.json"# 3. 生成配置文件# （使用本教程第三部分提供的命令）# 4. 关闭并重新打开 PowerShell# 5. 测试 OpenCodeopencode models zhipu opencode run-m zhipu/glm-5v-turbo"请只回复：连接成功"# 6. 配置 Obsidian# Path: opencode# Arguments: acp# 7. 在 Obsidian 中测试# 请只回复：Obsidian连接成功

十三、总结

这套方案的本质不是“在 Obsidian 里填一个 API Key”，而是：

1. 用 OpenCode 作为支持 ACP 的 agent
2. 用 OpenCode 的自定义 provider 对接智谱 GLM
3. 用 Obsidian Agent Client 连接这个 agent

一旦这条链跑通，你后面就可以继续往：

• 笔记整理
• skills 工作流
• MCP 工具接入
• 本地知识库与科研助理

这些方向扩展。