옵시디언 웹 클리퍼 안될 때 해결 방법 총정리

Obsidian Web Clipper는 훌륭한 무료 확장 프로그램이고, 대부분은 문제없이 작동합니다. 하지만 안 될 때는 오류 메시지가 짧고 알쏭달쏭합니다. “Unable to find a vault”, 제목만 있는 노트, 하얗게 비어 있는 팝업.

다행히 거의 모든 문제는 몇 가지 원인으로 정리됩니다. 클리퍼가 어떻게 작동하는지 알면 도움이 됩니다. 클리퍼는 브라우저에서 페이지를 추출하고, Markdown을 클립보드에 복사한 다음, obsidian:// 링크를 열어 Obsidian 앱이 노트를 만들게 합니다. 즉 브라우저 확장 프로그램, 클립보드, 올바른 볼트(vault)를 가진 Obsidian 앱, 이 세 가지가 맞물려야 합니다.

아래에 증상별로 원인과 해결 방법을 정리했습니다. 설정 이름은 확장 프로그램 화면(Web Clipper Settings)에 표시되는 영어 그대로 적었습니다.

”Unable to find a vault for the URL” (볼트를 찾을 수 없음)

이 메시지는 확장 프로그램이 아니라 Obsidian이 띄우는 것입니다. 클리퍼가 이름으로 볼트를 요청했는데, Obsidian에 그 이름과 정확히 일치하는 볼트가 없다는 뜻입니다.

1. Web Clipper Settings → General → Vaults를 엽니다.
2. Obsidian 볼트 전환 화면에 보이는 그대로 볼트 이름을 입력하고 Enter를 누릅니다. 폴더 경로(/Users/you/Documents/Notes)가 아니라 이름(Notes)만 입력합니다. 대소문자와 공백도 구분합니다.
3. 템플릿도 하나씩 확인하세요. 템플릿의 Vault 항목은 기본값보다 우선하며, 예전 이름이 그대로 남아 있을 수 있습니다.
4. 이 컴퓨터의 Obsidian에서 해당 볼트를 최소 한 번은 열어, 앱이 볼트의 존재를 알게 합니다.

네트워크 드라이브에 있는 볼트나 Windows WSL 안의 볼트는 알려진 예외 사례입니다(둘 다 GitHub 저장소에 열린 이슈가 있습니다). 해당된다면 먼저 로컬 볼트로 설정이 맞는지 확인해 보세요.

Obsidian에 아무것도 안 뜨거나 노트가 비어 있음

파일 이름은 맞는데 내용이 없거나, 아무 일도 일어나지 않는 경우입니다. 대부분 내용이 클립보드를 거쳐 전달되지 못한 것입니다.

1. Obsidian 앱이 설치되어 있고 브라우저가 앱을 열 수 있는지 확인합니다. 처음에는 브라우저가 Obsidian 링크를 열지 묻는데, 허용해 주세요.
2. 템플릿의 Note location, 즉 볼트 안에서 노트가 저장될 폴더나 경로를 확인합니다.
3. 확장 프로그램 팝업에서 브라우저 개발자 콘솔을 열어 실제 오류를 확인합니다.
4. 그래도 비어 있다면 Legacy mode(Web Clipper Settings → General)를 켭니다. 클립보드 대신 링크 자체에 내용을 담아 보내는 방식입니다. 단, 브라우저와 OS가 링크 길이를 제한하기 때문에 아주 긴 페이지는 오류 없이 실패할 수 있습니다.

Linux에서는 클립보드 접근 권한(Wayland, KDE 창 규칙, Flatpak)이 흔한 원인입니다. 공식 문제 해결 페이지에 환경별 안내가 있습니다.

내용이 빠지거나 “No content”가 뜸

클리퍼는 기본적으로 Defuddle을 사용해 페이지의 본문만 남깁니다. 레이아웃에 따라 지나치게 보수적으로 동작해 원하는 부분까지 빠뜨리기도 합니다.

1. 클리핑 전에 페이지에서 원하는 텍스트를 선택하거나, Cmd/Ctrl+A로 전체를 선택합니다.
2. Highlighter로 남기고 싶은 부분을 정확히 표시합니다.
3. 자주 저장하는 사이트라면 그 URL을 트리거로 하는 템플릿을 만들고, {{selectorHtml:article}} 같은 선택자 변수로 필요한 부분만 가져옵니다.

“Unable to extract page content”가 보이면 페이지를 새로고침한 뒤 다시 시도하세요. 확장 프로그램이 페이지를 읽지 못했다는 뜻으로, 브라우저 내부 페이지(설정, 확장 프로그램 스토어)나 아직 로딩 중인 페이지에서 발생합니다.

이미지가 사라짐

많은 분이 놀라는 부분인데, 이미지는 설계상 원본 URL에 링크된 상태로 남고 볼트에 다운로드되지 않습니다. 사이트가 내려가거나 핫링크를 막으면 노트에서 이미지가 사라집니다.

