需指定本地模型文件物理路径:一、用modelfile绑定绝对路径并执行ollama create;二、修改openclaw.json中provider的baseurl为file://路径;三、macos用omlx扫描目录自动注册,base url设为omlx服务地址。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望在OpenClawAI中使用本地存储的大模型文件,而非通过远程服务或Ollama自动拉取,则需明确指定模型文件的物理路径。以下是实现自定义模型路径加载的具体操作步骤:
一、通过Modelfile绑定绝对路径
OpenClaw支持通过Modelfile声明本地GGUF模型的完整文件系统路径,该方式绕过Ollama仓库机制,直接指向磁盘上的模型文件,适用于Qwen3.5、Llama3.1等量化格式模型。
1、将模型文件(如Qwen3.5-0.8B-Q4_K_M.gguf)保存至确定位置,例如/home/user/models/或C:\openclaw\models\。
2、在该模型文件所在目录新建文本文件,命名为Modelfile,内容严格如下(路径需与实际一致):
FROM /home/user/models/Qwen3.5-0.8B-Q4_K_M.gguf
TEMPLATE"""{{-$lastUserIdx:=-1-}}{{- range$idx,$msg:=.Messages -}}{{-ifeq$msg.Role"user"}}{{$lastUserIdx=$idx}}{{end -}}{{- end}}{{-ifor .System .Tools}}system{{if.System}}{{.System}}{{- end}}{{-if.Tools}}# ToolsYou may call one ormorefunctions to assist with the user query. You are provided withfunctionsignatures within
3、执行ollama create my-qwen35 -f Modelfile命令,生成本地命名模型镜像。
4、在OpenClaw配置中将Model Name设为my-qwen35,Base URL保持http://localhost:11434/v1。
二、修改openclaw.json直写文件路径
当不使用Ollama中间层时,可通过编辑openclaw.json强制指定模型文件系统路径,此法适用于GPUNexus等兼容OpenAI API的本地引擎,要求引擎本身支持file://协议或路径解析能力。
1、定位openclaw.json文件:Windows下路径为C:\Users\用户名\.openclaw\openclaw.json;Linux/macOS下为~/.openclaw/openclaw.json。
OpenClaw 基础设施心跳监控与自动恢复:部署/卸载心跳守护进程,配置主机监控(Gateway、磁盘、内存、CPU、进程),设置飞书告警,自动重启故障Gateway。适用关键词:心跳监控、heartbeat daemon、服务器告警、自动重启、健康检查、auto recovery。
2、在models.providers节点内新增一个provider条目,其中baseUrl字段填入file:///home/user/models/Qwen3.5-0.8B-Q4_K_M.gguf(注意三个斜杠及绝对路径)。
3、确保该provider的api字段值为openai-completions,且models.id与路径中模型标识一致。
4、保存文件后执行openclaw gateway restart使配置生效。
三、利用oMLX引擎注册模型路径
macOS用户可借助oMLX作为本地模型调度器,其原生支持扫描指定目录下的所有GGUF文件并自动注册为可用模型,OpenClaw通过标准OpenAI API调用即可访问,无需硬编码路径。
1、安装oMLX:brew install omlx(已配置Homebrew前提下)。
2、创建模型根目录并赋予读取权限:mkdir -p ~/models && chmod 755 ~/models。
3、将Qwen3.5-0.8B-Q4_K_M.gguf等文件复制进~/models/目录。
4、启动oMLX服务:omlx serve --models-dir ~/models,默认监听http://localhost:8080/v1。
5、在OpenClaw onboard流程中,Provider选择Custom,Base URL填写http://localhost:8080/v1,Model Name填入文件名不含扩展名的部分(如Qwen3.5-0.8B-Q4_K_M)。









