Obsidian Web Clipper não funciona? Soluções para cada erro

O Obsidian Web Clipper é uma ótima extensão gratuita e, na maior parte do tempo, simplesmente funciona. Quando não funciona, a mensagem é curta e enigmática: “Unable to find a vault”, uma nota só com o título, um popup que fica em branco.

A boa notícia: quase toda falha vem de um punhado de causas. Vale entender como o clipper trabalha. Ele extrai a página no navegador, copia o Markdown para a área de transferência e depois abre um link obsidian:// que pede ao app Obsidian para criar a nota. Ou seja, três peças precisam se encaixar: a extensão, a área de transferência e o app Obsidian com o cofre (vault) certo.

Abaixo, uma seção por sintoma, com a causa e a solução. As configurações aparecem com o nome usado na interface da extensão (em inglês), em Web Clipper Settings.

”Unable to find a vault for the URL” (vault não encontrado)

Essa mensagem vem do Obsidian, não da extensão. O clipper pediu um cofre pelo nome, e o Obsidian não tem nenhum com esse nome exato.

1. Abra Web Clipper Settings → General → Vaults.
2. Digite o nome do cofre, exatamente como aparece no seletor de cofres do Obsidian, e aperte Enter. Não o caminho da pasta (/Users/voce/Documents/Notas), só o nome (Notas). Maiúsculas e espaços fazem diferença.
3. Confira também cada template: o campo Vault de um template substitui o padrão e pode ainda apontar para um nome antigo.
4. Abra o cofre no Obsidian pelo menos uma vez neste computador, para que o app saiba que ele existe.

Cofres em unidades de rede ou dentro do WSL no Windows são casos-limite conhecidos (ambos são issues abertas no repositório do GitHub). Se o seu está aí, teste primeiro com um cofre local para confirmar a configuração.

Nada aparece no Obsidian, ou a nota fica vazia

A nota é criada com o nome certo, mas sem conteúdo, ou nada acontece. Quase sempre o conteúdo nunca passou pela área de transferência.

1. Confirme que o app Obsidian está instalado e que o navegador pode abri-lo. Na primeira vez, o navegador pergunta se pode abrir links do Obsidian: permita.
2. Verifique o campo Note location do template, ou seja, a pasta ou caminho da nota dentro do cofre.
3. Abra o console de desenvolvedor do navegador no popup para ver o erro real.
4. Continua vazia? Ative o Legacy mode (Web Clipper Settings → General). Ele envia o conteúdo no próprio link em vez de usar a área de transferência. O porém: páginas muito longas podem falhar sem aviso, porque navegadores e sistemas limitam o tamanho de um link.

No Linux, o culpado de sempre é o acesso à área de transferência (Wayland, regras de janela do KDE, Flatpak). A página oficial de solução de problemas traz instruções para cada configuração.

Falta conteúdo no recorte, ou “No content”

Por padrão, o clipper usa o Defuddle para manter só o conteúdo principal da página. Em alguns layouts ele é cauteloso demais e descarta trechos que você queria.

1. Selecione o texto desejado na página antes de recortar, ou use Cmd/Ctrl+A para selecionar tudo.
2. Use o Highlighter para marcar exatamente as partes que quer guardar.
3. Para um site que você recorta com frequência, crie um template com um gatilho para a URL dele e pegue a parte certa com uma variável de seletor como {{selectorHtml:article}}.

Se aparecer “Unable to extract page content”, recarregue a página e tente de novo: a extensão não conseguiu lê-la, o que acontece em páginas internas do navegador (configurações, loja de extensões) e em páginas que ainda estão carregando.

As imagens sumiram

Isso pega muita gente de surpresa: por padrão, as imagens ficam ligadas à URL original. Elas não são baixadas para o cofre. Se o site sair do ar ou bloquear o hotlinking, as imagens somem da nota.

Para guardá-las localmente, abra a nota no Obsidian e rode o comando Download attachments for current file pela paleta de comandos. Alguns sites (galerias com carregamento lento, imagens em base64, artigos do WeChat) ainda têm bugs abertos, então confira o resultado nas páginas importantes.

