registry.ollama.ai/library/… does not support tools (no admite herramientas)
El error
registry.ollama.ai/library/llama3:latest does not support toolsEl nombre de tu modelo será distinto. Modelos comunes que provocan este error: llama3, gemma3, gemma2, dolphin3, phi4, llava, moondream, qwen2.5vl, tinyllama, codestral, deepseek-coder, llama2-uncensored.
El error de Ollama "registry.ollama.ai/library/[model] does not support tools" (el modelo no admite herramientas) significa que el modelo no tiene una plantilla de llamada a herramientas, así que puede conversar pero no puede llamar herramientas. Cambia a un modelo compatible con herramientas como qwen3.5:9b, qwen3.8:27b, gemma4, hermes3 o mistral, y asegúrate de que tu baseUrl use la API nativa sin el sufijo /v1. Luego reinicia tu agente.
¿Tu modelo admite herramientas?
ollama show qwen3.5:9b | grep -i toolUsa el nombre de tu propio modelo. Si aparece "tools" en Capabilities, el modelo admite llamadas a herramientas. Si no aparece nada, no las admite. Para comprobarlo antes de descargarlo, busca la etiqueta "tools" en la página del modelo, o explora todos los modelos compatibles con herramientas en ollama.com/search?c=tools.
Causa probable
Causa 1: la compilación del modelo en Ollama no tiene plantilla de llamada a herramientas, así que Ollama rechaza cualquier solicitud que incluya herramientas. Esto afecta a modelos más antiguos y especializados como llama3, gemma3, dolphin3, phi4 y modelos de visión como llava, aunque los pesos de base puedan seguir instrucciones. Causa 2: incluso un modelo compatible con herramientas falla sin mostrar error si tu baseUrl termina en /v1, porque la ruta de streaming de /v1 descarta los fragmentos de llamadas a herramientas.
La solución
- 1 Cambia a un modelo compatible con herramientas: qwen3.5:9b en una máquina de 16GB, qwen3.8:27b con 24GB o más, o gemma4:12b, hermes3:8b, llama3.1:8b o mistral:7b.
- 2 Descárgalo con Ollama y confirma la capacidad de herramientas con ollama show.
- 3 Asegúrate de que tu baseUrl de Ollama no tenga el sufijo /v1 (usa la ruta nativa http://127.0.0.1:11434).
- 4 Apunta tu app al nombre del nuevo modelo (consulta las soluciones por app más abajo) y reiníciala.
ollama pull qwen3.5:9b¿Tu modelo admite herramientas?
Entre los modelos que admiten herramientas están qwen3.8, qwen3.5, gemma4, hermes3, llama3.1 y mistral. Entre los que no las admiten están llama3, gemma3, gemma2, dolphin3, phi4 y llava. Busca abajo el nombre del modelo que aparece en tu error.
| Modelo | ¿Admite herramientas? | Motivo / solución |
|---|---|---|
| llama3:latest, llama3:8b | No | Sin plantilla de herramientas. Usa llama3.1:8b, la actualización directa. |
| llama3.1:8b | Sí | Funciona sin configuración adicional. |
| llama3.2:3b | Sí | Funciona. Es pequeño, así que las llamadas a herramientas son menos fiables que en 8B+. |
| llama3.3:70b | Sí | Funciona. llama3.3 solo se publica como 70b, no existe 8b. |
| gemma3:1b, gemma3:4b | No | Solo visión, sin plantilla de herramientas. Usa gemma4:e4b. |
| gemma3:12b, gemma3:27b | No | Lo mismo. Usa gemma4:12b, o gemma4:31b para el tamaño mayor. |
| gemma4 (e2b, e4b, 12b, 26b, 31b) | Sí | Funciona, y además acepta entrada de imagen y audio. |
| gemma2:2b, gemma2:9b, gemma2:27b | No | Sin plantilla de herramientas. Usa gemma4:e4b o gemma4:12b. |
| dolphin3:latest, dolphin3:8b | No | Sin plantilla de herramientas en la compilación de Ollama. Usa hermes3:8b o llama3.1:8b. |
| dolphin-llama3:latest | No | Lo mismo. Usa hermes3:8b. |
| dolphin-mistral:latest | No | Lo mismo. Usa mistral:7b. |
| phi4:latest, phi4:14b | No | Sin plantilla de herramientas. Usa phi4-mini o qwen3.5:9b. |
| phi4-mini | Sí | Funciona. Ojo: phi4-mini-reasoning no funciona. |
| phi3:mini | No | Sin plantilla de herramientas. Usa phi4-mini. |
| llava:7b, llava:latest | No | Solo visión. Para visión más herramientas, usa qwen3-vl:8b o gemma4. |
| moondream:latest | No | Solo visión. El mismo cambio que con llava. |
| qwen2.5vl:3b, qwen2.5vl:7b | No | Solo visión. Usa qwen3-vl:4b o qwen3-vl:8b, que añaden herramientas. |
| qwen2.5 (todos los tamaños, incl. 3b) | Sí | Funciona. Solo la variante de visión qwen2.5vl no tiene herramientas. |
| tinyllama:latest | No | Sin plantilla de herramientas, y demasiado pequeño para agentes. Usa qwen3.5:4b o llama3.2:3b. |
| codestral:latest | No | Modelo de autocompletado de código, sin plantilla de herramientas. Usa qwen3-coder:30b. |
| deepseek-coder:6.7b | No | Sin plantilla de herramientas. Usa qwen3.5:9b, o qwen3-coder:30b con 24GB+. |
| llama2:latest, llama2-uncensored:7b | No | Modelo heredado, sin plantilla de herramientas. Usa llama3.1:8b. |
| ornith-1.5:35b | No | La compilación de la biblioteca de Ollama está etiquetada solo para visión. Usa ornith:35b, que tiene herramientas. |
| hermes3:8b | Sí | Funciona, entrenado específicamente para llamadas a funciones. |
| qwen3.5:9b | Sí | Funciona. La opción cómoda para una máquina de 16GB. |
| qwen3.8:27b | Sí | Funciona. El mejor modelo local para agentes, cuenta con 24GB+. |
| qwen3-coder:30b | Sí | Funciona. Código más herramientas. |
| mistral:7b | Sí | Funciona. |
Verificado con las etiquetas de capacidades de cada modelo en ollama.com en septiembre de 2026. Las etiquetas cambian a medida que se actualizan los modelos, así que confírmalo localmente con ollama show.
Causa 3: tu Modelfile personalizado perdió la plantilla de herramientas
¿Sigues viendo el error con un modelo de la lista "Sí"? Si creaste una variante personalizada con ollama create (para ampliar la ventana de contexto o definir un prompt de sistema), revisa su plantilla. Ollama solo habilita las herramientas cuando la plantilla hace referencia a .Tools. Importar un GGUF sin procesar, o escribir tu propia línea TEMPLATE, puede dejar fuera ese bloque, así que el modelo personalizado pierde las herramientas aunque el modelo base sí las tenga.
# 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 ModelfileCopia la plantilla de la misma familia de modelos que estás personalizando. Las plantillas son específicas de cada modelo, así que una plantilla de otro modelo producirá llamadas a herramientas defectuosas.
Solución para tu app específica
El error siempre viene de Ollama, pero el lugar donde cambias el modelo depende de qué app envió la solicitud.
- OpenClaw
- Define un modelo compatible con herramientas como principal en la configuración del gateway, o cámbialo en el chat con /model, y luego reinicia el gateway.
primary: "ollama/qwen3.5:9b" - Hermes Agent
- Define el modelo predeterminado, o ejecuta hermes model para elegir uno de forma interactiva.
hermes config set model.default qwen3.5:9b - Open WebUI
- Elige un modelo compatible con herramientas en el selector de modelos de la parte superior del chat. Para cambiar el predeterminado para todos, usa Admin Panel → Settings → Models.
- n8n
- Abre el subnodo Ollama Chat Model conectado a tu nodo AI Agent y cambia el campo Model por uno de las filas "Sí" de arriba.
- LangChain / LlamaIndex
- Cambia el argumento model donde construyes el cliente y luego vincula tus herramientas como antes.
llm = ChatOllama(model="qwen3.5:9b") - Cualquier otra app
- Busca dónde se configura el nombre del modelo y reemplázalo por un modelo de las filas "Sí" de arriba.
¿Te salió otro error?
Pega cualquier error de agente y obtén la causa y la solución en segundos.
Preguntas frecuentes
¿Cómo verifico si un modelo de Ollama admite herramientas?
Ejecuta ollama show seguido del nombre del modelo y busca "tools" en Capabilities, por ejemplo ollama show qwen3.5:9b | grep -i tool. Antes de descargarlo, busca la etiqueta "tools" en la página del modelo en ollama.com, o explora ollama.com/search?c=tools para ver todos los modelos compatibles con herramientas.
¿Es un bug de Ollama, de OpenClaw o de mi modelo?
Ninguno está roto. Ollama comprueba si la plantilla del modelo admite llamadas a herramientas y rechaza la solicitud si no es así. Cambiar a un modelo compatible con herramientas lo soluciona.
Cambié a un modelo compatible con herramientas y sigo viendo el error. ¿Por qué?
Normalmente es una de dos cosas. Tu app sigue enviando el nombre del modelo anterior (reiníciala después de cambiar la configuración), o estás usando un modelo personalizado creado con ollama create cuya plantilla no tiene un bloque .Tools. Vuelve a crearlo a partir del Modelfile del modelo base, como se muestra en la Causa 3.
Las herramientas fallan sin mostrar ningún error. ¿Por qué?
Probablemente tu baseUrl termina en /v1. La ruta de streaming /v1 de Ollama descarta los fragmentos delta de llamadas a herramientas, así que incluso un modelo compatible con herramientas falla. Usa la ruta nativa http://127.0.0.1:11434 en su lugar.
¿Cuál es el mejor modelo local para llamadas a herramientas?
qwen3.8:27b si tienes 24GB o más de VRAM, qwen3.5:9b en una máquina de 16GB, y gemma4:12b si además necesitas entrada de imagen. hermes3:8b y llama3.1:8b son alternativas más pequeñas y fiables.
Deja de apagar incendios con errores de agentes
Decodificar errores uno por uno es la versión manual de lo que BetterClaw automatiza. Ejecuta tus agentes en una plataforma de agentes de IA sin código con modelos administrados, reintentos y validación de configuración integrados.
Free plan available · Pro $49/mo · BYOK · 7-day free trial
