Ollama 报错 “does not support tools”:先 ollama show 查能力,再换模型或改模板(实测)
“does not support tools” 说明模型没有 tools 能力。用 ollama show 查 Capabilities;解法是换一个带 Tools 标签的模型,或给自己导入的 GGUF 加带 .Tools 的模板。Ollama 0.40.15 实测报错和模板修法,真实调用质量未测。

先说结论:registry.ollama.ai/library/<模型>:latest does not support tools 的意思是,你选的模型没有声明 tools(工具调用)能力,所以 Ollama 拒绝任何带 tools 数组的请求。用 ollama show <模型> 检查:Capabilities 列表里必须有 tools。最干净的办法是换一个在 ollama.com 上带 Tools 标签的模型。如果你是自己导入的 GGUF,原因通常是 Modelfile 的 TEMPLATE 里根本没提工具。我在 Ollama 0.40.15 上用一个很小的测试模型复现了这个报错,并测试了报错本身和模板修法。真正的工具调用质量我没法测,因为测试模型文件只有 1.19 MB(加载后约 6 MB;Hugging Face 上的 stories260K.gguf)。
报错说的是什么
这是我拿到的报错原文,Ollama 原生 API 和兼容 OpenAI 的接口各返回一次,都是 HTTP 400:
{"error":"registry.ollama.ai/library/tiny:latest does not support tools"}
{"error":{"message":"registry.ollama.ai/library/tiny:latest does not support tools","type":"invalid_request_error","param":null,"code":null}}
触发它的是一个普通聊天请求,只是多了 tools 字段。同一个模型回答不带 tools 的同一段聊天时返回 HTTP 200。所以模型本身能用,只是工具部分被拒。很多智能体工具和编程助手每个请求都会带 tools,所以你一把它们指向没有这个能力的模型,就会撞上这个报错。
第 1 步:检查模型的能力
ollama show <模型>
我的测试模型输出结尾是这样:
Capabilities
completion
没有 tools 这一行,任何带 tools 的请求都会失败。你也可以用 POST /api/show 从 API 读到同样的列表,在 capabilities 字段里(我的返回 ['completion'])。能用的模型,列表里会有 tools。
解法一:换一个有 tools 能力的模型
这是几乎所有人该用的办法。Ollama 的模型搜索有 tools 分类:ollama.com/search?c=tools。从那个列表里挑一个内存放得下的,拉取下来,把你的工具指向它。Ollama 的工具调用文档在示例里用的是 qwen3。选模型大小和内存可以参考本地大模型推荐和本地写代码用什么模型和硬件。
解法二:给自己导入的模型加一个带工具的模板
如果你用自己的 Modelfile 导入了 GGUF,而它的 TEMPLATE 没有处理工具,Ollama 就不会列出这个能力。我测了。用下面这个 Modelfile,能力是缺失的:
FROM ./model.gguf
而用下面这个——模板里只是提到了 .Tools——Capabilities 列表多了 tools,同一个请求也不再返回这个报错:
FROM ./model.gguf
TEMPLATE """{{- if .Tools }}Tools: {{ .Tools }}
{{ end }}{{- range .Messages }}{{ .Role }}: {{ .Content }}
{{ end }}assistant: """
运行 ollama create my-model -f Modelfile 之后,ollama show my-model 列出了 completion 和 tools。
请认真看这个办法的局限:
- 我只测了报错会消失。我的测试模型太小,根本调不了工具,所以调用质量我什么都不能说。
- Ollama 的 Modelfile 文档把
.System、.Prompt、.Response列为模板变量,没有描述.Tools。我看到的是 0.40.15 版本的行为,请当作观察,而不是有文档保证的行为。 - 一个从没训练过工具调用的模型,不会因为模板里提到了工具就变得擅长。请用模型作者提供的真实模板,不要像我这样随手编一个。
它不是什么
- 不是内存问题。如果看到 “model requires more system memory”,请看那篇文章。
- 不是网络故障。“max retries exceeded” 见 Ollama max retries exceeded。
- 不是上下文大小的问题,不过很长的工具列表会吃掉上下文。见 Ollama 上下文长度。
更多报错在 Ollama 与 llama.cpp 报错清单里。
常见问题
我能在客户端里把工具关掉吗?
如果你的客户端允许关闭工具或函数调用,请求就不会带 tools,我的测试模型对这样的请求回答正常。但很多智能体工具没有工具根本没法工作,所以换成有该能力的模型才是真正的办法。
为什么在别处支持工具的模型,到 Ollama 上就报错?
据我所见,Ollama 从模型自身的元数据和模板里读取这个能力。同样的权重,如果导入时没有带工具的模板,在我的测试里就不显示 tools 能力。
兼容 OpenAI 的接口表现不一样吗?
这次没有。两个接口都返回 HTTP 400,报错文字一样。
来源与测试说明
- Ollama 文档:工具调用(
docs.ollama.com/capabilities/tool-calling)和 Modelfile 参考(docs.ollama.com/modelfile)。 - 自己实测:Linux 上的 Ollama 0.40.15,用 1.19 MB 的
stories260K.gguf测试模型:/api/chat与/v1/chat/completions上的报错、ollama show、/api/show、带{{ .Tools }}的模板。 - 没测:真实的工具调用、库里的任何真实模型、Windows 或 macOS、客户端应用。
相关阅读:Ollama 显卡要求(按显存档位).