”Failed to save file”

Esse erro aparece quando a última etapa do salvamento falha: o envio pelo “Add to Obsidian” ou a opção Save file…, que baixa um arquivo .md.

1. Atualize a extensão e o app Obsidian. Muitos bugs de salvamento foram corrigidos em versões menores.
2. Teste Save file… no menu ao lado do botão principal. Se funcionar, o problema está na passagem para o Obsidian (volte às etapas de cofre e área de transferência acima).
3. Se o próprio download falhar, verifique se o navegador permite downloads de extensões e não pergunta onde salvar cada arquivo.

”Failed to fetch” e Interpreter que não funciona

“Failed to fetch” quase sempre significa que uma requisição de rede foi bloqueada, e na prática costuma ser o Interpreter, o recurso opcional de IA que roda prompts na página.

1. Em Web Clipper Settings → Interpreter, confira se Enable Interpreter está ligado e se o provedor tem uma chave de API válida.
2. Com um provedor personalizado, a Base URL precisa ser o endpoint de chat completions, que geralmente termina em /chat/completions.
3. Com o Ollama, inicie o servidor liberando as origens das extensões; senão você recebe um 403: OLLAMA_ORIGINS=moz-extension://*,chrome-extension://*,safari-web-extension://* ollama serve
4. Se o Interpreter dá respostas sem relação em páginas longas, o contexto padrão do Ollama é pequeno (2048 tokens). Aumente o num_ctx ou reduza o contexto com um seletor.

Web Clipper não funciona no iOS ou no Safari

No iPhone e no iPad, o clipper é uma extensão do Safari, e ela fica desligada até você ativá-la.

1. No Safari, toque no botão à esquerda da barra de endereço → Gerenciar Extensões e ative o Obsidian Web Clipper.
2. Em Ajustes do iOS → Apps → Safari → Extensões, permita que ela rode em todos os sites.
3. Em Ajustes do iOS → Apps → Obsidian, defina Colar de Outros Apps como Permitir. Sem isso, o Obsidian não consegue ler o que o clipper copiou, e você recebe notas vazias.

No Safari (Mac ou iOS), se as notas chegam com o conteúdo errado ou só com o título, uma solução relatada no GitHub é ativar o Legacy mode. Um popup em branco costuma se resolver fechando a aba e reabrindo o Safari.

Como salvar numa pasta específica

Não é um erro, mas é uma das dúvidas mais buscadas. Cada template tem um campo Note location: digite o caminho da pasta dentro do cofre (por exemplo Clippings/Artigos). Você também pode mudar a pasta no popup antes de clicar em Add to Obsidian. Crie um template por destino e adicione triggers (padrões de URL) para que o certo seja escolhido automaticamente.

Quando o clipper continua falhando: uma alternativa

Se você já passou por tudo isso e o recorte continua instável no seu caso (cofre num drive sincronizado ou de rede, iPhone que perde permissões, sites que chegam vazios), vale ter uma segunda ferramenta que não depende da mesma cadeia.

O Minibase é uma extensão do Chrome que funciona de outro jeito: não precisa do app Obsidian aberto nem de conexão com o cofre. Ele envia a página para uma IA que identifica o conteúdo principal e devolve Markdown limpo e estruturado. Você pode baixar o arquivo .md ou deixar o app Minibase Vault (Mac e Windows) gravá-lo numa pasta local que você abre como cofre do Obsidian ou coloca dentro do seu.

Saiba que a abordagem é diferente: o Minibase condensa as páginas para leitura e para ferramentas de IA como o Claude, não é uma cópia perfeita pixel a pixel. É grátis até 20 salvamentos por mês sem conta, e o Minibase+ custa US$ 5,99 por mês.

Para um teste lado a lado das duas ferramentas, leia Obsidian Web Clipper vs Minibase, e para o panorama completo, os melhores web clippers para Obsidian em 2026. Muita gente usa os dois: o clipper oficial para capturas rápidas com template, o Minibase para as páginas que importam.