Ollama

registry.ollama.ai/library/… does not support tools

O erro

registry.ollama.ai/library/llama3:latest does not support tools

O nome do seu modelo vai ser diferente. Modelos comuns que disparam esse erro: llama3, gemma3, gemma2, dolphin3, phi4, llava, moondream, qwen2.5vl, tinyllama, codestral, deepseek-coder, llama2-uncensored.

O erro do Ollama "registry.ollama.ai/library/[model] does not support tools" (o modelo não suporta ferramentas) significa que o modelo não tem um template de chamada de ferramentas (tool calling), então ele consegue conversar, mas não consegue chamar ferramentas. Troque para um modelo compatível com ferramentas, como qwen3.5:9b, qwen3.8:27b, gemma4, hermes3 ou mistral, e confira se o seu baseUrl usa a API nativa, sem o sufixo /v1. Depois reinicie o seu agente.

Verificação rápida: seu modelo suporta ferramentas?

ollama show qwen3.5:9b | grep -i tool

Troque pelo nome do seu modelo. Se "tools" aparecer em Capabilities, o modelo suporta chamada de ferramentas. Se nada aparecer, ele não suporta. Para checar antes de baixar, procure a tag "tools" na página do modelo, ou veja todos os modelos compatíveis com ferramentas em ollama.com/search?c=tools.

Causa provável

Causa 1: o build do modelo no Ollama não tem template de chamada de ferramentas, então o Ollama recusa qualquer requisição que inclua ferramentas. Isso vale para modelos mais antigos e especializados, como llama3, gemma3, dolphin3, phi4 e modelos de visão como o llava, mesmo quando os pesos do modelo conseguem seguir instruções. Causa 2: até um modelo compatível com ferramentas falha em silêncio se o seu baseUrl termina em /v1, porque o caminho de streaming do /v1 descarta os chunks de chamada de ferramenta.

