Windows下OpenClaw安装避坑：ollama-QwQ-32B联调全记录

Windows下OpenClaw安装避坑：ollama-QwQ-32B联调全记录

1. 为什么选择Windows+ollama-QwQ-32B组合

去年在Mac上折腾OpenClaw时，我曾天真地以为跨平台体验应该差不多。直到上个月给团队Windows设备配置ollama-QwQ-32B联调环境时，才真正领教了微软系统的"特色"。这篇文章记录了我从零开始踩过的所有坑，以及最终让本地模型稳定运行的完整方案。

选择ollama-QwQ-32B主要考虑三点：首先，32B参数量在本地部署模型中属于"甜点"级别，我的RTX 3090显卡刚好能跑；其次，ollama的REST接口与OpenClaw兼容性好；最重要的是，团队内部已有该模型的业务微调版本。不过整个安装过程远比想象中坎坷，特别是在Windows权限体系和Node版本管理这两个"传统艺能"上。

2. 基础环境准备：那些容易忽略的细节

2.1 PowerShell的权限陷阱

第一次运行安装命令就遭遇当头一棒：

npm install -g openclaw # 报错：无法加载文件 C:\Program Files\nodejs\openclaw.ps1，因为在此系统上禁止运行脚本

这是因为Windows默认执行策略限制。不要直接使用Set-ExecutionPolicy Bypass，这会给系统带来安全风险。我的解决方案是：

1. 以管理员身份启动PowerShell
2. 仅对当前会话放宽限制：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned

3. 安装完成后立即恢复默认值：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Restricted

2.2 Node.js版本的地雷阵

OpenClaw要求Node 18+，但团队机器上既有16.x的老项目，又有20.x的新项目。通过nvm-windows管理多版本才是正解：

nvm install 20.11.1 nvm use 20.11.1 # 验证版本 node -v npm -v

特别提醒：某些杀毒软件会拦截nvm的版本切换操作，建议安装时暂时关闭实时防护。我就曾被某国产安全软件默默拦截，花了半小时才找到原因。

3. ollama-QwQ-32B的部署与排错

3.1 模型服务部署

使用官方镜像部署ollama服务：

ollama pull qwq-32b ollama run qwq-32b

默认会在11434端口启动服务，但直接配置这个地址会遇到第一个坑——Windows防火墙。需要手动放行端口：

New-NetFirewallRule -DisplayName "Ollama" -Direction Inbound -LocalPort 11434 -Protocol TCP -Action Allow

3.2 经典的502 Bad Gateway

在OpenClaw配置中填入http://localhost:11434后，管理界面持续报502错误。通过curl测试发现：

curl http://127.0.0.1:11434/api/generate -d '{"model":"qwq-32b"}' # 返回空响应

问题根源在于ollama默认只绑定IPv6地址。修改启动参数解决：

ollama serve --host 0.0.0.0

3.3 中文编码的幽灵问题

测试中文请求时出现乱码：

{ "model": "qwq-32b", "prompt": "为什么天空是蓝色的？" }

需要在请求头显式指定编码：

$headers = @{ "Content-Type" = "application/json; charset=utf-8" } Invoke-RestMethod -Uri 'http://127.0.0.1:11434/api/generate' -Method Post -Body $body -Headers $headers

4. OpenClaw的最终配置方案

4.1 关键配置文件

C:\Users\[用户名]\.openclaw\openclaw.json需要特别注意Windows路径转义：

{ "models": { "providers": { "ollama-qwq": { "baseUrl": "http://127.0.0.1:11434", "api": "openai-completions", "models": [ { "id": "qwq-32b", "name": "本地QwQ-32B", "contextWindow": 32768 } ] } } } }

4.2 验证连接的技巧

使用内置命令测试连通性：

openclaw models list # 应该显示已识别的qwq-32b模型 openclaw gateway restart # 观察日志是否有模型加载成功的提示

如果出现ECONNREFUSED错误，尝试用管理员权限运行：

Start-Process powershell -Verb runAs -ArgumentList "openclaw gateway start"

5. 稳定性优化实践

5.1 内存泄漏监控

长时间运行后发现ollama进程内存占用超过30GB。通过PowerShell定时重启：

# 创建每日重启任务 $action = New-ScheduledTaskAction -Execute "powershell.exe" -Argument "ollama serve --host 0.0.0.0" $trigger = New-ScheduledTaskTrigger -Daily -At 3am Register-ScheduledTask -TaskName "OllamaDailyRestart" -Action $action -Trigger $trigger

5.2 性能调优参数

在openclaw.json中增加超时设置：

"requestTimeout": 300000, "temperature": 0.7, "topP": 0.9

对于复杂任务，建议在OpenClaw管理界面开启"分步执行"模式，避免单次请求过长导致超时。

6. 写在最后

这次Windows下的部署经历让我深刻体会到，本地AI联调就像在雷区跳舞——每个步骤都可能引爆意想不到的问题。但正是这些踩坑经验，反而让我对OpenClaw的运作机制有了更深理解。现在团队的三台Windows开发机都已稳定运行这套方案，每天自动处理数百个文档分析任务。

如果你也在Windows上挣扎，记住两个原则：一是所有操作都用管理员权限尝试一次；二是善用Test-NetConnection等原生命令排查网络问题。毕竟在Windows世界，权限和网络永远是最大的两个玄学问题。

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。