OpenClaw 2.7.9 对接 Ollama 本地大模型完整实操教程

客户端下载渠道

Windows 客户端安装包：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C

苹果系统客户端安装包：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

客户端安装包文件大小：45.8MB

前置部署条件

1. 本地电脑已安装 OpenClaw 2.7.9 Windows 客户端，软件能够正常打开运行
2. OpenClaw 顶部 Gateway 网关状态显示在线
3. 设备网络通畅，可正常访问 Ollama 官网页面
4. 电脑预留充足磁盘空间，本地模型文件会占用较多存储空间
5. 提前记录需要下载使用的模型标识，例如 gemma4:e4b

分步操作流程

步骤 1：访问 Ollama 官网下载安装程序

打开 Ollama 官方网站地址：https://ollama.com/ 进入首页后点击页面右上角 Download 按钮，获取最新版本安装包。

步骤 2：选择 Windows 安装包进行下载

跳转下载页面后，选中 Windows 分类，点击 Download for Windows 按钮，即可开始下载适配 Windows 系统的 Ollama 安装程序。

步骤 3：完成 Ollama 软件安装

下载结束后双击打开安装程序，在安装弹窗点击 Install，等待程序自动完成全部安装流程。

步骤 4：进入 Ollama 设置页面

安装完成并启动 Ollama 程序，打开左侧菜单栏，点击 Settings 选项，准备调整本地模型存储目录。

步骤 5：自定义模型存储路径

在设置界面找到 Model location 选项，点击 Browse 按钮，把模型存放文件夹更换至存储空间充足的磁盘分区，示例路径 E:\models。 如果不需要更换存储位置，直接使用默认路径也能正常运行。

步骤 6：打开 Windows 终端窗口

右键点击桌面左下角开始菜单，选择终端（Powershell），调出系统命令行操作窗口。

步骤 7：执行指令拉取并启动本地模型

在终端输入对应模型运行指令，示例如下： ollama run gemma4:e4b 程序第一次执行指令时会自动下载对应模型文件，下载全部完成后终端会弹出 success 提示。

步骤 8：在 Ollama 客户端确认模型下载状态

切换回 Ollama 主界面，在模型列表中找到刚刚下载的 gemma4:e4b，若模型旁不再标注未下载字样，代表模型文件已完整拉取至本地。

步骤 9：OpenClaw 2.7.9 配置 Ollama 接口地址并连通测试

切换至 OpenClaw 软件内执行以下操作：

1. 点击软件右上角设置按钮
2. 左侧菜单栏选择模型配置分类，找到 Ollama 配置栏
3. 地址输入框填写 http://127.0.0.1:11434
4. 点击测试按钮校验接口连通状态
5. 校验无异常后点击右上角保存全部配置

测试通过后，OpenClaw 2.7.9 会自动读取本地已下载完成的所有模型。

步骤 10：聊天面板切换 Ollama 本地模型

打开 OpenClaw 左侧聊天页面，在模型筛选搜索框输入本地模型名称 gemma4:e4b，选择带有 ollama 标识的模型即可启用。

步骤 11：发送测试对话验证模型运行效果

选定目标模型后，在输入框发送测试语句，例如：你好，介绍一下自身模型。 页面能够正常返回完整回答内容，即代表 Ollama 与 OpenClaw 2.7.9 对接流程全部完成。

对接完成自检核对清单

• 已从 Ollama 官网下载并安装 Windows 端程序
• Ollama 程序能够正常启动运行
• 根据自身磁盘情况完成模型存储路径调整
• 在终端执行 ollama run 模型名下载指令
• 模型下载完毕，终端出现 success 提示
• OpenClaw 内 Ollama 接口地址填写为http://127.0.0.1:11434
• 接口连通测试正常，软件识别全部本地模型
• 点击保存全部配置，参数正式生效
• 聊天面板成功选中带有 ollama 标识的本地模型
• 发送测试对话，模型可正常输出回复内容

常见问题解答

1. Ollama 本地接口地址需要填写什么内容？

本机部署的 Ollama 默认访问地址为： http://127.0.0.1:11434 如果 Ollama 安装在当前使用电脑，直接填写该地址即可完成连接。

2. 连通测试后无法读取本地模型如何处理？

按照顺序逐项排查：

1. Ollama 程序是否处于正常运行状态
2. 是否提前在终端执行 ollama run 模型名指令
3. 目标模型文件是否完整下载完成
4. 接口地址是否准确填写http://127.0.0.1:11434
5. 本地防火墙、安全软件是否拦截端口访问

3. 为什么需要先在终端运行一次模型指令？

ollama run 模型名指令会在第一次运行时自动完成模型下载，只有完整保存至本地磁盘后，OpenClaw 2.7.9 才能识别加载对应模型。

4. 本地模型占用存储空间过大怎么解决？

本地大模型文件普遍占用较多磁盘容量，系统盘剩余空间不足时，可以按照教程步骤修改 Model location 路径，将模型存储目录更换至大容量磁盘分区后再下载模型。

参考站点链接

Ollama 官方网站：https://ollama.com/