Ollama 本地模型如何在 OpenClaw 中调用配置教程(含安装包)
OpenClaw 2.7.9 搭配 Ollama 搭建本地大模型环境实操指南
前期环境准备
- 电脑安装 OpenClaw 2.7.9 Windows 客户端,程序可正常启动运行,
- Windows 安装包地址:https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C;
- Mac 系统安装包地址:https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C,
- 安装包大小 45.8MB
- 保证 OpenClaw 顶部 Gateway 网关处于在线状态
- 网络通畅,能够正常访问 Ollama 站点
- 硬盘预留充足存储空间,本地模型文件占用存储资源较多
- 提前确定计划使用的模型名称,示例参考: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 接口并测试连通
- 启动 OpenClaw 2.7.9,点击页面右上角设置入口
- 在左侧功能栏切换至模型配置板块
- 定位 Ollama 配置区域,接口地址填写:http://127.0.0.1:11434
- 点击测试按钮校验接口连通情况
- 点击右上角保存全部配置 连通测试通过后,OpenClaw 会自动识别本地已下载完成的各类 Ollama 模型
步骤 10:聊天界面选择 Ollama 本地模型使用
切换至 OpenClaw 左侧聊天页面,在顶部模型下拉选择框检索目标模型 gemma4:e4b,确认模型名称后方带有 ollama 标识后再选中使用
步骤 11:发送测试文本验证模型运行效果
选定对应模型后,在底部输入框发送一段测试内容,示例:你好,你是什么模型 页面能够正常输出对应回复文字,就代表 Ollama 与 OpenClaw 2.7.9 对接工作全部完成
对接完成自检核对清单
- 已从 Ollama 站点下载并完成 Windows 客户端安装
- Ollama 软件可以正常启动运行
- 根据自身磁盘情况调整模型存储路径(按需操作)
- 在系统终端执行 ollama run 模型名称对应指令
- 模型资源完整下载后,终端界面出现 success 提示
- OpenClaw 2.7.9 内 Ollama 接口地址填写为http://127.0.0.1:11434
- 点击测试按钮,客户端成功读取本地可用模型
- 执行保存全部配置操作
- 聊天界面成功选中带有 ollama 标签的本地模型
- 发送测试文本,模型可正常返回应答内容
常见问题汇总解答
1. Ollama 接口地址需要填写什么内容?
本地电脑部署场景下,统一填写地址:http://127.0.0.1:11434 如果 Ollama 程序安装在当前操作设备,直接使用该地址即可正常建立连接
2. 点击测试按钮后无法识别本地模型,如何排查?
按照下面顺序逐项核对排查:
- Ollama 程序是否处于正常启动运行状态
- 是否已经在终端执行 ollama run 模型名称指令
- 目标模型文件是否完整下载结束
- 接口地址是否准确填写为http://127.0.0.1:11434
- 本地防火墙、安全防护软件是否拦截程序端口通信
3. 使用模型前为什么需要在终端运行一次加载指令?
ollama run 模型名称这条指令,第一次运行会自动下载完整模型文件。只有本地磁盘存在完整模型资源,OpenClaw 在连通检测时才可以正常识别读取。
4. 模型文件占用磁盘空间过高如何处理?
本地大模型资源普遍占用较大存储空间,若系统盘剩余容量不足,可以参照教程步骤提前修改 Model location 存储目录,将模型保存至容量富余的磁盘分区后,再执行下载操作。
参考站点
Ollama 官方网站:https://ollama.com/
更多推荐


所有评论(0)