Windows下OpenClaw安装详解:对接Qwen3.5-9B模型全流程

张开发
2026/4/9 11:25:46 15 分钟阅读

分享文章

Windows下OpenClaw安装详解:对接Qwen3.5-9B模型全流程
Windows下OpenClaw安装详解对接Qwen3.5-9B模型全流程1. 为什么选择OpenClawQwen3.5-9B组合去年我在尝试自动化办公时发现市面上的RPA工具要么功能受限要么需要将敏感数据上传到云端。直到遇到OpenClaw这个开源框架配合本地部署的Qwen3.5-9B模型终于实现了完全本地的智能自动化。这个组合特别适合需要处理敏感数据又希望保留AI能力的场景。Qwen3.5-9B作为90亿参数的开源模型在代码生成和逻辑推理方面表现出色。我曾测试过用它对Excel表格进行复杂分析相比小模型它能更准确地理解我的自然语言指令。而OpenClaw则像一双数字手把模型的思考结果转化为实际电脑操作。2. Windows环境准备2.1 系统要求检查在开始前建议确认你的Windows环境满足以下条件Windows 10/11 64位系统建议版本19041或更高PowerShell 5.1可通过$PSVersionTable.PSVersion查看至少8GB空闲内存Qwen3.5-9B推理时内存占用约6GB固态硬盘剩余空间20GB以上我曾在老旧的Windows平板上尝试安装结果发现内存不足导致模型加载失败。后来换到一台16GB内存的笔记本上就顺利多了。2.2 必要组件安装以管理员身份打开PowerShell依次执行# 启用开发者模式避免权限问题 Set-ExecutionPolicy RemoteSigned -Force Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux # 安装Node.js LTS版本 winget install -e --id OpenJS.NodeJS.LTS # 验证安装 node -v npm -v这里有个小坑某些国内网络环境下npm安装可能很慢。我通常会用淘宝镜像npm config set registry https://registry.npmmirror.com3. OpenClaw核心安装3.1 基础框架安装继续在管理员PowerShell中执行# 全局安装OpenClaw npm install -g openclawlatest # 验证安装 openclaw -v如果遇到command not found错误可能是环境变量未更新。我常用的解决方法是# 刷新环境变量 $env:Path [System.Environment]::GetEnvironmentVariable(Path,Machine) ; [System.Environment]::GetEnvironmentVariable(Path,User)3.2 初始化配置向导运行配置向导openclaw onboard在交互式向导中我的推荐配置是Mode选择Advanced后面要自定义模型Provider选择Skip for now稍后手动配置QwenChannels可以先跳过Skills选择Yes启用基础模块配置完成后会在用户目录生成.openclaw文件夹所有配置文件都在这里。4. Qwen3.5-9B模型对接4.1 模型服务准备假设你已经在本地或内网部署了Qwen3.5-9B的API服务如使用星图平台镜像记下服务地址格式通常是http://[IP地址]:[端口]/v1我最初测试时犯了个错误没注意防火墙设置导致OpenClaw无法访问本地模型服务。记得在Windows Defender防火墙中添加入站规则。4.2 配置文件修改用文本编辑器打开~/.openclaw/openclaw.json找到models部分添加{ models: { providers: { qwen-local: { baseUrl: 你的模型服务地址, apiKey: sk-随便填不影响本地部署, api: openai-completions, models: [ { id: qwen3-9b, name: Qwen3.5-9B Local, contextWindow: 128000, maxTokens: 4096 } ] } } } }特别提醒contextWindow和maxTokens要根据实际部署情况调整。我最初直接复制了网上的32K配置结果导致生成内容被截断。4.3 服务重启与验证保存后执行openclaw gateway restart openclaw models list如果看到qwen3-9b出现在可用模型列表中说明对接成功。我习惯用这个命令测试openclaw exec 用一句话说明你已经成功接入 --model qwen3-9b5. 常见问题排查5.1 模型服务连接失败症状Error: Failed to connect to model provider检查步骤先用curl测试模型服务是否可达curl -X POST http://模型地址/v1/completions -H Content-Type: application/json -d {model:qwen3-9b,prompt:test}检查防火墙设置确认配置文件中的baseUrl是否以/v1结尾5.2 内存不足错误症状Allocation failed - JavaScript heap out of memory解决方法# 设置Node.js内存限制 setx NODE_OPTIONS --max-old-space-size8192然后重启PowerShell窗口。5.3 中文乱码问题在PowerShell执行[Console]::OutputEncoding [System.Text.Encoding]::UTF8 chcp 650016. 基础功能测试安装完成后我建议从简单任务开始验证# 测试文件操作 openclaw exec 在桌面创建一个test.txt文件内容为OpenClaw测试成功 # 测试网页操作 openclaw exec 用浏览器搜索Qwen3.5-9B技术文档并截图保存到桌面如果这些基础命令能执行成功说明环境已经正确配置。接下来可以根据需要安装更多Skill扩展功能。获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。

更多文章