Openclaw接入本地模型API
·
1)先在 OpenClaw 机器上确认能访问远程 Ollama
你先执行:
curl http://192.168.2.175:11434/api/tags
只要能返回模型列表,就说明网络已经通了。Ollama 的模型列表接口就是 GET /api/tags。
2)在 OpenClaw 里配置 Ollama provider
先设置 baseUrl,再设置 apiKey。这是因为近期 OpenClaw 有已知问题:如果先设 apiKey,但还没设 baseUrl,CLI 可能校验失败。
按这个顺序执行:
openclaw config set models.providers.ollama.baseUrl "http://192.168.2.175:11434"
openclaw config set models.providers.ollama.api "ollama"
openclaw config set models.providers.ollama.apiKey "ollama-local"
这里的 apiKey 不需要真实密钥,填任意占位值即可,OpenClaw 的 Ollama 文档就是这么说明的。
3)把默认模型切到你的本地模型
执行:
openclaw config set agents.defaults.model.primary "ollama/qwen2.5:7b-instruct"
OpenClaw 的模型选择格式就是 provider/model,例如 ollama/llama3.3。
4)检查 OpenClaw 是否识别到了模型
执行:
openclaw models list
如果你想看更详细的当前解析状态,可以再执行:
openclaw models status --probe
OpenClaw 官方 CLI 文档里有 models status,并支持 --probe 做实时检查。
5)把默认模型正式设成它
如果 openclaw models list 里已经能看到 ollama/qwen2.5:7b-instruct,再执行:
openclaw models set ollama/qwen2.5:7b-instruct
这是 OpenClaw 官方 Ollama 文档给出的设置方式之一。
你也可以直接写成配置文件形式
如果你想看最终应该是什么结构,大致是这样:
{
"models": {
"mode": "merge",
"providers": {
"ollama": {
"baseUrl": "http://192.168.2.175:11434",
"api": "ollama",
"apiKey": "ollama-local"
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "ollama/qwen2.5:7b-instruct"
}
}
}
}
OpenClaw 文档说明了 models.providers.ollama 和 agents.defaults.model.primary 这两部分的基本写法。
改完后怎么验证“真的已经换过去了”
先在 OpenClaw 机器上手工确认 Ollama 模型存在:
curl http://192.168.2.175:11434/api/tags
然后在 OpenClaw 里看模型状态:
openclaw models list
openclaw models status --probe
如果状态里默认模型已经显示为 ollama/qwen2.5:7b-instruct,就说明切换生效了。
现在最推荐你直接执行这一组
openclaw config set models.providers.ollama.baseUrl "http://192.168.2.175:11434"
openclaw config set models.providers.ollama.api "ollama"
openclaw config set models.providers.ollama.apiKey "ollama-local"
openclaw config set agents.defaults.model.primary "ollama/qwen2.5:7b-instruct"
openclaw models list
openclaw models status --probe更多推荐



所有评论(0)