OpenClaw v2.7.9 对接 Ollama 本地模型图文配置教程前置准备本机已经安装 OpenClaw 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执行指令拉取并启动模型在终端输入模型运行指令参考示例plaintextollama run gemma4:e4b第一次执行指令时程序会自动下载目标模型下载完成终端会输出 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:11434Ollama 与 OpenClaw 安装在同一台电脑使用该地址即可完成通信。2. 点击测试无法识别本地模型按顺序逐项排查Ollama 客户端是否处于正常运行状态是否已经在终端执行ollama run 模型名模型资源是否完整下载连接地址是否正确填写http://127.0.0.1:11434防火墙、安全软件是否拦截端口通信3. 为什么需要先在终端运行一次模型执行ollama run 模型名第一次运行会自动下载模型资源。只有模型完整保存至本地OpenClaw 进行连通检测时才能够识别到模型。4. 模型体积较大磁盘空间不足如何处理本地模型普遍占用大量存储空间如果系统盘容量紧张可以参照教程提前修改 Model location 路径将模型存放至容量富余的磁盘分区再执行下载操作。资源获取地址Windows 版本https://xiake.yun/api/download/package/18?promoCodeIV4E9B04A80C苹果系统版本https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C
