OpenClaw v2.7.9 接入 Ollama 本地大模型完整配置教程
接入前置条件
- 本地设备已部署 OpenClaw v2.7.9 Windows 客户端,程序能够正常启动运行;
- OpenClaw 界面顶部 Gateway 服务保持在线状态;
- 电脑网络连通正常,可以正常访问 Ollama 官方网站;
- 磁盘预留充足存储空间,本地模型文件普遍占用较大容量;
- 提前确认想要部署的模型名称,例如 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 客户端核验模型状态
切换至 Ollama 客户端,在模型列表查看刚刚下载的模型 gemma4:e4b。模型状态不再显示待下载,就代表文件拉取工作完成。
步骤 9:OpenClaw v2.7.9 配置 Ollama 服务地址并连通检测
切回 OpenClaw 客户端执行如下操作:
- 点击页面右上角设置;
- 在左侧菜单栏选择模型配置;
- 在列表找到 Ollama 配置项;
- 地址栏填写
http://127.0.0.1:11434; - 点击测试按钮校验连通状态;
- 校验正常后点击保存全部配置。 测试通过后,OpenClaw 将自动识别本机已经下载完成的本地模型。
步骤 10:聊天界面选中 Ollama 本地模型
进入 OpenClaw 左侧聊天页面,在模型选择检索框输入模型名称,例如 gemma4:e4b。务必确认模型后方标签为 ollama,再完成选中。
步骤 11:发送测试消息验证调用效果
选定目标模型后,在输入框发送测试语句,例如:你好,你是什么模型。 客户端正常返回回答内容,代表 Ollama 与 OpenClaw 接入流程全部完成。
接入完成自检清单
- 成功从 Ollama 官网下载并安装 Windows 客户端
- Ollama 程序正常启动运行
- 根据需求完成模型存储路径修改
- 在终端执行 ollama run 模型名称指令
- 模型下载完毕,终端出现 success 提示
- OpenClaw 内 Ollama 地址填写为
http://127.0.0.1:11434 - 连通测试顺利识别到可用模型
- 执行保存全部配置操作
- 聊天面板选中带有 ollama 标签的模型
- 发送测试消息,能够正常获取模型回复
常见问题排查
1. OpenClaw 中 Ollama 需要填写什么地址?
本机部署场景统一使用地址:http://127.0.0.1:11434,本机运行 Ollama 直接填入该地址即可。
2. 点击测试,无法识别本地模型如何处理?
逐项进行核对: ① Ollama 客户端是否处于正常运行状态; ② 是否已经通过终端执行 ollama run 指令拉取模型; ③ 模型完整下载,没有中断; ④ 服务地址填写无误; ⑤ 防火墙、安全软件没有拦截本地端口通信。
3. 为什么需要先在终端运行一次模型指令?
ollama run 模型名称指令会在第一次运行时自动下载模型文件。只有模型完整保存至本地磁盘,OpenClaw 进行连通测试时才能够识别模型。
4. 本地模型体积过大,磁盘空间紧张如何解决?
本地模型文件占用存储空间较高,如果系统盘容量不足,可以提前在 Ollama 设置中将 Model location 切换至大容量磁盘分区,再执行模型下载操作。
参考链接
Ollama 官网:https://ollama.com/
OpenClaw v2.7.9 整合包下载留存
整合包体积约 45.8MB,内置全套运行依赖,初次部署 OpenClaw 可使用下方链接获取安装包:
Windows 系统下载链接: https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
Mac 系统下载链接: https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
工具无捆绑附加程序,项目源码可自行核验安全性,新手跟随部署教程即可快速搭建环境。
文末补充
后续持续更新 OpenClaw v2.7.9 对接各类大模型的配置教程,部署、模型接入过程中遇到各类故障,可以在评论区描述完整问题现象,我会及时给出对应的处理方案。