——
Ollama 模型工具能力默认启用：OpenClaw 新功能解析与配置指南
OpenClaw 最新版本为 Ollama 本地模型带来了关键兼容性改进——未知能力定义的模型将默认启用工具调用（Tools）支持。这一更新解决了开发者在集成本地 LLM 时频繁遇到的”模型不支持函数调用”错误，让 AI Agent 开发更加顺畅。
—
为什么这次更新很重要？
在之前的版本中，当 OpenClaw 加载 Ollama 本地模型时，如果模型元数据未明确声明 capabilities 字段，系统会保守地将 supportsTools 标记为 false。这导致大量实际支持工具调用的开源模型（如 Qwen、Llama 3 等）无法与 AI Agent 框架正常协作。
本次更新（PR #84075）通过以下方式修复该问题：
| 场景 | 更新前 | 更新后 |
|:—|:—|:—|
| 模型无明确能力声明 | supportsTools: false | supportsTools: true（默认启用） |
| 显式声明无工具能力 | supportsTools: false | supportsTools: false（尊重配置） |
| 显式声明有工具能力 | supportsTools: true | supportsTools: true（保持不变） |
—
技术实现详解
核心代码变更
本次修改位于 Ollama 提供者的模型能力解析逻辑。以下是关键实现片段：
// 简化示意：OpenClaw Ollama 提供者能力检测逻辑
function resolveCapabilities(modelMetadata) {
const { capabilities } = modelMetadata;
// 更新前：缺失 capabilities 时返回空对象
// if (!capabilities) return {};
// 更新后：未知能力默认启用工具支持
if (!capabilities || capabilities.unknown === true) {
return {
supportsTools: true, // 关键变更：默认启用
supportsStreaming: true,
// ... 其他默认能力
};
}
// 保留显式配置的能力声明
return {
supportsTools: capabilities.tools ?? false,
// ...
};
}
回归测试保障
为确保变更不会破坏现有功能，开发团队添加了专门的断言测试：
运行 Ollama 提供者测试套件
npm test -- providers/ollama --grep "unknown capabilities"
预期输出：验证默认工具能力启用
✓ should default unknown capabilities to tools (45ms)
✓ should respect explicit tools: false declaration (32ms)
✓ should preserve explicit tools: true declaration (28ms)
—
实际应用场景
场景一：快速接入本地 Qwen 模型
1. 拉取支持工具的 Qwen 模型
ollama pull qwen2.5:7b
2. 在 OpenClaw 配置中引用（无需额外能力声明）
openclaw.config.yaml
providers:
ollama:
baseUrl: "http://localhost:11434"
models:
- name: "qwen2.5:7b"
# 无需显式声明 capabilities，工具调用自动可用
场景二：Agent 工作流中的函数调用
// 使用 OpenClaw SDK 创建支持工具的 Agent
import { createAgent } from '@openclaw/core';
const agent = await createAgent({
provider: 'ollama',
model: 'llama3.2:3b',
// 工具自动启用，可直接配置 functions
tools: [
{
name: 'search_database',
description: '查询内部知识库',
parameters: { / ... / }
}
]
});
// 执行带工具调用的对话
const result = await agent.run("查找最近的销售数据");
// 模型将自动调用 search_database 工具
—
配置最佳实践
显式覆盖默认行为
虽然默认启用工具能力解决了大部分问题，但在特定场景下你可能需要显式控制：
强制禁用工具能力（如纯文本生成场景）
models:
- name: "phi3:mini"
capabilities:
tools: false # 显式关闭
streaming: true
或确认启用（文档清晰化）
- name: "mistral:7b"
capabilities:
tools: true # 显式声明，避免依赖默认值
版本兼容性检查
验证当前 OpenClaw 版本是否包含此更新
openclaw --version
需 >= 0.12.0（或包含 commit 5e0850fc 的构建）
检查 Ollama 模型元数据
curl http://localhost:11434/api/show -d '{"name":"qwen2.5:7b"}' | jq '.capabilities'
—
常见问题 FAQ
Q1: 这个更新会影响我已部署的 Ollama 模型吗？
不会破坏现有配置。 更新仅改变未声明能力模型的默认行为。如果你已在配置中显式设置 capabilities.tools: false，该设置将继续生效。建议测试环境验证后，再更新生产环境。
Q2: 如何判断我的模型是否真的支持工具调用？
可通过以下方式验证：
方法1：查看 OpenClaw 启动日志
DEBUG=openclaw:providers:* openclaw start
查找 "ollama:model:capabilities" 输出
方法2：直接测试工具调用
openclaw test-tool --provider ollama --model your-model-name
Q3: 所有 Ollama 模型都能用工具调用了吗？
不是。 默认启用仅解决配置层面的识别问题。模型本身必须具备工具调用能力（如经过专门微调或使用支持函数调用的架构）。若底层模型不支持，调用时会返回错误，OpenClaw 会自动降级为普通对话模式。
Q4: 这个更新与 OpenAI 兼容 API 有什么关系？
Ollama 的 /v1/chat/completions 端点已支持 OpenAI 格式的工具调用。本次更新确保 OpenClaw 在内部路由时正确识别该能力，使以下代码无缝工作：
// 同一套代码，切换 provider 即可
const agent = createAgent({
provider: process.env.USE_LOCAL ? 'ollama' : 'openai',
model: process.env.USE_LOCAL ? 'llama3.2:3b' : 'gpt-4o-mini'
});
Q5: 如何参与 OpenClaw 的类似功能改进？
OpenClaw 是活跃的开源项目，欢迎通过以下方式贡献：
- 在 GitHub Issues 报告模型兼容性问题
- 提交 PR 时遵循
fix(provider): description的提交规范 - 参与 ClawSweeper 自动化代码审查
—
总结与下一步
本次 OpenClaw 更新通过智能默认策略，显著降低了 Ollama 本地模型与 AI Agent 框架的集成门槛。关键要点：
1. 零配置升级——未声明能力的模型自动获得工具支持
2. 向后兼容——显式配置不受默认行为影响
3. 生产就绪——完整的回归测试覆盖
建议行动：
- [ ] 升级至包含 commit
5e0850fc的 OpenClaw 版本 - [ ] 清理冗余的
capabilities.tools: true显式声明 - [ ] 测试本地模型在 Agent 工作流中的表现
—
相关阅读
—
参考来源
