qclaw无法连接本地ollama的根本原因是ollama默认仅监听127.0.0.1,需以管理员权限运行ollama serve --host=0.0.0.0:11434,并在openclaw.json中配置真实局域网ip及ollama-local提供商。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想让QClaw不再走云端、不扣积分、不传数据,而是直接把请求发给本机Ollama跑着的模型,但改完配置却始终连不上http://127.0.0.1:11434——根本原因往往不是模型没拉,而是QClaw默认拒绝localhost回环地址,必须用真实局域网IP做端口重定向。
确认Ollama服务真实监听地址
打开命令行(CMD或PowerShell),执行ollama serve,观察首行输出:2026/06/11 23:35:12 Serving on 127.0.0.1:11434。这说明Ollama只监听本地回环,外部进程(包括QClaw)无法穿透。此时浏览器能打开http://localhost:11434,但QClaw会超时失败。
必须强制Ollama监听全网卡:按Ctrl+C停止当前服务,然后运行ollama serve --host=0.0.0.0:11434。成功后首行应显示Serving on 0.0.0.0:11434——这才是QClaw能访问的地址。
【关键前提】此操作需管理员权限,Windows下务必右键以“管理员身份运行”命令行,否则绑定0.0.0.0会报错Permission denied。
获取并验证本机局域网IP
在命令行中运行ipconfig,找到“无线局域网适配器 WLAN”或“以太网适配器 以太网”区块,抄下IPv4地址(形如192.168.1.105)。不要抄127.0.0.1,也不要抄169.254.x.x这类自动分配失败的地址。
立刻验证该IP是否可被QClaw访问:在浏览器地址栏输入http://192.168.1.105:11434(替换为你自己的IP),若看到Ollama JSON响应页(含models列表),说明端口已对外暴露成功;若打不开,退回上一步检查--host参数是否生效。
修改openclaw.json启用Ollama-local提供商
第一步:彻底退出QClaw,包括右下角系统托盘里的图标,否则配置文件会被覆盖。
第二步:用VS Code或记事本打开C:\Users\.qclaw\openclaw.json。
第三步:在"providers"对象内插入以下完整块(注意逗号分隔),将192.168.1.105替换成你上一步查到的真实IP:
"ollama-local": { "baseUrl": "http://192.168.1.105:11434/v1", "apiKey": "ollama", "api": "openai-completions", "models": [ { "id": "qwen2.5:14b", "name": "qwen2.5:14b" } ] }
第四步:定位到"agents.defaults.primary"字段,将其值改为"ollama-local/qwen2.5:14b"(ID必须与models数组中一致)。
第五步:保存文件,重新启动QClaw。
验证端口重定向是否生效
方法一:在QClaw聊天框输入/model list,如果返回结果里包含ollama-local/qwen2.5:14b,说明提供商已加载。
方法二:输入/model ollama-local/qwen2.5:14b,等待3秒内返回模型响应(非超时提示),即表示端口重定向链路完全打通。
方法三:打开任务管理器→性能→网络,观察QClaw进程是否在发送HTTP请求到你填入的IP和11434端口——这是最底层的证据,比界面反馈更可靠。











