Windows下OpenClaw安装详解：千问3.5-9B本地化部署

1. 为什么选择Windows本地化部署

去年我在尝试自动化办公流程时，偶然发现了OpenClaw这个开源框架。作为一个长期被重复性工作困扰的技术从业者，我对"让AI直接操作电脑"这个理念产生了强烈兴趣。但在实际落地时，我发现大多数教程都集中在macOS或Linux环境，Windows用户的实践指南几乎是一片空白。

经过两周的反复尝试和排错，我终于在Windows 11系统上成功部署了OpenClaw，并稳定对接了千问3.5-9B模型。这个过程中踩过的坑、解决的难题，都将在本文中详细分享。如果你也是Windows用户，希望构建自己的本地AI助手，这篇文章或许能帮你节省大量时间。

2. 环境准备与基础安装

2.1 系统要求检查

在开始之前，请确保你的Windows系统满足以下条件：

• Windows 10 21H2或更高版本（建议Windows 11）
• PowerShell 5.1+（可通过$PSVersionTable.PSVersion命令验证）
• 至少8GB可用内存（千问3.5-9B模型运行需要）
• 固态硬盘剩余空间20GB以上

特别提醒：如果你的设备是企业办公电脑，可能会遇到组策略限制。建议先联系IT部门确认是否有软件安装权限限制。

2.2 Node.js环境配置

OpenClaw依赖Node.js运行时，但版本选择有讲究。经过多次测试，我推荐以下安装方式：

# 以管理员身份打开PowerShell
winget install OpenJS.NodeJS.LTS --version 18.17.1

为什么选择18.x而不是最新版？因为在20.x版本中，我曾遇到native addon兼容性问题，导致OpenClaw的部分功能异常。安装完成后验证：

node -v  # 应显示v18.17.x
npm -v   # 应显示9.x

如果系统已安装其他版本，建议先卸载再安装指定版本。可以使用nvm-windows管理多版本，但考虑到初学者友好性，本文采用直接安装方式。

3. OpenClaw核心安装流程

3.1 安装本体与权限处理

在管理员PowerShell中执行：

npm install -g openclaw --scripts-prepend-node-path

这里有几个关键点需要注意：

1. 必须使用管理员权限，否则全局安装会失败
2. --scripts-prepend-node-path参数确保能找到正确的node路径
3. 如果遇到杀毒软件拦截，需要暂时关闭实时保护（安装完成后再开启）

安装完成后验证：

openclaw -v  # 应显示版本号

3.2 初始化配置向导

运行配置向导是成败关键：

openclaw onboard

在交互式向导中，我建议这样选择：

1. Mode选择Advanced（虽然复杂但可控）
2. Provider选择Qwen（国内网络友好）
3. Default model留空（稍后手动配置本地千问模型）
4. Channels先跳过（后续再配置飞书等）
5. Skills选择Yes启用基础模块

配置完成后，会在用户目录生成.openclaw文件夹，所有配置文件都在这里。

4. 千问3.5-9B模型对接

4.1 本地模型服务准备

假设你已经通过星图平台或其他方式获取了千问3.5-9B的本地部署，服务地址通常是：

http://localhost:8000/v1

验证服务可用性：

curl -X POST "http://localhost:8000/v1/chat/completions" -H "Content-Type: application/json" -d '{"model": "qwen3.5-9b", "messages": [{"role": "user", "content": "你好"}]}'

如果返回正常JSON响应，说明模型服务运行正常。

4.2 OpenClaw配置修改

编辑~/.openclaw/openclaw.json，在models.providers部分添加：

"my-qwen": {
  "baseUrl": "http://localhost:8000/v1",
  "apiKey": "none",
  "api": "openai-completions",
  "models": [
    {
      "id": "qwen3.5-9b",
      "name": "千问3.5-9B本地版",
      "contextWindow": 32768,
      "maxTokens": 4096
    }
  ]
}

保存后重启网关服务：

openclaw gateway restart

4.3 模型连接验证

openclaw models list

应该能看到新增的"千问3.5-9B本地版"模型。进一步测试：

openclaw exec "请用中文回答，1+1等于几？" --model qwen3.5-9b

如果得到正确响应，说明对接成功。

5. 常见问题解决方案

5.1 杀毒软件拦截问题

Windows Defender可能会将OpenClaw的部分行为误判为威胁。解决方法：

1. 临时方案：安装过程中暂时关闭实时保护
2. 永久方案：将以下路径加入排除项：
   • C:\Users\<你的用户名>\.openclaw
   • C:\Users\<你的用户名>\AppData\Roaming\npm

5.2 端口冲突处理

如果18789端口被占用，可以修改网关端口：

openclaw gateway --port 18790

记得同时修改配置文件中的相关端口设置。

5.3 模型响应缓慢

千问3.5-9B对硬件要求较高，如果响应慢可以尝试：

1. 检查模型服务是否独占GPU资源
2. 降低maxTokens参数值
3. 在OpenClaw配置中增加超时设置：

"requestTimeout": 60000

6. 基础功能测试

完成所有配置后，建议通过几个简单任务验证系统稳定性：

1. 文件操作测试：

openclaw exec "在我的文档中创建一个test.txt文件，内容为'Hello OpenClaw'"

2. 网页检索测试：

openclaw exec "搜索2023年诺贝尔奖得主并总结成Markdown表格"

3. 复杂任务测试：

openclaw exec "分析C盘空间使用情况，找出占用空间最大的前5个文件夹，生成报告"

如果这些任务都能顺利完成，说明你的OpenClaw环境已经准备就绪。

---

获取更多AI镜像

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