OpenClaw 2.7.9 搭配 Ollama 搭建本地大模型环境实操指南

前期环境准备

  1. 电脑安装 OpenClaw 2.7.9 Windows 客户端,程序可正常启动运行,
  2. Windows 安装包地址:https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
  3. Mac 系统安装包地址:https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
  4. 安装包大小 45.8MB
  5. 保证 OpenClaw 顶部 Gateway 网关处于在线状态
  6. 网络通畅,能够正常访问 Ollama 站点
  7. 硬盘预留充足存储空间,本地模型文件占用存储资源较多
  8. 提前确定计划使用的模型名称,示例参考:gemma4:e4b

完整操作流程

步骤 1:进入 Ollama 站点下载安装程序

打开 Ollama 站点首页链接:https://ollama.com/ 点击页面右上角 Download 按钮,跳转下载页面获取对应安装程序

步骤 2:选择 Windows 安装包完成下载

跳转下载页面后,选中 Windows 分类,点击 Download for 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 接口并测试连通

  1. 启动 OpenClaw 2.7.9,点击页面右上角设置入口
  2. 在左侧功能栏切换至模型配置板块
  3. 定位 Ollama 配置区域,接口地址填写:http://127.0.0.1:11434
  4. 点击测试按钮校验接口连通情况
  5. 点击右上角保存全部配置 连通测试通过后,OpenClaw 会自动识别本地已下载完成的各类 Ollama 模型

步骤 10:聊天界面选择 Ollama 本地模型使用

切换至 OpenClaw 左侧聊天页面,在顶部模型下拉选择框检索目标模型 gemma4:e4b,确认模型名称后方带有 ollama 标识后再选中使用

步骤 11:发送测试文本验证模型运行效果

选定对应模型后,在底部输入框发送一段测试内容,示例:你好,你是什么模型 页面能够正常输出对应回复文字,就代表 Ollama 与 OpenClaw 2.7.9 对接工作全部完成

对接完成自检核对清单

  1. 已从 Ollama 站点下载并完成 Windows 客户端安装
  2. Ollama 软件可以正常启动运行
  3. 根据自身磁盘情况调整模型存储路径(按需操作)
  4. 在系统终端执行 ollama run 模型名称对应指令
  5. 模型资源完整下载后,终端界面出现 success 提示
  6. OpenClaw 2.7.9 内 Ollama 接口地址填写为http://127.0.0.1:11434
  7. 点击测试按钮,客户端成功读取本地可用模型
  8. 执行保存全部配置操作
  9. 聊天界面成功选中带有 ollama 标签的本地模型
  10. 发送测试文本,模型可正常返回应答内容

常见问题汇总解答

1. 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 在连通检测时才可以正常识别读取。

4. 模型文件占用磁盘空间过高如何处理?

本地大模型资源普遍占用较大存储空间,若系统盘剩余容量不足,可以参照教程步骤提前修改 Model location 存储目录,将模型保存至容量富余的磁盘分区后,再执行下载操作。

参考站点

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

Logo

中国智能体开发者社区,聚焦智能体与大模型开发,提供前沿资讯、实用工具链、开源项目及行业案例。通过技术沙龙、开发者大赛等活动,促进经验交流与协作,助力开发者快速构建创新智能应用。

更多推荐