OpenClaw v2.7.9 对接 Ollama 本地开源模型完整实操教程前期部署准备事项在进行 Ollama 与 OpenClaw 联动配置前需要提前完成全部基础条件准备防止操作中途出现故障电脑本地已部署 OpenClaw v2.7.9 客户端软件可正常打开运行Windows 系统安装包https://xiake.yun/api/download/package/18?promoCodeIVE9B04A80CMacOS 苹果系统安装包https://openclaw.ikidi.top/api/download/package/35?promoCodeIVE9B04A80C整合安装包整体体积 45.8MB内置全部运行依赖解压后即可完成整套程序部署。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 第一次执行该指令时Ollama 会自动执行模型下载流程文件下载完毕终端会输出 success 提示字样。步骤 8在 Ollama 客户端核验模型下载状态切回 Ollama 主界面在模型列表中查找刚刚拉取的模型 gemma4:e4b若模型标识旁无未下载提示代表文件完整拉取成功。步骤 9OpenClaw 填写 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. Ollama 接口地址需要填写什么内容本机本地部署场景统一使用默认地址 http://127.0.0.1:11434 程序与 Ollama 安装在同一台设备时直接填写该地址即可正常连通。2. 点击测试按钮无法读取本地模型排查方向确认 Ollama 客户端处于正常启动运行状态终端已执行对应模型拉取运行指令目标模型完整下载无中断损坏接口地址准确填写http://127.0.0.1:11434无字符错误本地防火墙、安全管理软件未拦截 11434 端口访问3. 操作前为什么要在终端执行一次模型运行指令ollama run 模型名称指令在第一次运行时会自动下载完整模型文件只有本地存在完整模型资源OpenClaw 在连通测试时才能识别加载对应模型。4. 模型文件占用磁盘空间过大如何处理本地开源模型文件存储体量普遍偏大系统盘存储空间不足时可参照教程提前在 Ollama 设置内修改 Model location 路径切换至大容量磁盘分区后再执行模型下载操作。参考访问地址Ollama 官方网站https://ollama.com/
