OpenClaw v2.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 v2.7.9，客户端能够正常启动；
2. OpenClaw 顶部 Gateway 服务保持在线状态；
3. 设备网络正常，能够正常访问 Ollama 官方网站；
4. 硬盘预留充足存储空间，本地模型文件普遍占用较大磁盘容量；
5. 提前确认需要下载运行的模型标识名称，例如 gemma4:e4b。

图文操作步骤

步骤 1：访问 Ollama 官网，获取安装程序

打开 Ollama 官方网站：https://ollama.com/ 页面加载完成后，点击页面右上角 Download 按钮，进入安装包下载页面。

步骤 2：选择 Windows 平台安装包下载

跳转下载页面之后，选择 Windows 系统分类，点击 Download for Windows，开始获取对应系统版本的安装程序。

步骤 3：完成 Ollama 程序安装

下载结束后双击安装程序，在弹出的安装窗口点击 Install，等待程序自动完成安装流程。

步骤 4：进入 Ollama 设置界面

安装完毕并启动 Ollama 客户端，展开左侧菜单栏，点击 Settings 选项，准备调整本地模型存储目录。

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

在设置页面找到 Model location 配置项，点击 Browse 按钮，自定义模型存放文件夹，示例路径：E:\models。 如果不需要变更存储位置，直接保留系统默认路径即可继续后续操作。

步骤 6：打开 Windows 终端工具

右键点击桌面开始菜单，选择终端（PowerShell），调出命令行操作窗口。

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

在终端内输入模型运行指令，参考示例：

ollama run gemma4:e4b

第一次执行指令时，程序会自动下载目标模型，下载任务结束后终端会提示 success。

步骤 8：客户端核验模型下载状态

切换至 Ollama 可视化客户端，在模型列表查找刚刚拉取的模型名称。若模型条目不再显示未下载标识，代表文件下载完成。

步骤 9：OpenClaw 配置 Ollama 服务地址并连通测试

切换打开 OpenClaw v2.7.9 客户端，执行如下配置操作：

1. 点击页面右上角设置；
2. 在左侧菜单栏选择模型配置；
3. 在列表找到 Ollama 配置栏；
4. 服务地址填写：http://127.0.0.1:11434；
5. 点击测试按钮校验连通状态；
6. 确认连通正常后，点击右上角保存全部配置。 测试通过后，OpenClaw 会自动读取本地已经下载完成的模型。

步骤 10：聊天界面选择 Ollama 本地模型

进入 OpenClaw 左侧聊天页面，在模型下拉选择框检索模型名称，例如 gemma4:e4b。需要确认模型后缀标注 ollama 标签，再选中启用。

步骤 11：发送消息验证模型运行效果

选定模型之后，在输入框发送测试语句，例如：你好，你是什么模型。 客户端正常输出回复内容，即代表 Ollama 本地模型成功接入 OpenClaw。

接入自检清单

完成全部配置后，可以对照清单逐项核对，规避各类隐性问题：

1. 成功从 Ollama 官网下载并安装 Windows 版本客户端；
2. Ollama 程序正常启动运行；
3. 根据需求完成模型存储路径修改；
4. 在终端执行 ollama run 模型名称指令；
5. 模型下载完毕，终端输出 success 提示；
6. OpenClaw 内 Ollama 服务地址填写正确：http://127.0.0.1:11434；
7. 连通测试顺利识别本地可用模型；
8. 模型相关配置已经保存生效；
9. 聊天面板选中带有 ollama 标识的目标模型；
10. 发送测试消息，模型正常返回应答内容。

常见问题解决方案

1. Ollama 服务地址填写什么内容？

同一设备部署 Ollama 时，默认地址为 http://127.0.0.1:11434，绝大多数场景直接使用该地址即可。

2. 点击测试，无法识别本地模型如何处理？

按照顺序逐一排查：

• Ollama 客户端是否处于正常启动状态；
• 是否在终端执行对应指令完成模型拉取；
• 模型文件是否完整下载；
• 服务地址是否准确填写；
• 系统防火墙、安全软件是否拦截端口通信。

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

ollama run 模型名称这条指令，第一次运行会自动下载模型资源。只有模型完整保存至本地，OpenClaw 在连通测试时才能正常识别。

4. 模型文件占用空间过大如何优化？

本地模型文件体积普遍偏大，如果系统盘容量紧张，可以参考教程提前修改 Model location 目录，将模型存储至大容量磁盘后再执行下载。

参考链接

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