Obsidian Copilot 是一个能将 AI 对话能力直接嵌入笔记流的强大插件。要让它真正发挥作用，核心在于正确配置外部 API 密钥。本文将分享如何接入 OpenRouter、Google Gemini 和 OpenAI 等主流服务商，帮助你搭建稳定的智能笔记环境。
为什么需要配置 API 密钥？
Copilot 本身不托管模型，它充当客户端连接外部服务。配置好密钥后，你可以在笔记中直接进行对话、分析内容摘要，甚至基于本地知识库生成大纲。
快速配置步骤
进入插件设置界面，找到 API Keys 区域点击 Set Keys。这里会弹出一个对话框，允许你输入不同服务商的凭证。
1. OpenRouter 接入
OpenRouter 是个聚合平台，优势在于能访问多种模型且成本可控，适合日常对话和文本分析。
- 访问 OpenRouter 官网 注册账号
- 在 API 管理页面获取密钥
- 粘贴到 Copilot 配置框中 推荐模型：Gemini 2.5 Flash、Claude 3 Sonnet。
2. Google Gemini 接入
如果你更看重 Google 生态整合或多模态处理，Gemini 也是不错的选择，且有免费额度可用。
- 前往 Google AI Studio
- 创建并复制 API 密钥
- 填入对应字段
3. OpenAI 接入
对于复杂推理或代码生成任务，OpenAI 的成熟模型依然可靠。
- 登录 OpenAI 平台
- 进入 API 密钥管理页面
- 生成新密钥并保存
安全与稳定性建议
密钥属于敏感信息，切勿在公开场合分享。建议配置 2-3 个不同提供商作为备份，以防单一服务波动影响工作流。同时留意 API 使用量，设置限额以控制成本。定期更换密钥也是提升安全性的好习惯。
配置完成后，记得先测试一下响应速度和功能是否正常。一旦跑通，你就能享受无缝的 AI 辅助写作体验了。
