Obsidian 網頁剪藏無法使用？各種錯誤解法

Obsidian Web Clipper 是一款很好用的免費擴充功能，大部分時候都能順利運作。可是一旦出問題，錯誤訊息往往又短又難懂：「Unable to find a vault」、只有標題的筆記、一片空白的彈出視窗。

好消息是，幾乎所有故障都來自少數幾個原因。先了解剪藏工具的運作方式會很有幫助：它在瀏覽器裡擷取頁面，把 Markdown 複製到剪貼簿，再開啟一個 obsidian:// 連結，請 Obsidian App 建立筆記。所以有三個環節必須配合：瀏覽器擴充功能、剪貼簿，以及開著正確知識庫（vault）的 Obsidian App。

以下依症狀分節，逐一說明原因與解法。設定名稱沿用擴充功能介面（Web Clipper Settings）上的英文。

「Unable to find a vault for the URL」（找不到 vault）

這個訊息是 Obsidian 發出的，不是擴充功能。剪藏工具用名稱指定了一個知識庫，但 Obsidian 裡沒有名稱完全相同的知識庫。

1. 開啟 Web Clipper Settings → General → Vaults。
2. 輸入知識庫的名稱，必須與 Obsidian 知識庫切換畫面上顯示的一模一樣，然後按 Enter。不是資料夾路徑（/Users/you/Documents/Notes），只要名稱（Notes）。大小寫和空格都要一致。
3. 也逐一檢查範本：範本裡的 Vault 欄位會覆蓋預設值，可能還指向舊名稱。
4. 在這台電腦的 Obsidian 裡至少開過一次該知識庫，讓 App 知道它存在。

放在網路磁碟機或 Windows WSL 裡的知識庫是已知的特殊情況（兩者在 GitHub 儲存庫 都有未解決的 issue）。如果你的知識庫在那裡，先用本機知識庫測試，確認設定沒問題。

Obsidian 裡什麼都沒出現，或筆記是空的

筆記建立了、檔名也對，卻沒有內容，或是完全沒反應。多半是內容根本沒有經過剪貼簿送到。

1. 確認已安裝 Obsidian App，而且瀏覽器可以開啟它。第一次使用時瀏覽器會詢問是否開啟 Obsidian 連結，請選擇允許。
2. 檢查範本的 Note location，也就是筆記在知識庫裡的資料夾或路徑。
3. 在擴充功能的彈出視窗上開啟瀏覽器開發者主控台，查看實際的錯誤。
4. 還是空的？開啟 Legacy mode（Web Clipper Settings → General）。它改用連結本身傳送內容，不經過剪貼簿。代價是：瀏覽器和作業系統會限制連結長度，非常長的頁面可能在沒有任何錯誤的情況下失敗。

在 Linux 上，最常見的原因是剪貼簿存取權限（Wayland、KDE 視窗規則、Flatpak）。官方疑難排解頁面 有各種環境的說明。

內容缺漏，或顯示「No content」

剪藏工具預設使用 Defuddle，只保留頁面的主要內容。遇到某些版面時它會太保守，把你想要的段落也刪掉。

1. 剪藏前先在頁面上選取想要的文字，或按 Cmd/Ctrl+A 全選。
2. 用 Highlighter 精準標出要保留的部分。
3. 對常剪藏的網站，建立一個以該網址為觸發條件的範本，再用 {{selectorHtml:article}} 這類選擇器變數取出正確區塊。

如果看到「Unable to extract page content」，請重新整理頁面再試一次：代表擴充功能讀不到頁面，常發生在瀏覽器的內部頁面（設定、擴充功能商店），以及還在載入中的頁面。

圖片不見了

很多人沒想到：依照設計，圖片會保持連結到原始網址，不會下載到知識庫裡。只要網站下線或封鎖外連，筆記裡的圖片就會消失。

想保存在本機，請在 Obsidian 開啟該筆記，從命令面板執行 Download attachments for current file。部分網站（延遲載入的圖庫、base64 圖片、微信文章）仍有未修正的錯誤，重要頁面記得檢查結果。

