OpenClaw配置局域网本地模型需验证Ollama服务(如curl http://localhost:11434/api/tags),修改config.toml的[llm]区块,base_url设为http://host.docker.internal:11434/v1,model填ollama list中精确名称(如phi3:mini),启动后测试连接成功即生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw配置局域网本地模型需绕过云端依赖,直接对接运行在本机或内网服务器上的大模型服务(如Ollama、vLLM或FastChat),确保推理请求不外泄且响应低延迟。
确认本地模型服务已就绪
先验证你的本地模型服务是否正常监听——比如Ollama默认监听http://localhost:11434,用curl测试:curl http://localhost:11434/api/tags。返回包含模型列表的JSON才代表服务已启动。
若返回Connection refused,说明Ollama未运行,需先执行ollama serve;若端口被占用,修改Ollama配置绑定到其他端口(如11435),后续配置中对应调整Base URL。
修改OpenClaw的模型配置文件
打开OpenClaw项目根目录下的config.toml(若不存在则复制config.template.toml并重命名)。
定位到[llm]区块,清空原有远程模型配置,填入以下内容:
[llm]<br>model = "ollama/phi3:mini"<br>base_url = "http://host.docker.internal:11434/v1"<br>api_key = "ollama"<br>temperature = 0.1
完整的工作区安全套件:检测未授权修改,扫描提示注入模式,自动响应应对措施——快照恢复、技能隔离、Git回滚和自动保护扫描。智能体工作区的完整安装后安全层。
【base_url必须用host.docker.internal而非localhost】——Docker容器内访问宿主机服务时,localhost指向容器自身,只有host.docker.internal才能正确解析到宿主机网络栈。
model字段值需与ollama list输出的NAME列完全一致(含版本标签),例如phi3:mini不能写成phi3或phi3:latest,否则加载失败。
启动OpenClaw并验证连接
执行启动命令:docker run -it --rm -p 3000:3000 -v $(pwd)/config.toml:/app/config.toml -v /var/run/docker.sock:/var/run/docker.sock --add-host host.docker.internal:host-gateway openclaw/app:latest
浏览器打开http://localhost:3000,进入设置页点击“Test Connection”。
若界面显示“✅ Model connection successful”,说明已成功调用本地Ollama返回模型信息;若提示“HTTP 404 Not Found”,检查base_url末尾是否误加了/api或/v1/chat/completions等多余路径——OpenClaw会自动拼接标准OpenAI兼容路径。

















