OpenClaw 接入 Ollama 保姆级教程:本地模型部署 + 对接 + 测试全流程
2026/5/26 11:29:36 网站建设 项目流程

OpenClaw 连接 Ollama 本地模型教程

前置准备

  • 已安装并能正常打开 OpenClaw Windows 客户端
  • OpenClaw 顶部 Gateway 状态保持在线
  • 电脑可正常联网,能访问 Ollama 官网
  • 磁盘空间充足(本地模型占用空间较大)
  • 提前确认待下载的模型名称(示例:gemma4:e4b)

OpenClaw 一键安装包地址:https://xiake.yun/api/download/package/16?promoCode=IV9D9D5198DC

图文步骤

步骤 1:打开 Ollama 官网下载安装包

访问 Ollama 官网首页:https://ollama.com/点击页面右上角Download,准备获取最新版安装文件。

步骤 2:选择 Windows 版本下载

进入下载页后:

  1. 选择Windows选项卡
  2. 点击Download for Windows等待安装包下载完成(需 Windows 10 及以上系统)。

步骤 3:安装 Ollama

双击下载好的安装程序,在安装窗口点击Install,等待安装自动完成即可。

步骤 4:打开 Ollama 设置页

安装完成并启动 Ollama 后,在左侧菜单点击Settings,准备调整模型存储位置。

步骤 5:修改模型存储路径

在设置页找到Model location选项:

  • 点击Browse,选择大容量磁盘目录(示例:E:\models)
  • 也可保留默认路径直接使用

步骤 6:打开 Windows 终端

右键点击 Windows 开始菜单,选择终端(Powershell),打开命令行窗口。

步骤 7:执行命令拉取并运行模型

在终端输入模型下载运行命令(示例):

plaintext

ollama run gemma4:e4b

第一次执行时,Ollama 会自动下载对应模型,下载完成后终端显示success即代表成功。

步骤 8:Ollama 客户端确认模型

返回 Ollama 客户端,在模型列表中找到刚下载的模型(如 gemma4:e4b),状态显示已下载即拉取成功。

步骤 9:OpenClaw 配置 Ollama 并测试

回到 OpenClaw 客户端:

  1. 点击右上角设置
  2. 进入左侧模型配置
  3. 找到Ollama选项
  4. 地址栏输入:http://127.0.0.1:11434
  5. 点击测试
  6. 点击右上角保存全部配置测试成功后,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 标签的模型
  • 发送测试消息并收到正常回复

OpenClaw 一键安装包地址:https://xiake.yun/api/download/package/16?promoCode=IV9D9D5198DC

常见问题

1. Ollama 地址应该填什么?

本机默认填写:http://127.0.0.1:11434Ollama 安装在当前电脑时,直接使用该地址即可。

2. 点击测试后未识别到模型?

优先排查以下项:

  • Ollama 是否正常启动
  • 是否在终端执行过ollama run 模型名
  • 模型是否已完整下载
  • 地址是否填写为http://127.0.0.1:11434
  • 是否被防火墙或安全软件拦截

3. 为什么要在终端先运行一次模型?

ollama run 模型名第一次执行会自动下载模型,只有模型完整保存到本地后,OpenClaw 才能识别并调用。

4. 模型文件过大如何处理?

本地模型占用磁盘空间较多,系统盘空间不足时,建议先在 Ollama 设置中将Model location改到大容量磁盘,再下载模型。

参考链接

OpenClaw 一键安装包地址:https://xiake.yun/api/download/package/16?promoCode=IV9D9D5198DC

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询