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 ClientObsidian 里的聊天/代理客户端OpenCode真正和编辑器通信的 agentACPObsidian 与 OpenCode 通信所用协议智谱 GLM最终调用的大模型所以关键不是“把 API Key 填进 Obsidian”而是安装并配置 OpenCode让 OpenCode 能调用智谱模型让 Obsidian 通过opencode acp连上 OpenCode二、前置条件开始前请确保你已经有Windows 11ObsidianNode.jsOpenCode智谱 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_KEYOPENCODE_CONFIG1. 设置智谱 API Keysetx GLM_API_KEY你的智谱API Key2. 创建 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 UTF83. 设置 OpenCode 配置路径setx OPENCODE_CONFIG$env:USERPROFILE\opencode-zhipu.json4. 关闭并重新打开 PowerShellsetx写入的是持久环境变量但不会刷新当前窗口。所以设置完后要关闭当前 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-turbo2. 直接测试模型调用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 IDopencode-zhipu2. Display NameOpenCode Zhipu3. Path优先填opencode如果插件识别不到命令就在 PowerShell 里先查绝对路径where opencode然后把输出的绝对路径填进去。4. Argumentsacp5. Environment Variables可以留空。因为我们已经通过系统环境变量设置了GLM_API_KEYOPENCODE_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例如readwriteeditgreplistwebsearchwebfetchskill这些工具不用额外装 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-ai2.opencode models zhipu不显示模型先检查环境变量echo$env:OPENCODE_CONFIGtype$env:OPENCODE_CONFIG再刷新opencode models zhipu--refresh3.opencode run报认证错误先看echo$env:GLM_API_KEY如果为空说明新窗口没有正确读到环境变量重新设置或重新打开 PowerShell。4. Obsidian 一直显示 connecting先在终端里手动启动 ACPopencode acp如果这里直接报错就不是 Obsidian 的问题而是 OpenCode 或配置本身的问题。十二、推荐的执行顺序为了避免来回排错建议严格按这个顺序执行# 1. 安装 Node.js 与 OpenCodewinget install OpenJS.NodeJS.LTS npm install-g opencode-ai# 2. 设置环境变量setx GLM_API_KEY你的智谱API Keysetx 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”而是用 OpenCode 作为支持 ACP 的 agent用 OpenCode 的自定义 provider 对接智谱 GLM用 Obsidian Agent Client 连接这个 agent一旦这条链跑通你后面就可以继续往笔记整理skills 工作流MCP 工具接入本地知识库与科研助理这些方向扩展。