Windows下OpenClaw安装：Qwen3-4B模型对接避坑指南

1. 为什么选择OpenClaw+Qwen3-4B组合

上周我在尝试搭建一个本地AI助手时，偶然发现了OpenClaw这个开源框架。作为一个长期被Windows平台各种环境配置折磨的开发者，最初我对这种"全能型自动化工具"是持怀疑态度的。但实际体验后，我必须承认OpenClaw+Qwen3-4B的组合确实解决了我三个核心痛点：

首先，隐私安全问题得到了保障。我的工作涉及大量内部文档处理，使用公有云API总让人担心数据泄露风险。而OpenClaw所有操作都在本地完成，Qwen3-4B模型也可以部署在本地服务器，形成了完全封闭的自动化环境。

其次，操作系统的原生支持令人惊喜。大多数AI助手工具对Windows的支持都是"二等公民"，但OpenClaw的npm安装包在Windows 10/11上表现稳定，甚至能直接调用PowerShell执行系统级操作。

最重要的是，Qwen3-4B-Thinking-2507-GPT-5-Codex-Distill-GGUF这个特定版本的模型（以下简称Qwen3-4B）在代码生成和文档处理方面表现出色。相比标准版Qwen，这个蒸馏版本在保持90%性能的同时，推理速度提升了40%，特别适合作为OpenClaw的后端大脑。

不过整个安装过程并非一帆风顺，特别是在PowerShell权限和模型接口配置环节，我踩了不少坑。下面就把我的完整实践过程分享给大家。

2. Windows环境准备与基础安装

2.1 系统环境检查

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

• Windows 10 21H2或更高版本（建议Windows 11）
• PowerShell 5.1+（可通过$PSVersionTable.PSVersion命令查看）
• 至少8GB空闲内存（Qwen3-4B模型加载需要约6GB）
• 已安装Node.js 18+（建议使用LTS版本）

特别注意：如果你之前安装过旧版OpenClaw，请先执行以下清理命令：

npm uninstall -g openclaw
Remove-Item -Path "$env:USERPROFILE\.openclaw" -Recurse -Force

2.2 以管理员身份安装

这里是我遇到的第一个坑：普通用户权限安装会导致后续服务启动失败。正确的做法是：

1. 在开始菜单搜索"PowerShell"
2. 右键选择"以管理员身份运行"
3. 执行安装命令：

npm install -g openclaw --force

--force参数是为了避免某些缓存问题导致的安装中断。安装完成后，验证版本：

openclaw --version
# 预期输出类似：openclaw/1.2.3 win32-x64 node-v18.16.0

如果出现command not found错误，可能是Node.js路径未加入系统PATH。可以尝试：

$env:Path += ";C:\Program Files\nodejs"

3. 初始化配置与模型对接

3.1 onboard向导关键选择

执行初始化命令：

openclaw onboard

这里会出现交互式配置界面，几个关键选项需要特别注意：

1. Mode选择：

   • 新手建议选QuickStart，会自动配置常用参数
   • 如果已有经验，选Advanced可以精细控制每个参数

2. Provider选择：

   • 选择Custom（因为我们使用本地Qwen3-4B模型）
   • 不要选择默认的Qwen或OpenAI选项

3. Default model：

   • 暂时跳过，后续手动配置

4. Channels：

   • 初次使用建议跳过，后续再配置飞书/钉钉等通信渠道

5. Skills：

   • 选择Yes启用基础技能模块

3.2 手动配置Qwen3-4B模型

初始化完成后，需要手动编辑配置文件。文件位置在：

$env:USERPROFILE\.openclaw\openclaw.json

用记事本或VS Code打开后，在models.providers部分添加以下配置：

{
  "models": {
    "providers": {
      "local-qwen": {
        "baseUrl": "http://127.0.0.1:8000/v1", // 模型服务地址
        "apiKey": "EMPTY", // 本地模型可不填
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3-4b",
            "name": "Qwen3-4B-Local",
            "contextWindow": 32768,
            "maxTokens": 4096
          }
        ]
      }
    }
  }
}

关键点说明：

• baseUrl需要改为你实际部署的Qwen3-4B模型服务地址
• 如果你使用星图平台的镜像，地址可能是平台分配的公网URL
• apiKey留空或填任意字符串即可（本地模型通常不需要鉴权）

4. 常见问题解决方案

4.1 PowerShell执行策略限制

这是最常遇到的问题。Windows默认限制PowerShell脚本执行，会导致OpenClaw服务启动失败。解决方法：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

如果仍然报错，可以尝试更宽松的策略（仅限开发环境）：

Set-ExecutionPolicy Unrestricted -Scope CurrentUser

4.2 端口冲突问题

OpenClaw默认使用18789端口，如果冲突可以修改端口：

openclaw gateway --port 18790

或者在配置文件中永久修改：

{
  "gateway": {
    "port": 18790
  }
}

4.3 模型连接超时

如果遇到模型连接超时错误，首先检查：

1. 模型服务是否正常运行
2. 防火墙是否放行了对应端口
3. baseUrl地址是否正确（特别注意/v1后缀）

可以使用curl测试连通性：

curl -X POST "http://127.0.0.1:8000/v1/completions" -H "Content-Type: application/json" -d '{"model": "qwen3-4b", "prompt": "Hello"}'

5. 验证与使用

5.1 启动服务

完成所有配置后，启动网关服务：

openclaw gateway start

成功启动后，访问管理界面：

http://localhost:18789

5.2 基础功能测试

在Web控制台尝试以下命令：

• 查看当前天气（会调用浏览器搜索）
• 列出D盘下的所有PDF文件
• 用一句话总结OpenClaw的功能

如果这些基础命令能正常执行，说明OpenClaw已正确安装并与Qwen3-4B模型对接成功。

5.3 进阶技能安装

比如要安装文件处理技能：

clawhub install file-processor

安装完成后，可以尝试更复杂的命令：

• 将所有.docx文件转换为PDF
• 压缩图片文件夹为zip

6. 性能优化建议

经过一周的使用，我发现几个提升Windows平台使用体验的技巧：

1. 内存优化：

   • 在openclaw.json中添加：

     "memory": {
       "limit": "4GB"
     }
     

   • 防止单个任务占用过多内存

2. 模型缓存：

   • Qwen3-4B首次加载较慢
   • 可以设置预加载：

     openclaw models preload qwen3-4b
     

3. 任务调度：

   • 使用Windows任务计划程序定期执行维护任务
   • 例如每天凌晨3点自动清理日志：

     openclaw tasks create --name "clean-logs" --command "rm $env:USERPROFILE\.openclaw\logs\*.log" --schedule "0 3 * * *"
     

整个安装和配置过程大约花费了我2小时（包括排错时间），但带来的效率提升是显著的。现在我的日常工作如文档整理、数据提取等重复性任务，都可以交给OpenClaw+Qwen3-4B组合自动完成。特别是这个定制版的Qwen3-4B模型，在理解中文办公场景需求方面表现优异。

---

获取更多AI镜像

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