请先登录

OpenClaw接入Ollama本地大模型

很多人在使用 OpenClaw 时，希望能够直接调用本地的大模型，而不是依赖云端 API。通过Ollama，我们可以非常方便地在本地运行模型（例如 Qwen、Llama等），并让 OpenClaw 直接调用。

1.前置条件

硬件(一台含有入门级显卡的电脑)：

在开始之前，请确保已经安装：
- OpenClaw (Linux下安装OpenClaw)
- Ollama (Linux中私有化部署Ollama)

可以通过以下命令检查是否安装成功：

openclaw --version

ollama --version

2.检查Ollama 服务

检查 Ollama 服务：

curl http://localhost:11434/api/tags

如果没有运行，可以启动

ollama serve

3.添加Ollama大模型

查看 OpenClaw 当前可用模型：

openclaw models list

如果没有 Ollama 模型，可以添加：

ollama launch openclaw # 选择想要添加的模型

ollama launch openclaw --model qwen3.5:9b # 添加明确的模型

4.设置Ollama的API Key

OpenClaw 需要一个 API Key 来识别 Ollama 服务。由于 Ollama 是本地服务，所以这个 Key 可以是任意字符串。

方法 1：设置环境变量

export OLLAMA_API_KEY="ollama-local"

方法 2：通过 OpenClaw 配置

openclaw config set models.providers.ollama.apiKey "ollama-local"

5.运行OpenClaw初始化向导

运行配置向导：

openclaw onboard

OpenClaw 会自动检测本地 Ollama 服务。在向导中可以根据以下选择：

然后会显示目前正在连接着的模型，本文使用的是 ollama/qwen3.5:9b 模型作为例子：

这里选择Use existing values或者Update values都可以，但不能选Reset：

Model provider选Skip for now：

选All providers：

在Default Model里，连接着的Ollama 模型应该会出现在最上面，并作为默认模型，选这个就可以了，例如：

此时，OpenClaw 已经成功连接到本地 Ollama 模型了。接下来的步骤按自己需求设置就可以了

6.测试OpenClaw使用模型

向导完成后，打开openclaw的Web UI

测试一下ollama部署的qwen3.5:9B模型

查看一下显存使用情况:

切换模型：

ollama launch openclaw

也可以直接指定模型：

ollama launch openclaw --model qwen3.5:9b

7.常见问题

7.1 直接在openclaw.json配置报错

我配置后，报404错误，大家可以试一下

7.2 Ollama API 无法访问

确认 Ollama 服务正在运行：

ollama serve

再次测试

curl http://localhost:11434/api/tags

7.2 OpenClaw 检测不到 Ollama 模型

查看 Ollama 已安装模型：

ollama list

如果没有模型，可以下载一个，例如：

ollama pull qwen3.5:9b

然后连接：