OpenClaw 2.7.9 连接 Ollama 本地模型完整图文教程

一、前置准备

在开始配置之前，请完成以下准备工作，保障流程顺利进行：

1. 本地已成功安装并正常运行 OpenClaw 2.7.9 Windows 客户端；
2. 确保 OpenClaw 顶部 Gateway 状态为在线；
3. 设备网络状态正常，能够正常访问 Ollama 官方网站；
4. 预留充足磁盘空间，本地大模型文件占用空间较大；
5. 提前确认需要部署的模型名称，示例参考：gemma4:e4b。

二、工具安装包获取

安装包大小：45.8MB

安卓版本： https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C

苹果系统版本：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

三、详细图文配置步骤

步骤 1：访问 Ollama 官网下载安装包

打开 Ollama 官方首页：https://ollama.com/ 进入页面后，点击页面右上角的 Download 按钮，进入下载页面。

步骤 2：选择 Windows 版本下载

在下载页面中，找到系统分类选项，选中 Windows，随后点击 Download for Windows，即可开始下载 Windows 平台的 Ollama 安装包。该软件运行要求系统版本为 Windows 10 及以上。

步骤 3：安装 Ollama 程序

下载完成后，双击运行安装程序。在弹出的安装窗口中点击 Install，等待程序自动完成安装即可。

步骤 4：进入 Ollama 设置界面

安装并启动 Ollama 后，在软件左侧菜单栏中点击 Settings，进入设置页面，接下来修改本地模型的存储目录。

步骤 5：修改本地模型存储路径

在设置页面找到 Model location 选项，该选项用于设置模型文件的保存位置。

1. 点击 Browse 按钮，自主选择磁盘目录作为模型存储位置，示例路径：E:\models；
2. 若系统盘空间充足，也可以保留默认路径直接使用。

步骤 6：打开 Windows 终端（PowerShell）

右键点击电脑桌面左下角开始菜单，在弹出的菜单列表中选择 终端（Powershell），启动命令行窗口。

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

在终端内输入模型拉取与运行命令，以 gemma4:e4b 为例，执行以下指令：

powershell

ollama run gemma4:e4b

第一次执行该命令时，Ollama 会自动从网络下载对应模型文件。下载全部完成后，终端界面会显示 success 字样，代表模型拉取成功。

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

返回 Ollama 客户端，在模型选择列表中查找刚刚下载的 gemma4:e4b。若模型条目不再显示未下载状态，说明模型已完整部署至本地。

步骤 9：OpenClaw 2.7.9 配置 Ollama 接口并测试连接

1. 打开 OpenClaw 2.7.9 客户端，点击页面右上角 设置；
2. 在左侧导航栏选择 模型配置，找到 Ollama 配置项；
3. 在接口地址栏中填写默认本地地址：http://127.0.0.1:11434；
4. 点击 测试 按钮，等待连接校验；
5. 测试通过后，点击右上角 保存全部配置。 配置无误时，OpenClaw 会自动识别本地已下载的模型。

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

1. 切换至 OpenClaw 左侧 聊天 页面；
2. 在模型选择搜索框中输入已下载的模型名称，例如 gemma4:e4b；
3. 务必确认模型后方带有 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 与 OpenClaw 部署在同一台设备，该地址无需修改。

2. 点击测试后无法识别本地模型

可按照以下顺序逐一排查：

1. 检查 Ollama 程序是否正常启动；
2. 确认已在终端执行 ollama run 模型名 命令，且模型完整下载；
3. 核对接口地址是否填写正确；
4. 检查本机防火墙、安全软件是否拦截端口通信。

3. 为何需要先在终端运行模型

ollama run 模型名 指令除了启动模型外，第一次执行会自动下载模型文件。只有模型完整落地本地，OpenClaw 才可以正常识别并调用。

4. 模型文件占用空间过大如何处理

本地大模型普遍占用较多磁盘空间，若系统盘容量不足，建议按照教程提前将 Model location 修改至大容量磁盘分区后，再执行模型下载操作。

六、参考链接

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

openclaw安卓版本： https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C

openclaw苹果系统版本：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C