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.ollamaagents.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
Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