Obsidian Web Clipper không hoạt động? Cách sửa từng lỗi

Obsidian Web Clipper là một tiện ích miễn phí rất tốt, và phần lớn thời gian nó chạy trơn tru. Khi gặp sự cố, thông báo thường ngắn và khó hiểu: “Unable to find a vault”, một ghi chú chỉ có tiêu đề, một cửa sổ bật lên trống trơn.

Tin tốt là gần như mọi lỗi đều đến từ vài nguyên nhân quen thuộc. Hiểu cách clipper hoạt động sẽ giúp ích. Nó trích xuất trang ngay trong trình duyệt, sao chép Markdown vào clipboard, rồi mở một liên kết obsidian:// để yêu cầu ứng dụng Obsidian tạo ghi chú. Vậy là ba mắt xích phải khớp nhau: tiện ích trình duyệt, clipboard và ứng dụng Obsidian với đúng kho (vault).

Dưới đây là một mục cho mỗi triệu chứng, kèm nguyên nhân và cách sửa. Tên cài đặt giữ nguyên như trong giao diện tiếng Anh của tiện ích, ở mục Web Clipper Settings.

”Unable to find a vault for the URL” (không tìm thấy vault)

Thông báo này đến từ Obsidian, không phải từ tiện ích. Clipper đã yêu cầu một kho theo tên, và Obsidian không có kho nào trùng chính xác tên đó.

1. Mở Web Clipper Settings → General → Vaults.
2. Nhập tên kho, đúng như hiển thị trong bộ chuyển kho của Obsidian, rồi nhấn Enter. Không phải đường dẫn thư mục (/Users/ban/Documents/GhiChu), chỉ là tên (GhiChu). Chữ hoa, chữ thường và dấu cách đều quan trọng.
3. Kiểm tra cả từng template: trường Vault trong template sẽ ghi đè giá trị mặc định và có thể vẫn trỏ tới tên cũ.
4. Mở kho trong Obsidian ít nhất một lần trên máy này để ứng dụng biết nó tồn tại.

Kho nằm trên ổ mạng hoặc trong WSL trên Windows là những trường hợp đặc biệt đã biết (cả hai đều là issue đang mở trên kho GitHub). Nếu kho của bạn ở đó, hãy thử với một kho cục bộ trước để xác nhận cấu hình.

Không có gì xuất hiện trong Obsidian, hoặc ghi chú trống

Ghi chú được tạo với đúng tên nhưng không có nội dung, hoặc chẳng có gì xảy ra. Thường thì nội dung chưa bao giờ đi qua được clipboard.

1. Đảm bảo ứng dụng Obsidian đã được cài và trình duyệt được phép mở nó. Lần đầu, trình duyệt sẽ hỏi có mở liên kết Obsidian không: hãy cho phép.
2. Kiểm tra trường Note location của template, tức thư mục hoặc đường dẫn của ghi chú trong kho.
3. Mở developer console của trình duyệt trên cửa sổ tiện ích để xem lỗi thật sự.
4. Vẫn trống? Bật Legacy mode (Web Clipper Settings → General). Chế độ này gửi nội dung ngay trong liên kết thay vì qua clipboard. Đổi lại, trang quá dài có thể lỗi mà không báo gì, vì trình duyệt và hệ điều hành giới hạn độ dài liên kết.

Trên Linux, thủ phạm thường là quyền truy cập clipboard (Wayland, quy tắc cửa sổ của KDE, Flatpak). Trang khắc phục sự cố chính thức có hướng dẫn cho từng cấu hình.

Thiếu nội dung, hoặc “No content”

Mặc định, clipper dùng Defuddle để chỉ giữ phần nội dung chính của trang. Với một số bố cục, nó quá thận trọng và bỏ mất những đoạn bạn cần.

1. Bôi đen phần văn bản muốn lưu trước khi clip, hoặc nhấn Cmd/Ctrl+A để chọn tất cả.
2. Dùng Highlighter để đánh dấu chính xác những phần cần giữ.
3. Với trang bạn hay clip, tạo một template có trigger theo URL của trang đó và lấy đúng phần cần thiết bằng biến selector như {{selectorHtml:article}}.

Nếu thấy “Unable to extract page content”, hãy tải lại trang và thử lại: tiện ích không đọc được trang. Điều này xảy ra ở các trang nội bộ của trình duyệt (cài đặt, cửa hàng tiện ích) và các trang chưa tải xong.

Mất hình ảnh

Điều này khiến nhiều người bất ngờ: theo thiết kế, hình ảnh vẫn liên kết tới URL gốc. Chúng không được tải về kho. Nếu trang web sập hoặc chặn hotlink, hình sẽ biến mất khỏi ghi chú.

Để lưu ảnh cục bộ, mở ghi chú trong Obsidian và chạy lệnh Download attachments for current file từ bảng lệnh (command palette). Một số trang (thư viện ảnh tải chậm, ảnh base64, bài viết WeChat) vẫn còn lỗi chưa sửa, nên hãy kiểm tra kết quả với những trang quan trọng.

