Obsidian Copilot 接入教程

在 Obsidian 笔记里对话、改写、总结，用自己的 key 接樱桃茶模型

接入步骤

安装 Copilot 插件
Obsidian「设置」→「第三方插件」（Community plugins）→「浏览」（Browse），搜索 Copilot，安装并启用。
添加自定义服务商
打开 Settings → Copilot →「BYOK」标签 → 点「Add a provider」→ 选「Add a custom provider」。
填写服务商信息
「Display name」填樱桃茶；在「Model ID」里输入模型名后点「Add」，可以加多个。「Enable CORS」先保持关闭。
- API key：sk-你的密钥
- Base URL：https://gpt.cherrychat.org/v1（必须带 /v1）
- Model ID：gpt-6.1-sol
测试并保存
点「Test」，通过后点「Save」。如果 Test 通过、但聊天时发不出消息，编辑这个服务商打开「Enable CORS」（回复会改成一次性显示，不再逐字出现）。
设为默认模型并开始用
到 Basic → Agents →「Quick Chat」，把「Default model」选成刚加的樱桃茶模型。打开 Copilot 聊天面板发一句话，有回复就好了。

Base URL 要带 /v1（https://gpt.cherrychat.org/v1），插件也是从 https://gpt.cherrychat.org/v1/models 拉模型列表。
这是 Copilot 4.x 的界面。还在用 3.x 的：设置里「Model」标签 →「Add Custom Model」，Provider 选「3rd party (openai-format)」，Base URL、API Key、模型名填法一样。
4.x 的语义搜索（原来的 Vault QA）改由 Miyo 提供，不用在 Copilot 里配 Embedding 模型；3.x 的 Vault QA 才需要再加一个 Embedding 模型 text-embedding-3-small（同样的 Base URL 和 key）。
key 存在这台电脑的 Obsidian Keychain 里，不会随笔记库同步；换电脑或手机要重新填。
Agent Chat 里的 Claude / Codex 用的是各自命令行工具的登录，不走 BYOK；想让它们也用樱桃茶，请看 Claude Code、Codex 教程。

看到的报错	原因	怎么办
显示 Invalid key / 401	API key 复制错了、带了空格，或这把 key 已停用	到 API 页「我的密钥」重新复制后粘贴，再点 Test
显示 Check failed 或报 404	Base URL 少了 /v1，或写成了 https://gpt.cherrychat.org/v1/chat/completions	改成 https://gpt.cherrychat.org/v1 后重新 Test
Test 通过但聊天发不出消息	Quick Chat 的请求方式和服务端兼容性问题	编辑服务商，打开「Enable CORS」后保存
提示模型不存在	Model ID 写错（大小写、多空格）	按模型价格页逐字填写，例如 gpt-6.1-sol
报 402 或「余额不足」（Claude 格式显示 billing_error）	账户积分不够付这次调用。API 调用只扣积分，会员卡和无限卡都不抵扣	到樱桃茶·智域GPT 的「商店」充值任意金额，几秒后重试即可
报 429 Too Many Requests	请求太快：默认每把 key 每分钟最多 120 次，每个账号同时最多 8 个请求	调低工具里的并发数或每秒请求数，按提示的 Retry-After 秒数等一等再试；多数工具会自动重试

教程核对于 2026-11-02。工具界面改版后可能和这里略有不同，以官方文档为准。

Operated by UK Company CHERRYCHAT LTD · Company Number 16096119 · 客服微信 JsnonoChat · 内容由 AI 生成，请仔细甄别