로컬에 보관하려면 Obsidian에서 노트를 열고 명령 팔레트에서 Download attachments for current file 명령을 실행하세요. 일부 사이트(지연 로딩 갤러리, base64 이미지, WeChat 글)는 아직 해결되지 않은 버그가 있으니 중요한 페이지는 결과를 확인하는 것이 좋습니다.

”Failed to save file”

저장의 마지막 단계가 실패할 때 나오는 오류입니다. “Add to Obsidian”으로 넘기는 과정이거나, 대신 .md 파일을 내려받는 Save file… 옵션입니다.

1. 확장 프로그램과 Obsidian 앱을 모두 최신 버전으로 업데이트합니다. 저장 관련 버그 상당수가 마이너 업데이트에서 고쳐졌습니다.
2. 메인 버튼 옆 드롭다운에서 **Save file…**을 시도해 봅니다. 이게 된다면 문제는 Obsidian으로 넘기는 단계입니다(위의 볼트·클립보드 항목으로 돌아가세요).
3. 다운로드 자체가 실패한다면, 브라우저가 확장 프로그램의 다운로드를 허용하는지, 파일마다 저장 위치를 묻도록 설정되어 있지 않은지 확인합니다.

”Failed to fetch”와 Interpreter가 작동하지 않을 때

“Failed to fetch”는 거의 항상 네트워크 요청이 차단되었다는 뜻이며, 실제로는 페이지에서 프롬프트를 실행하는 선택형 AI 기능인 Interpreter에서 주로 발생합니다.

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 토큰)가 작기 때문입니다. num_ctx를 늘리거나 선택자로 컨텍스트를 좁히세요.

iOS나 Safari에서 웹 클리퍼가 안 될 때

iPhone과 iPad에서 클리퍼는 Safari 확장 프로그램이며, 직접 켜기 전까지는 꺼져 있습니다.

1. Safari에서 주소창 왼쪽 버튼을 탭 → 확장 프로그램 관리에서 Obsidian Web Clipper를 켭니다.
2. iOS 설정 → 앱 → Safari → 확장 프로그램에서 모든 웹사이트에서 실행되도록 허용합니다.
3. iOS 설정 → 앱 → Obsidian에서 다른 앱에서 붙여넣기를 허용으로 설정합니다. 이 권한이 없으면 Obsidian이 클리퍼가 복사한 내용을 읽지 못해 빈 노트가 생깁니다.

Safari(Mac 또는 iOS)에서 노트에 엉뚱한 내용이 들어가거나 제목만 저장된다면, GitHub에 보고된 우회 방법은 Legacy mode를 켜는 것입니다. 팝업이 하얗게 비어 있다면 탭을 닫고 Safari를 다시 열면 대개 해결됩니다.

특정 폴더에 저장하는 방법

오류는 아니지만 가장 많이 검색되는 질문 중 하나입니다. 각 템플릿에는 Note location 항목이 있으니 볼트 안의 폴더 경로(예: Clippings/Articles)를 입력하세요. Add to Obsidian을 누르기 전에 팝업에서 폴더를 바꿀 수도 있습니다. 저장 위치마다 템플릿을 하나씩 만들고 triggers(URL 패턴)를 추가하면 알맞은 템플릿이 자동으로 선택됩니다.

계속 실패한다면: 대안

여기까지 다 해 봐도 클리핑이 불안정하다면(동기화 드라이브나 네트워크 드라이브의 볼트, 권한이 자꾸 풀리는 iPhone, 비어서 저장되는 사이트), 같은 연결 고리에 의존하지 않는 두 번째 도구를 두는 것이 도움이 됩니다.

Minibase는 방식이 다른 Chrome 확장 프로그램으로, Obsidian 앱을 열어 둘 필요도 볼트 연결도 필요 없습니다. 페이지를 AI에 보내 본문을 가려내고, 깔끔하게 구조화된 Markdown으로 돌려줍니다. .md 파일로 내려받거나, Minibase Vault 앱(Mac, Windows)이 로컬 폴더에 저장하게 한 뒤 그 폴더를 Obsidian 볼트로 열거나 기존 볼트 안에 둘 수 있습니다.

접근 방식의 차이는 알아 두세요. Minibase는 페이지를 읽기 좋게, 그리고 Claude 같은 AI 도구에 쓰기 좋게 압축하는 도구이지, 픽셀 단위로 똑같이 복사하는 도구가 아닙니다. 계정 없이 월 20회까지 무료이며, Minibase+는 월 5.99달러입니다.

두 도구를 나란히 비교한 결과는 Obsidian Web Clipper vs Minibase에서, 전체 선택지는 2026년 최고의 Obsidian 웹 클리퍼에서 확인하세요. 템플릿으로 빠르게 담을 때는 공식 클리퍼, 중요한 페이지는 Minibase로 둘 다 쓰는 분도 많습니다.