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 生成，請仔細甄別