OpenClaw 使用本地 Ollama 调用 qwen3 大模型
2026-03-10 00:00:00 # AI # OpenClaw

OpenClaw使用本地Ollama调用qwen3大模型

这次依旧是虚拟机(Linux)运行OpenClaw server,然后物理机运行Ollama,本地模型使用qwen3:30b

虚拟机:Linux kali 6.16.8+kali-arm64

物理机:Darwin bogon 25.3.0 Darwin Kernel Version 25.3.0

Ollama安装

Ollama官网

官网给了一个直接Ollama加载OpenClaw的方法,但是在安装ollama的本地检测是否部署了openclaw,然后启动,这里因为openclaw和ollama不在同一台机器上,所以不用这种方法。

image-20260310090617567

安装好后下载模型,我这里用的是qwen3:30b,因为本地模型肯定是不如在线模型好,尽量选参数量大一点的

image-20260310090721696

然后设置里面打开网络访问,OpenClaw要求模型上下文窗口≥16000 tokens,而Ollama拉取的基础模型默认上下文窗口仅4096 tokens,所以需要将上下文窗口扩展至32768 tokens

image-20260310092251000

OpenClaw配置

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

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

官方文档给出了,当ollama和openclaw部署在同一个服务器上的时候,设置了OLLAMA_API_KEY就可以自动识别到并且加载到openclaw里,这里没有在同一台机器上部署,所以需要手动添加

官网给了配置文件当中的一段

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
models: {
providers: {
ollama: {
// 使用包含 /v1 的主机地址以兼容 OpenAI API
baseUrl: "http://ollama-host:11434/v1",
apiKey: "ollama-local",
api: "openai-completions",
models: [
{
id: "llama3.3",
name: "Llama 3.3",
reasoning: false,
input: ["text"],
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
contextWindow: 8192,
maxTokens: 8192 * 10
}
]
}
}
}
}

其实有web界面,可以从web界面修改,打开web界面

image-20260310145411309

Settings下面FormRaw可以切换前端界面和原始的json格式,也就是openclaw.json文件里的内容格式,直接翻到models这一栏

image-20260310145709067

我个人理解的这个层级逻辑是:

image-20260310150908893

然后就是把json里的配置项和web界面当中的配置项对应起来。

这里第一个内容就是第层的ollama的配置,API Adapter选择openai-completionsAPI Key就是前面配置的ollama-local

image-20260310151136579

然后Base URL一定是运行ollama的服务器ip

image-20260310151505864

到这步第一层的配置就完成了,然后是第二层对ollama调用的模型进行配置,设置第一个模型,Api还是openai的,Context Windows设置为32768,这里openclaw对Context Windows限制了不能低于16000,然后Cost全部设置为0,因为是在本地运行的模型没有费用。

image-20260310151959234

最后是设置一个Id,然后Input选择text,因为暂时只用文本输入,Max Token也是32768Name就和Id一样就行,编辑玩右上角Save

image-20260310152456286

下一步对Agent进行设置,逻辑跟Model的差不多,就是需要通过json进行设置

image-20260310154406583

回到聊天,就可以使用了

image-20260310154849295

代理Tools这里可以设置智能体的工具,可以关闭一些不必要且危险的工具

image-20260310155044998

image-20260310155439893

到这里就完成了基本的部署和设置,But……巨卡无比

image-20260310155228434


参考链接