A correção

  1. 1 Troque para um modelo compatível com ferramentas: qwen3.5:9b em uma máquina de 16GB, qwen3.8:27b com 24GB ou mais, ou então gemma4:12b, hermes3:8b, llama3.1:8b ou mistral:7b.
  2. 2 Baixe o modelo com o Ollama e confirme a capacidade tools com ollama show.
  3. 3 Confira se o baseUrl do seu Ollama não tem o sufixo /v1 (use o endereço nativo http://127.0.0.1:11434).
  4. 4 Aponte o seu app para o nome do novo modelo (veja as correções por app abaixo) e reinicie o app.
ollama pull qwen3.5:9b

Seu modelo suporta ferramentas?

Entre os modelos que suportam ferramentas estão qwen3.8, qwen3.5, gemma4, hermes3, llama3.1 e mistral. Entre os que não suportam estão llama3, gemma3, gemma2, dolphin3, phi4 e llava. Encontre abaixo o nome do modelo que aparece no seu erro.

ModeloSuporta ferramentas?Motivo / correção
llama3:latest, llama3:8bNãoSem template de ferramentas. Use llama3.1:8b, o upgrade direto.
llama3.1:8bSimFunciona sem ajustes.
llama3.2:3bSimFunciona. É pequeno, então as chamadas de ferramenta são menos confiáveis do que em modelos 8B+.
llama3.3:70bSimFunciona. O llama3.3 só existe na versão 70b, não há 8b.
gemma3:1b, gemma3:4bNãoSó visão, sem template de ferramentas. Use gemma4:e4b.
gemma3:12b, gemma3:27bNãoMesmo caso. Use gemma4:12b, ou gemma4:31b para o tamanho maior.
gemma4 (e2b, e4b, 12b, 26b, 31b)SimFunciona, e ainda aceita entrada de imagem e áudio.
gemma2:2b, gemma2:9b, gemma2:27bNãoSem template de ferramentas. Use gemma4:e4b ou gemma4:12b.
dolphin3:latest, dolphin3:8bNãoSem template de ferramentas no build do Ollama. Use hermes3:8b ou llama3.1:8b.
dolphin-llama3:latestNãoMesmo caso. Use hermes3:8b.
dolphin-mistral:latestNãoMesmo caso. Use mistral:7b.
phi4:latest, phi4:14bNãoSem template de ferramentas. Use phi4-mini ou qwen3.5:9b.
phi4-miniSimFunciona. Atenção: o phi4-mini-reasoning não funciona.
phi3:miniNãoSem template de ferramentas. Use phi4-mini.
llava:7b, llava:latestNãoSó visão. Para visão com ferramentas, use qwen3-vl:8b ou gemma4.
moondream:latestNãoSó visão. Mesma troca do llava.
qwen2.5vl:3b, qwen2.5vl:7bNãoSó visão. Use qwen3-vl:4b ou qwen3-vl:8b, que adicionam ferramentas.
qwen2.5 (todos os tamanhos, incl. 3b)SimFunciona. Só a variante de visão qwen2.5vl não tem ferramentas.
tinyllama:latestNãoSem template de ferramentas e pequeno demais para agentes. Use qwen3.5:4b ou llama3.2:3b.
codestral:latestNãoModelo de autocompletar código, sem template de ferramentas. Use qwen3-coder:30b.
deepseek-coder:6.7bNãoSem template de ferramentas. Use qwen3.5:9b, ou qwen3-coder:30b com 24GB+.
llama2:latest, llama2-uncensored:7bNãoLegado, sem template de ferramentas. Use llama3.1:8b.
ornith-1.5:35bNãoO build da biblioteca do Ollama está marcado como só visão. Use ornith:35b, que tem ferramentas.
hermes3:8bSimFunciona, treinado especificamente para chamada de funções.
qwen3.5:9bSimFunciona. A escolha confortável para uma máquina de 16GB.
qwen3.8:27bSimFunciona. O melhor modelo local para agentes, conte com 24GB+.
qwen3-coder:30bSimFunciona. Código mais ferramentas.
mistral:7bSimFunciona.

Verificado com as tags de capacidade de cada modelo no ollama.com em setembro de 2026. As tags mudam quando os modelos são atualizados, então confirme localmente com ollama show.

Causa 3: seu Modelfile personalizado perdeu o template de ferramentas

Continua recebendo o erro com um modelo da lista "Sim"? Se você criou uma variante personalizada com ollama create (para aumentar a janela de contexto ou definir um system prompt), confira o template dela. O Ollama só ativa ferramentas quando o template faz referência a .Tools. Importar um GGUF puro, ou escrever a sua própria linha TEMPLATE, pode deixar esse bloco de fora, e aí o modelo personalizado perde as ferramentas mesmo que o modelo base tenha.

# 1. Check the custom model's template for a .Tools block
ollama show mymodel --template | grep -i tools

# 2. If nothing prints, start from the base model's full Modelfile
ollama show qwen3.5:9b --modelfile > Modelfile

# 3. Edit only the PARAMETER / SYSTEM lines you need, e.g.
#    PARAMETER num_ctx 32768

# 4. Recreate the model
ollama create mymodel -f Modelfile

Copie o template da mesma família de modelos que você está personalizando. Os templates são específicos de cada modelo, então um template de outro modelo vai gerar chamadas de ferramenta quebradas.

Correção para o seu app

O erro sempre vem do Ollama, mas o lugar onde você troca o modelo depende do app que enviou a requisição.

OpenClaw
Defina um modelo compatível com ferramentas como principal na configuração do gateway, ou troque no chat com /model, e depois reinicie o gateway.
primary: "ollama/qwen3.5:9b"
Hermes Agent
Defina o modelo predefinido, ou rode hermes model para escolher um de forma interativa.
hermes config set model.default qwen3.5:9b
Open WebUI
Escolha um modelo compatível com ferramentas no seletor de modelos no topo do chat. Para mudar o modelo predefinido para todos os usuários, use Admin Panel → Settings → Models.
n8n
Abra o sub-node Ollama Chat Model ligado ao seu node AI Agent e troque o campo Model por um modelo das linhas "Sim" acima.
LangChain / LlamaIndex
Troque o argumento model no ponto em que você cria o cliente e depois vincule suas ferramentas como antes.
llm = ChatOllama(model="qwen3.5:9b")
Qualquer outro app
Encontre onde o nome do modelo é configurado e troque por um modelo das linhas "Sim" acima.
Guia completoCorreção: OpenClaw "Model Does Not Support Tools"

Apareceu outro erro?

Cole qualquer erro de agente e receba a causa e a correção em segundos.

Abrir o decodificador

Perguntas frequentes

Como verifico se um modelo do Ollama suporta ferramentas?

Rode ollama show seguido do nome do modelo e procure "tools" em Capabilities, por exemplo ollama show qwen3.5:9b | grep -i tool. Antes de baixar, procure a tag "tools" na página do modelo no ollama.com, ou veja todos os modelos compatíveis com ferramentas em ollama.com/search?c=tools.

Isso é um bug no Ollama, no OpenClaw ou no meu modelo?

Nenhum deles está quebrado. O Ollama verifica se o template do modelo suporta chamadas de ferramenta e recusa a requisição se não suportar. Trocar para um modelo compatível com ferramentas resolve.

Troquei para um modelo compatível com ferramentas e o erro continua. Por quê?

Normalmente é uma de duas coisas. O seu app ainda está enviando o nome do modelo antigo (reinicie o app depois de mudar a configuração), ou você está rodando um modelo personalizado criado com ollama create cujo template não tem bloco .Tools. Recrie o modelo a partir do Modelfile do modelo base, como mostrado na Causa 3.

As ferramentas falham em silêncio, sem nenhum erro. Por quê?

O seu baseUrl provavelmente termina em /v1. O caminho de streaming /v1 do Ollama descarta os chunks delta de chamada de ferramenta, então até um modelo compatível com ferramentas falha. Use o endereço nativo http://127.0.0.1:11434.

Qual modelo local é melhor para chamada de ferramentas?

qwen3.8:27b se você tem 24GB ou mais de VRAM, qwen3.5:9b em uma máquina de 16GB, e gemma4:12b se você também precisa de entrada de imagem. hermes3:8b e llama3.1:8b são alternativas menores e confiáveis.

Chega de apagar incêndio com erros de agentes

Decodificar erros um por um é a versão manual do que o BetterClaw automatiza. Rode seus agentes em uma plataforma de agentes de IA no-code, com modelos gerenciados, novas tentativas automáticas e validação de configuração já integrados.

Free plan available · Pro $49/mo · BYOK · 7-day free trial