首页 > 教程攻略 > ai资讯 >QClaw本地模型Ollama端口重定向配置详解【详解】

QClaw本地模型Ollama端口重定向配置详解【详解】

来源:互联网 时间:2026-06-13 12:48:19

QClaw连不上本地Ollama,这事儿的根儿其实特别简单——Ollama默认只监听127.0.0.1,而QClaw又偏偏拒绝走本地回环。解决思路就三步:让Ollama听全网卡、用真实局域网IP做端口重定向、再在配置文件里改对提供商。别急,咱一步一步拆开说。

QClaw本地模型Ollama端口重定向配置详解【详解】

你想让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后别急着写进配置文件,先验证一下这个IP能不能被QClaw访问。在浏览器地址栏输入 http://192.168.1.105:11434(换成你自己的IP),如果能看到一个包含models列表的JSON响应页,说明端口已经对外暴露成功。要是打不开,退回去检查 --host 参数是否真的生效了。

修改openclaw.json启用Ollama-local提供商

第一步:彻底退出QClaw,包括右下角系统托盘里的图标。如果不退出,配置文件会被覆盖,改了等于白改。

第二步:用VS Code或记事本打开 C:Users<你的用户名>.qclawopenclaw.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进程是否在向你填入的IP和11434端口发送HTTP请求——这是最底层的证据,比界面反馈靠谱得多。