Windows系统安装OpenClaw：千问3.5-9B联调避坑指南

Windows系统安装OpenClaw千问3.5-9B联调避坑指南1. 为什么选择WindowsOpenClaw组合作为一个长期在Windows环境下工作的开发者我一直在寻找能够提升日常效率的AI助手方案。直到遇到OpenClaw这个开源的本地化AI智能体框架它让我看到了将大模型能力直接融入工作流的可能性。与常见的云端API调用不同OpenClaw能在我的本地电脑上直接操控鼠标键盘、读写文件、运行脚本实现真正的所见即所得的自动化。这次我选择在Windows 11专业版上部署OpenClaw并接入千问3.5-9B模型。整个过程经历了从兴奋到困惑再到豁然开朗的心路历程特别是在PowerShell权限、Node.js版本适配等环节踩了不少坑。下面我就把这些实战经验完整分享出来希望能帮助同样想在Windows上尝试OpenClaw的朋友少走弯路。2. 环境准备与基础安装2.1 系统与硬件要求在开始前请确保你的Windows系统满足以下条件Windows 10 1809或更高版本建议Windows 11PowerShell 5.1可通过$PSVersionTable命令查看至少8GB空闲内存千问3.5-9B模型推理需要固态硬盘剩余空间20GB以上稳定的网络连接安装过程需要下载依赖我使用的是Windows 11 23H2版本搭配16GB内存和RTX 3060显卡。虽然OpenClaw本身不强制要求GPU但本地模型推理会明显受益于显卡加速。2.2 Node.js环境配置OpenClaw依赖Node.js运行时这里有个关键点必须使用Node.js 18.x或20.x版本。我最初安装了最新的Node.js 21结果导致后续的npm包兼容性问题。正确的安装步骤如下以管理员身份打开PowerShell执行# 卸载现有Node.js如有 winget uninstall Node.js安装LTS版本的Node.js 20winget install OpenJS.NodeJS.LTS验证安装node -v # 应显示v20.x.x npm -v # 应显示10.x.x如果遇到权限问题可能需要先执行Set-ExecutionPolicy RemoteSigned。我在一台公司电脑上就遇到了组策略限制最终通过临时启用管理员权限解决了这个问题。3. OpenClaw核心安装流程3.1 全局安装OpenClaw在确认Node.js环境正常后就可以安装OpenClaw了。这里有个Windows特有的注意事项必须使用管理员权限的PowerShell否则后续的本地服务注册会失败。# 使用管理员PowerShell执行 npm install -g openclaw --force安装完成后验证版本openclaw -v如果出现命令无法识别的错误通常是环境变量未更新导致的。可以尝试关闭并重新打开PowerShell或者手动将%AppData%\npm添加到系统PATH中。3.2 初始化配置向导运行配置向导是设置OpenClaw的关键步骤openclaw onboard在向导中我选择了以下配置Mode:Advanced为了自定义模型设置Provider:Custom准备接入本地千问3.5-9BDefault model: 暂时跳过Channels: 先跳过后续再配置飞书Skills: 选择基础技能包这里我犯过一个错误第一次运行时直接选择了QuickStart模式结果系统自动配置了云端模型导致后续切换本地模型时需要手动清理配置文件。建议从一开始就选择Advanced模式。4. 千问3.5-9B模型接入4.1 模型服务准备我使用的是星图平台提供的千问3.5-9B镜像已经在本地通过Docker运行docker run -d -p 5000:5000 --gpus all qwen35-9b-mirror验证模型API是否可用curl -X POST http://localhost:5000/v1/completions -H Content-Type: application/json -d {prompt:你好,max_tokens:50}4.2 修改OpenClaw配置关键步骤来了需要手动编辑OpenClaw的配置文件以接入本地模型。配置文件通常位于C:\Users\[用户名]\.openclaw\openclaw.json用记事本或VS Code打开该文件在models.providers部分添加{ models: { providers: { local-qwen: { baseUrl: http://localhost:5000, apiKey: no-need-for-local, api: openai-completions, models: [ { id: qwen35-9b, name: Local Qwen 3.5-9B, contextWindow: 32768, maxTokens: 8192 } ] } } } }保存后需要重启OpenClaw网关服务openclaw gateway restart4.3 常见配置问题解决在这个过程中我遇到了两个典型问题问题1网关启动失败错误信息显示端口被占用。解决方案是# 查找占用18789端口的进程 netstat -ano | findstr 18789 # 终止该进程 taskkill /PID [进程ID] /F # 重新启动网关 openclaw gateway start问题2模型连接超时检查发现是Docker容器的防火墙规则阻止了连接。解决方法是# 允许5000端口入站 New-NetFirewallRule -DisplayName Qwen Model Port -Direction Inbound -LocalPort 5000 -Protocol TCP -Action Allow5. 自动化脚本与快捷操作为了简化日常使用我创建了几个实用的批处理脚本启动所有服务的脚本start_all.bat:echo off docker start qwen35-9b timeout /t 10 start /B openclaw gateway start start http://localhost:18789重置环境的脚本reset_env.bat:echo off taskkill /im node.exe /f docker restart qwen35-9b del /f /q C:\Users\%username%\.openclaw\logs\* openclaw gateway start这些脚本特别适合在开发过程中快速重启环境。我将它们放在桌面通过右键以管理员身份运行来执行。6. 实际应用测试配置完成后我通过Web控制台(http://localhost:18789)测试了几个典型场景文件整理让OpenClaw帮我整理下载文件夹按扩展名分类资料检索自动在浏览器中搜索并汇总指定主题的前5条结果内容生成基于本地文档生成周报初稿千问3.5-9B模型在理解中文指令方面表现相当不错特别是处理与本地文件相关的任务时响应速度明显快于云端API。不过我也发现当任务链路过长时超过5个步骤Token消耗会急剧增加这时适当拆分任务会更高效。7. 安全注意事项在Windows上运行OpenClaw需要特别注意权限控制不要长期以管理员身份运行OpenClaw服务日常使用时可降权操作审核定期检查~/.openclaw/logs/action.log了解AI执行了哪些操作网络隔离如果模型包含敏感数据建议在防火墙中限制外部访问备份机制重要文件不要放在OpenClaw可直接操作的目录中我曾不小心让OpenClaw删除了一个临时文件夹结果发现里面还有未保存的工作文件。现在我会在关键目录设置只读权限避免类似意外。获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。