”Failed to save file”

Lỗi này xuất hiện khi bước lưu cuối cùng thất bại: bước chuyển sang Obsidian qua “Add to Obsidian”, hoặc tùy chọn Save file… vốn tải về một tệp .md.

1. Cập nhật cả tiện ích lẫn ứng dụng Obsidian. Nhiều lỗi lưu đã được sửa trong các bản cập nhật nhỏ.
2. Thử Save file… trong menu thả xuống cạnh nút chính. Nếu được, vấn đề nằm ở bước chuyển sang Obsidian (quay lại các bước về kho và clipboard ở trên).
3. Nếu chính việc tải tệp thất bại, hãy kiểm tra trình duyệt có cho phép tiện ích tải tệp không và không hỏi vị trí lưu cho từng tệp.

”Failed to fetch” và Interpreter không hoạt động

“Failed to fetch” gần như luôn có nghĩa là một yêu cầu mạng bị chặn, và trên thực tế thường liên quan tới Interpreter, tính năng AI tùy chọn chạy prompt trên trang.

1. Trong Web Clipper Settings → Interpreter, kiểm tra Enable Interpreter đã bật và nhà cung cấp có API key hợp lệ.
2. Với nhà cung cấp tùy chỉnh, Base URL phải là endpoint chat completions, thường kết thúc bằng /chat/completions.
3. Với Ollama, hãy chạy server cho phép origin của tiện ích, nếu không bạn sẽ gặp lỗi 403: OLLAMA_ORIGINS=moz-extension://*,chrome-extension://*,safari-web-extension://* ollama serve
4. Nếu Interpreter trả lời lạc đề với trang dài, đó là vì ngữ cảnh mặc định của Ollama nhỏ (2048 token). Tăng num_ctx hoặc thu hẹp ngữ cảnh bằng selector.

Web Clipper không hoạt động trên iOS hoặc Safari

Trên iPhone và iPad, clipper là một tiện ích Safari, và nó bị tắt cho tới khi bạn bật lên.

1. Trong Safari, chạm nút bên trái thanh địa chỉ → Quản lý tiện ích mở rộng và bật Obsidian Web Clipper.
2. Trong Cài đặt iOS → Ứng dụng → Safari → Tiện ích mở rộng, cho phép nó chạy trên mọi trang web.
3. Trong Cài đặt iOS → Ứng dụng → Obsidian, đặt Dán từ ứng dụng khác thành Cho phép. Nếu không, Obsidian không đọc được nội dung clipper đã sao chép và bạn sẽ nhận ghi chú trống.

Trên Safari (Mac hoặc iOS), nếu ghi chú có nội dung sai hoặc chỉ có tiêu đề, một cách khắc phục được báo trên GitHub là bật Legacy mode. Cửa sổ bật lên trống thường hết khi đóng tab và mở lại Safari.

Cách lưu vào một thư mục cụ thể

Đây không phải lỗi, nhưng là một trong những câu hỏi được tìm nhiều nhất. Mỗi template có trường Note location: nhập đường dẫn thư mục trong kho (ví dụ Clippings/BaiViet). Bạn cũng có thể đổi thư mục ngay trong cửa sổ tiện ích trước khi bấm Add to Obsidian. Hãy tạo một template cho mỗi nơi lưu và thêm triggers (mẫu URL) để template phù hợp được chọn tự động.

Khi clipper vẫn tiếp tục lỗi: một giải pháp thay thế

Nếu đã thử hết mà việc clip vẫn chập chờn (kho nằm trên ổ đồng bộ hoặc ổ mạng, iPhone liên tục mất quyền, trang web lưu về trống), bạn nên có thêm một công cụ thứ hai không phụ thuộc vào cùng chuỗi đó.

Minibase là một tiện ích Chrome hoạt động theo cách khác: không cần mở ứng dụng Obsidian hay kết nối với kho. Nó gửi trang tới một AI nhận diện nội dung chính và trả về Markdown sạch, có cấu trúc. Bạn có thể tải tệp .md về, hoặc để ứng dụng Minibase Vault (Mac và Windows) ghi vào một thư mục cục bộ mà bạn mở như một kho Obsidian hoặc đặt bên trong kho hiện có.

Lưu ý cách tiếp cận khác nhau: Minibase cô đọng trang để đọc và để dùng với các công cụ AI như Claude, không phải bản sao giống hệt từng điểm ảnh. Miễn phí 20 lần lưu mỗi tháng mà không cần tài khoản, còn Minibase+ có giá 5,99 USD mỗi tháng.

Để xem so sánh trực tiếp hai công cụ, hãy đọc Obsidian Web Clipper vs Minibase, và để có cái nhìn toàn cảnh, xem các web clipper tốt nhất cho Obsidian năm 2026. Nhiều người dùng cả hai: clipper chính thức cho các lần lưu nhanh theo template, Minibase cho những trang thật sự quan trọng.