OpenClaw 对接 Ollama 本地模型详细教程
OpenClaw 部署包:OpenClaw Windows 一键部署包 v2.7.8
前置准备
- 本机已装好 OpenClaw v2.7.8,软件 Gateway 状态在线;
- 设备网络正常,能够访问 Ollama 官网;
- 磁盘预留充足空间用于存放本地模型,提前确定需要下载的模型名称,示例:
gemma4:e4b。
一、Ollama 安装与路径设置
- 打开 Ollama 官网,进入下载页选择 Windows 安装包并下载,双击安装程序点击 Install 完成部署。
- 启动 Ollama 客户端,进入 Settings 设置,找到 Model location 选项,点击 Browse 自定义模型存放目录(例如
E:\models),不想变更目录可保留默认配置。
二、终端拉取本地大模型
- 右键系统开始菜单,打开 PowerShell 终端;
- 输入指令
ollama run gemma4:e4b,程序自动下载对应模型,下载完毕终端提示 success 即代表资源拉取完成; - 返回 Ollama 客户端,在模型列表找到目标名称,确认状态正常。
三、OpenClaw 端配置 Ollama 服务
- 打开 OpenClaw v2.7.8,点击右上角设置→模型配置,找到 Ollama 配置项;
- 在 API 地址框填写
http://127.0.0.1:11434,点击测试,页面识别出本地模型后保存全部配置。
四、选用模型并调试对话
回到软件聊天页面,在模型筛选栏搜索已下载模型,选择标注 ollama 标签的模型,发送测试消息「你好,你是什么模型」,能够正常回复即代表对接全部完成。
五、部署自检清单
- Ollama 客户端正常启动,自定义模型存储目录生效
- 终端执行拉取命令,模型下载完成显示 success
- OpenClaw 接口地址填写无误,测试连通并识别模型
- 聊天窗口选中对应 ollama 模型,消息交互正常
六、常见问题解答
- 接口默认地址:本机部署统一填写
http://127.0.0.1:11434; - 测试找不到模型:排查 Ollama 运行状态、模型是否完整下载、防火墙有无拦截;
- 必须终端执行 run 指令:第一次运行命令会自动下载模型,资源落地后 OpenClaw 才可读取;
- 磁盘空间不足:提前在 Ollama 设置中将模型目录切换至大容量盘符再下载文件。
打开下载链接:https://xiake.yun/api/download/package/17?promoCode=IV4E9B04A80C,在页面中点击下载按钮保存压缩文件。 安装包大小为 45.8MB,推荐使用浏览器原生下载工具或第三方下载软件保存,降低文件损坏、下载中断概率,下载文件一般存放于桌面或浏览器默认下载文件夹。