Obsidian Web Clipperが動かない時の対処法

Obsidian Web Clipperは優れた無料の拡張機能で、たいていは問題なく動きます。ただ、うまくいかないときのエラーは短くて分かりにくいものです。「Unable to find a vault」、タイトルだけのノート、真っ白なままのポップアップ。

朗報もあります。ほとんどの不具合は、いくつかの決まった原因から起きています。まずクリッパーの仕組みを知っておくと役立ちます。ブラウザ内でページを抽出し、Markdownをクリップボードにコピーし、obsidian:// リンクを開いてObsidianアプリにノートを作らせます。つまり、ブラウザ拡張機能、クリップボード、正しいVaultを持つObsidianアプリの三つがかみ合う必要があります。

以下、症状ごとに原因と直し方をまとめます。設定名は拡張機能の画面（Web Clipper Settings）に表示される英語のままにしています。

「Unable to find a vault for the URL」（Vaultが見つからない）

このメッセージは拡張機能ではなくObsidian側が出しています。クリッパーが名前でVaultを指定したのに、Obsidianにその名前と完全に一致するVaultがない、という意味です。

1. Web Clipper Settings → General → Vaults を開きます。
2. ObsidianのVault切り替え画面に表示されているとおりの Vault名 を入力し、Enterを押します。フォルダのパス（/Users/you/Documents/Notes）ではなく、名前（Notes）だけです。大文字・小文字やスペースも区別されます。
3. 各テンプレートも確認しましょう。テンプレートの Vault 欄はデフォルト設定より優先され、古い名前のままになっていることがあります。
4. このパソコンのObsidianでそのVaultを一度は開き、アプリに存在を認識させます。

ネットワークドライブ上のVaultや、WindowsのWSL内にあるVaultは既知の例外ケースです（どちらも GitHubリポジトリ で未解決のissueがあります）。該当する場合は、まずローカルのVaultで設定が正しいか確かめてください。

Obsidianに何も表示されない、またはノートが空

ファイル名は正しいのに中身が空、あるいは何も起きない。ほとんどの場合、内容がクリップボードを通って届いていません。

1. Obsidianアプリがインストールされ、ブラウザから開けることを確認します。初回はObsidianのリンクを開くか聞かれるので、許可してください。
2. テンプレートの Note location（Vault内のノートの保存先フォルダやパス）を確認します。
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へのリンクのまま になり、Vaultにはダウンロードされません。サイトが落ちたり直リンクを禁止したりすると、ノートから画像が消えます。

手元に残したい場合は、Obsidianでノートを開き、コマンドパレットから Download attachments for current file を実行します。一部のサイト（遅延読み込みのギャラリー、base64画像、WeChatの記事）にはまだ未解決のバグがあるので、大事なページは結果を確認しましょう。

「Failed to save file」

保存の最後の段階で失敗したときに出るエラーです。「Add to Obsidian」での受け渡しか、代わりに .md ファイルをダウンロードする Save file… のどちらかです。

1. 拡張機能とObsidianアプリの両方を最新版に更新します。保存まわりの不具合の多くはマイナーアップデートで直っています。
2. メインボタン横のメニューから Save file… を試します。これが動くなら、問題はObsidianへの受け渡しです（上のVaultとクリップボードの手順に戻ってください）。
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トークン）が小さすぎます。num_ctx を増やすか、セレクタでコンテキストを絞ってください。

iOSやSafariでWeb Clipperが動かない

iPhoneとiPadでは、クリッパーはSafariの拡張機能で、自分でオンにするまで無効のままです。

1. Safariでアドレスバー左のボタンをタップ → 機能拡張を管理 を開き、Obsidian Web Clipperをオンにします。
2. iOSの設定 → アプリ → Safari → 機能拡張で、すべてのWebサイトでの実行を許可します。
3. iOSの設定 → アプリ → Obsidianで、ほかのAppからペースト を 許可 にします。これがないとObsidianはクリッパーがコピーした内容を読めず、ノートが空になります。

Safari（MacでもiOSでも）で、ノートの中身が別の内容になったりタイトルだけになったりする場合、GitHubで報告されている回避策は Legacy mode をオンにすることです。ポップアップが真っ白なときは、タブを閉じてSafariを開き直すとたいてい直ります。

特定のフォルダに保存する方法

エラーではありませんが、よく検索される質問です。各テンプレートには Note location 欄があり、Vault内のフォルダパス（例：Clippings/Articles）を入力します。Add to Obsidian を押す前に、ポップアップでフォルダを変えることもできます。保存先ごとにテンプレートを作り、triggers（URLパターン）を設定すれば、適切なテンプレートが自動で選ばれます。

それでも失敗が続くときの代替手段

ここまで試してもクリップが不安定な場合（同期ドライブやネットワークドライブ上のVault、権限がすぐ外れるiPhone、空で保存されるサイトなど）、同じ仕組みに頼らない二つ目のツールを持っておくと安心です。

Minibase は仕組みの異なるChrome拡張機能で、Obsidianアプリを開いておく必要も、Vaultとの接続も要りません。ページをAIに送り、本文を見極めて、きれいに構造化されたMarkdownを返します。.md ファイルとしてダウンロードするか、Minibase Vaultアプリ（MacとWindows）にローカルフォルダへ書き出させて、そのフォルダをObsidianのVaultとして開く、または既存のVaultの中に置くこともできます。

アプローチの違いには注意してください。Minibaseはページを読みやすく、ClaudeなどのAIツールで使いやすいよう要約・整理するもので、ピクセル単位の完全なコピーではありません。アカウント不要で月20回まで無料、Minibase+は月額5.99ドルです。

二つのツールを並べて試した結果は Obsidian Web ClipperとMinibaseの比較、選択肢全体は 2026年のObsidian Webクリッパー比較 をご覧ください。手早くテンプレートで取り込むときは公式クリッパー、大事なページはMinibase、と両方を使い分けている人も多いです。