「Failed to save file」

這個錯誤出現在儲存的最後一步失敗時：可能是透過「Add to Obsidian」交給 Obsidian 的步驟，也可能是改為下載 .md 檔案的 Save file… 選項。

1. 同時更新擴充功能和 Obsidian App。許多儲存相關的錯誤都在小版本更新中修正了。
2. 從主按鈕旁的下拉選單試試 Save file…。如果可行，問題就出在交給 Obsidian 的環節（請回到上方知識庫與剪貼簿的步驟）。
3. 如果連下載都失敗，檢查瀏覽器是否允許擴充功能下載檔案，以及是否設定成每個檔案都要詢問儲存位置。

「Failed to fetch」與 Interpreter 無法運作

「Failed to fetch」幾乎都代表有網路請求被擋下，實務上通常與 Interpreter 有關，也就是在頁面上執行提示詞的選用 AI 功能。

1. 在 Web Clipper Settings → Interpreter 確認 Enable Interpreter 已開啟，且供應商的 API 金鑰有效。
2. 若使用自訂供應商，Base URL 必須是 chat completions 端點，通常以 /chat/completions 結尾。
3. 使用 Ollama 時，啟動伺服器要允許擴充功能的來源，否則會出現 403： OLLAMA_ORIGINS=moz-extension://*,chrome-extension://*,safari-web-extension://* ollama serve
4. 如果 Interpreter 在長頁面上答非所問，是因為 Ollama 預設的上下文很小（2048 個 token）。調高 num_ctx，或用選擇器縮小上下文範圍。

在 iOS 或 Safari 上無法使用

在 iPhone 和 iPad 上，剪藏工具是 Safari 擴充功能，必須自己開啟才會生效。

1. 在 Safari 點網址列左側的按鈕 → 管理延伸功能，開啟 Obsidian Web Clipper。
2. 在 iOS 設定 → App → Safari → 延伸功能，允許它在所有網站上執行。
3. 在 iOS 設定 → App → Obsidian，將從其他 App 貼上設為允許。少了這個權限，Obsidian 讀不到剪藏工具複製的內容，就會產生空白筆記。

在 Safari（Mac 或 iOS）上，如果筆記內容錯誤或只有標題，GitHub 上回報的解決方法是開啟 Legacy mode。彈出視窗一片空白時，通常關閉分頁再重新開啟 Safari 就能解決。

如何儲存到指定資料夾

這不是錯誤，卻是最常被搜尋的問題之一。每個範本都有 Note location 欄位，填入知識庫中的資料夾路徑即可（例如 Clippings/Articles）。也可以在按下 Add to Obsidian 之前，直接在彈出視窗中修改資料夾。為每個目的地各建一個範本，再加上 triggers（網址規則），就會自動選用正確的範本。

一直失敗時的替代方案

如果以上都試過了，剪藏還是不穩定（知識庫放在同步磁碟或網路磁碟、iPhone 一直掉權限、網站存下來是空的），準備一個不依賴同一條流程的第二工具會比較安心。

Minibase 是運作方式不同的 Chrome 擴充功能：不需要開著 Obsidian App，也不需要連接知識庫。它把頁面交給 AI 判斷主要內容，回傳乾淨、有結構的 Markdown。你可以直接下載 .md 檔，或讓 Minibase Vault App（Mac 與 Windows）寫入本機資料夾，再把這個資料夾當成 Obsidian 知識庫開啟，或放進你現有的知識庫。

請留意兩者做法不同：Minibase 會把頁面濃縮整理，方便閱讀，也方便 Claude 等 AI 工具使用，並不是逐像素的完整複製。免註冊每月可免費儲存 20 次，Minibase+ 每月 5.99 美元。

兩款工具的並排實測請看 Obsidian Web Clipper 與 Minibase 比較，完整選項請看 2026 最佳 Obsidian 網頁剪藏工具。很多人兩個都用：官方剪藏工具用來搭配範本快速收藏，Minibase 用在真正重要的頁面。