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

Windows系统安装OpenClaw详解千问3.5-9B模型联调避坑指南1. 为什么选择OpenClaw千问3.5-9B组合去年我在尝试自动化办公流程时发现市面上的RPA工具要么功能臃肿要么需要将敏感数据上传到云端。直到遇到OpenClaw这个开源框架它让我能在本地电脑上实现AI操作实体的自动化——比如让AI自动整理文件、发送邮件、甚至操作浏览器完成固定流程。而千问3.5-9B作为一款中英文表现均衡的开源模型正好能满足我对复杂任务的理解需求。这个组合最吸引我的点是所有数据处理都在本地完成我的客户资料和内部文档不需要离开自己的电脑。不过在实际部署时Windows环境下的安装和模型联调过程还是遇到了不少坑特别是千问模型的接口配置环节。下面就把我的完整实践过程分享给大家。2. Windows环境准备从零开始的基础配置2.1 系统权限与工具准备第一次安装时我直接以普通用户身份运行安装命令结果在写入系统目录时频繁报错。后来发现必须使用管理员权限的PowerShell不是CMD才能顺利完成安装。具体操作在开始菜单搜索PowerShell右键选择以管理员身份运行执行权限检查命令确保返回True([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)2.2 Node.js环境部署OpenClaw依赖Node.js运行时但Windows自带的npm版本往往较旧。我测试发现Node.js 18.x版本兼容性最好# 先卸载旧版本如有 npm uninstall -g openclaw # 安装Node.js 18.x LTS版 winget install OpenJS.NodeJS.LTS安装完成后需要手动添加环境变量。我在这一步卡了半小时最后发现需要在系统属性→高级→环境变量中将C:\Program Files\nodejs添加到Path。3. OpenClaw核心安装与验证3.1 主程序安装在确保PowerShell具有管理员权限后执行以下命令npm install -g openclawlatest --registryhttps://registry.npmmirror.com这里特别建议加上--registry参数否则可能会因为网络问题导致安装失败。安装完成后验证版本openclaw -v # 应输出类似openclaw/1.2.3 win32-x64 node-v18.16.03.2 初始化配置向导运行初始化命令时Windows Defender可能会拦截进程创建。需要提前在病毒和威胁防护设置中添加排除项openclaw onboard在向导界面中我建议选择这些配置Mode: Advanced基础模式会跳过关键模型配置Provider: Custom后续手动配置千问模型Default model: 先跳过Channels: 建议跳过可后续单独配置飞书/钉钉Skills: 选择No按需后续安装4. 千问3.5-9B模型联调实战4.1 本地模型服务部署我使用的是星图平台提供的千问3.5-9B镜像部署在本地的另一台服务器上也可以部署在同一台机器的Docker中。关键是要获取模型的API地址通常形如http://192.168.1.100:8080/v1重要提示如果模型服务部署在本地网络需要确保Windows防火墙放行相关端口。我在第一次测试时遇到了连接超时就是因为忘了这个步骤New-NetFirewallRule -DisplayName Qwen Model -Direction Inbound -LocalPort 8080 -Protocol TCP -Action Allow4.2 配置文件修改OpenClaw的核心配置文件位于C:\Users\[用户名]\.openclaw\openclaw.json。需要手动添加千问模型的配置{ models: { providers: { qwen-local: { baseUrl: http://192.168.1.100:8080/v1, apiKey: EMPTY, api: openai-completions, models: [ { id: qwen3.5-9b, name: 千问3.5-9B本地版, contextWindow: 32768 } ] } } } }4.3 403错误的解决方案保存配置后重启网关时我遇到了恼人的403错误openclaw gateway restart # 报错Request failed with status code 403经过排查发现两个常见原因跨域问题需要在模型服务端配置CORS允许OpenClaw所在域名访问API路由差异某些千问镜像的API路径不是标准的/v1需要调整为/api/v1我的解决方法是修改模型服务的启动参数添加CORS支持# 在千问模型服务启动命令中添加 --cors-origins http://localhost:187895. 基础功能测试与排错5.1 模型连接验证配置完成后可以通过以下命令测试模型连通性openclaw models list # 应显示已配置的千问模型信息如果看到模型信息但状态异常可能是网络策略问题。我常用的诊断命令是Test-NetConnection 192.168.1.100 -Port 80805.2 简单任务测试通过Web控制台(http://localhost:18789)发送测试指令请用中文总结当前目录下所有txt文件的内容如果返回没有操作权限需要检查OpenClaw服务是否以管理员权限运行工作目录是否在配置文件openclaw.json的workspace中明确定义6. 进阶配置飞书通道集成虽然这不是必须步骤但通过飞书等IM工具触发任务会方便很多。配置过程有几个Windows特有的注意点安装飞书插件时需要使用非中文路径openclaw plugins install m1heng-clawd/feishu --prefix C:\openclaw_plugins飞书应用的redirect_uri需要配置为http://localhost:18789/feishu/oauth在Windows Defender防火墙中放行18789端口New-NetFirewallRule -DisplayName OpenClaw Gateway -Direction Inbound -LocalPort 18789 -Protocol TCP -Action Allow7. 效能优化与资源管理在连续使用一周后我发现两个性能瓶颈Token消耗过快简单的文件操作都可能消耗上千Token解决方案在openclaw.json中增加execution配置限制单次任务的maxTokens内存占用过高长时间运行后内存泄漏解决方案定期重启网关服务可以设置计划任务# 创建每天凌晨重启的任务 Register-ScheduledTask -TaskName OpenClaw Daily Restart -Trigger (New-ScheduledTaskTrigger -Daily -At 3am) -Action (New-ScheduledTaskAction -Execute openclaw -Argument gateway restart)获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。